EhrObservation__c

Represents measurements and assertions made regarding a patient or device. Observations are a central element in healthcare, used to support diagnosis, monitor progress, determine baselines and patterns, and even capture demographic characteristics.

Supported Calls 

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

This packaged object has a standard object counterpart in the Clinical Data Model. We recommend using the standard object because it’s more closely aligned with FHIR v4.0.

Fields 

Account__c 

  • Type: reference
  • Properties: Create, Filter, Group, Sort
  • Description: The person account that represents the patient in Lightning Platform.

AppliesDateTime__c 

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The time or time period when the observed value is asserted as being true, usually the time of a procedure or specimen collection. Often the source of the date or time isn’t known. Unless this observation is a historical report, a date is required.

AppliesPeriodEndDate__c 

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The last day when the observed value is asserted as being true.

AppliesPeriodStartDate__c 

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The first day when the observed value is asserted as being true.

BodySiteCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the site on the patient’s body where the observation was made (also called the target site).

BodySiteLabel__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The human-readable label that represents the site on the patient’s body where the observation was made (also called the target site).

BodySiteSystem__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system that defines the site on the patient’s body where the observation was made (also called the target site).

Comments__c 

  • Type: textarea
  • Properties: Create, Nillable, Update
  • Description: Statements about significant, unexpected, or unreliable values—or information about the source of the observed value—that can be relevant to the interpretation of the result.

Device__c 

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The device that’s used to generate the observation data. Lookup to EhrDevice__c.

InterpretationCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the assessment that’s made based on the observation results. For some results, especially numeric results, an interpretation is necessary to fully understand the significance of a result.

InterpretationLabel__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The human-readable label that represents the assessment that’s made based on the result of the observation. For some results, especially numeric results, an interpretation is necessary to fully understand the significance of a result.

InterpretationSystem__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system that defines the assessment that’s made based on the result of the observation. For some results, especially numeric results, an interpretation is necessary to fully understand the significance of a result.

IsRestricted__c 

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates whether or not this field has restricted visibility based on sharing rules.

IssuedDate__c 

  • Type: dateTime
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The date and time when the observation was made available. Updated when the result is updated.

IsVisibleOnPatientCard__c 

  • Type: boolean
  • Properties: Defaulted on create, Filter, Group
  • Description: Indicates whether or not this field appears on the patient card.

LastActivityDate 

  • Type: date

  • Properties: Filter, Group, Nillable, Sort

  • Description: Whichever of the following is the most recent:

    • Due date of the most recent event logged against the record.
    • Due date of the most recently closed task associated with the record.

LastReferencedDate 

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The time stamp that indicates when the current user last viewed a related record.

LastViewedDate 

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The timestamp for when the current user last viewed this record. If this value is null, it’s possible that this record was referenced (LastReferencedDate) and not viewed.

MethodCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the mechanism that’s used to perform the observation. In some cases, method can impact results and is therefore used to determine whether results can be compared or to determine the significance of results.

MethodLabel__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The human-readable label that represents the mechanism that’s used to perform the observation. In some cases, method can impact results and is therefore used to determine whether results can be compared or to determine the significance of results.

MethodSystem__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system that defines the mechanism that’s used to perform the observation. In some cases, method can impact results and is therefore used to determine whether results can be compared or to determine the significance of results.

Name 

  • Type: string
  • Properties: Autonumber, Defaulted on create, Filter, idLookup, Sort
  • Description: The EHR observation ID. Limit: 255 characters.

NameCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the name of the observation.

NameLabel__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The human-readable label that represents the name of the observation.

NameSystem__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system that defines the name of the observation.

Patient__c 

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The patient’s name. Lookup to Ehr_Patient__c.

Practitioner__c 

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A person with a formal responsibility in the providing of healthcare services. Lookup to EhrPractitioner__c.

ReferenceMeaningLabel__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The human-readable label that represents the meaning of the applicable reference range, which provides guidance on how to interpret the observed value by comparison to a normal or recommended range. Specify what kind of reference range it is (for example, normal, recommended, or therapeutic), or what state this reference range applies to (for example, age or hormonal cycles).

ReferenceRangeAgeHigh__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The age at the high end of the applicable reference range. Can be a neonatal age (for example, number of weeks at term). If this element is omitted, the high value of the reference range is assumed to be meaningless (for example, the reference range is > 5). If the low comparator is missing , it’s assumed to be “<”.

ReferenceRangeAgeLow__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The age at the low end of the applicable reference range. Can be a neonatal age (for example, number of weeks at term). If this element is omitted, the low value of the reference range is assumed to be meaningless (for example, the reference range is < 2). If the high comparator is missing, it’s assumed to be “>”.

ReferenceRangeHighUnit__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The unit of measurement in the applicable reference range.

ReferenceRangeHighValue__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The value at the high end of the applicable reference range. If this element is omitted, the high value of the reference range is assumed to be meaningless. (for example, the reference range is > 5). If the low comparator is missing, it’s assumed to be “<”.

ReferenceRangeLowUnit__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The unit of measurement in the applicable reference range.

ReferenceRangeLowValue__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The value at the low end of the applicable reference range. If this element is omitted, the low value of the reference range is assumed to be meaningless. (for example, the reference range is < 2). If the high comparator is missing, it’s assumed to be “>”.

ReferenceRangeMeaningCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the meaning of the applicable reference range. Specify what kind of reference range it is (for example, normal, recommended, or therapeutic), or what state this reference range applies to (for example, age or hormonal cycles).

ReferenceRangeMeaningSystem__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system that defines the meaning of the applicable reference range.

ReferenceRangeUnit__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A unit of measurement within the applicable reference range.

Reliability__c 

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: An estimate of the degree to which quality issues have impacted the reported value. Picklist values: calibrating, early, error, ok, ongoing, and questionable.

ReliabilityCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the estimate of the degree to which quality issues have impacted the reported value.

SampledData__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Data that comes from a series of measurements that were taken by a device, with upper and lower limits. Can include multiple dimensions.

SourceSystem__c 

  • Type: string
  • Properties: Create, Defaulted on create, Filter, Group, Nillable, Sort, Update
  • Description: A name that identifies the system that created the record and owns update rights to it.

SourceSystemId__c 

  • Type: string
  • Properties: Create, Filter, Group, idLookup, Nillable, Sort, Update
  • Description: The ID of an external record. This field can’t be encrypted.

SourceSystemModified__c 

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The most recent date when the integration system wrote the record from the source record.

Status__c 

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The status of the observation’s result value. Picklist values: amended, final, preliminary, and registered.

StatusCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the status of the observation’s result value.

ValueAttachment__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: An attachment related to the observed value. Attachments include additional data content defined in other formats such as PDF, typically images or reports.

ValueCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the information determined by making the observation, if the information has a simple value.

ValueLabel__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The human-readable label that represents the information determined by making the observation, if the information has a simple value.

ValuePeriod__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The period during which the observed value is valid.

ValuePeriodEndDate__c 

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The last date when the observed value is valid.

ValuePeriodStartDate__c 

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The first date when the observed value is valid.

ValueQuantity__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A measured or potentially measurable amount related to the observed value.

ValueQuantityUnit__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A unit of measurement related to the observed value.

ValueRatio__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A relationship between two quantities, expressed as a numerator and a denominator, related to the observed value.

ValueRatioDenominator__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The denominator in the relationship between two quantities related to the observed value.

ValueRatioNumerator__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The numerator in the relationship between two quantities related to the observed value.

ValueSampledData__c 

  • Type: textarea
  • Properties: Create, Nillable, Update
  • Description: Data that comes from a series of measurements taken by a device, related to the observed value.

ValueSampledDataDimensions__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The number of sample points at each time point in the sampled data. If this value is greater than one, all sample points for a point in time are recorded at the same time.

ValueSampledDataFactor__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A correction factor that’s applied to the sampled data points before they’re added to the origin.

ValueSampledDataLowerLimit__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The lower limit of detection of the measured points in the sampled data. Required if any data points have the value L (lower than detection limit).

ValueSampledDataOrigin__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The base quantity that a measured value of zero represents in the sampled data. This value provides the units of the entire measurement series.

ValueSampledDataOriginCode__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-defined code that represents the base quantity that a measured value of zero represents in the sampled data.

ValueSampledDataOriginCodeLabel__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The human-readable label that represents the base quantity that a measured value of zero represents in the sampled data.

ValueSampledDataOriginCodeSystem__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system that defines the base quantity that a measured value of zero represents in the sampled data.

ValueSampledDataOriginComparator__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A comparator used with the base quantity that a measured value of zero represents in the sampled data.

ValueSampledDataOriginSystem__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system that defines the base quantity that a measured value of zero represents in the sampled data.

ValueSampledDataOriginUnits__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Units of measurement in the base quantity that a measured value of zero represents in the sampled data.

ValueSampledDataOriginValue__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The human-readable value used in the base quantity that a measured value of zero represents in the sampled data.

ValueSampledDataPeriodMili__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: A time period defined by a start and end date and optionally time, related to the sampled data.

ValueSampledDataUpperLimit__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The upper limit in data that comes from a series of measurements taken by a device.

ValueSystem__c 

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system that defines the information determined by making the observation, if the information has a simple value.

Usage 

Most observations are simple name-value pair assertions with some metadata, but some observations group other observations together logically, or even are multicomponent observations.