CareObservationComponent

Represents information about a component of a care observation. This object is available in API version 51.0 and later.

Supported Calls

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

Fields

BaselineUnitId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The baseline value’s unit.
  • Referenced Objects:
    • UnitOfMeasure

BaselineValueText

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The baseline value of an observation represented as a string.

CareObservationId

  • Type: Master-detail reference
  • Properties: Create, Filter, Group, Sort
  • Description: References the parent care observation that this component belongs to.
  • Referenced Objects:
    • CareObservation

ComponentTypeCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Sort, Update
  • Description: The system-generated code that represents the component type.
  • Referenced Objects:
    • CodeSetBundle
  • Example: The LOINC code for niacin in blood.

DataAbsentReasonId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Represents the reason why the data for the observed value is absent. Available in API version 68.0 and later.
  • Referenced Objects:
    • CodeSetBundle

IsObserved

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates a positive observation.

    A record can only have a value for one of these fields or field combinations:

    • IsObserved
    • ObservationStartDateTime and ObservationEndDateTime
    • ObservedValueCodeId
    • ObservedValueText
    • ObservedValueNumerator, ObservedValueDenominator, and ObservedValueUnitId

LastReferencedDate

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The last date that the record was referenced.

LastViewedDate

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The last date that the record was viewed.

LowerBaselineValue

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Represents the lower limit of the baseline value range for the observation.

MissingDataReason

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The reason why observation data is missing or incomplete.

Name

  • Type: string
  • Properties: Create, Filter, Group, idLookup, Sort, Update
  • Description: The name of the CareObservationComponent record.

NumericValue

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The value of the observation in numeric form.

ObservationEndDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Specifies the end of the period related to observation component value.
    A record can only have a value for one of these fields or field combinations:
    • IsObserved
    • ObservationStartDateTime and ObservationEndDateTime
    • ObservedValueCodeId
    • ObservedValueText
    • ObservedValueNumerator, ObservedValueDenominator, and ObservedValueUnitId

ObservationStartDateTime

  • Type: dateTime
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Specifies the start of the period related to observation component value.
    A record can only have a value for one of these fields or field combinations:
    • IsObserved
    • ObservationStartDateTime and ObservationEndDateTime
    • ObservedValueCodeId
    • ObservedValueText
    • ObservedValueNumerator, ObservedValueDenominator, and ObservedValueUnitId

ObservedValueCodeId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The system-generated code that represents the observed value.
    A record can only have a value for one of these fields or field combinations:
    • IsObserved
    • ObservationStartDateTime and ObservationEndDateTime
    • ObservedValueCodeId
    • ObservedValueText
    • ObservedValueNumerator, ObservedValueDenominator, and ObservedValueUnitId
  • Referenced Objects:
    • CodeSetBundle

ObservedValueDenominator

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The denominator of the numerical type value observed. Use to record quantity, range, and ratio type values.
    A record can only have a value for one of these fields or field combinations:
    • IsObserved
    • ObservationStartDateTime and ObservationEndDateTime
    • ObservedValueCodeId
    • ObservedValueText
    • ObservedValueNumerator, ObservedValueDenominator, and ObservedValueUnitId

ObservedValueNumerator

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The numerator of the numerical type value observed. Use to record quantity, range, and ratio type values.
    A record can only have a value for one of these fields or field combinations:
    • IsObserved
    • ObservationStartDateTime and ObservationEndDateTime
    • ObservedValueCodeId
    • ObservedValueText
    • ObservedValueNumerator, ObservedValueDenominator, and ObservedValueUnitId

ObservedValueText

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The text form of the value observed in the component.
    A record can only have a value for one of these fields or field combinations:
    • IsObserved
    • ObservationStartDateTime and ObservationEndDateTime
    • ObservedValueCodeId
    • ObservedValueText
    • ObservedValueNumerator, ObservedValueDenominator, and ObservedValueUnitId

ObservedValueUnitId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Represents the unit of the observed value. This field is used for quantity, range, and ratio type of observed values.
    A record can only have a value for one of these fields or field combinations:
    • IsObserved
    • ObservationStartDateTime and ObservationEndDateTime
    • ObservedValueCodeId
    • ObservedValueText
    • ObservedValueNumerator, ObservedValueDenominator, and ObservedValueUnitId
  • Referenced Objects:
    • UnitOfMeasure

UpperBaselineValue

  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: Represents the upper limit of the baseline value range for the observation.

ValueDenominatorUnitId

  • Type: reference
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The unit of measure for the denominator of the observed value. Available in API version 68.0 and later.
  • Referenced Objects:
    • UnitOfMeasure

ValueInterpretation

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Specifies the interpretation of values observed.
  • Possible values:
    • High
    • Low
    • Normal

ValueTime

  • Type: time
  • Properties: Create, Filter, Nillable, Sort, Update
  • Description: The time of day (hh:mm:ss) that’s recorded as the observed value. Available in API version 68.0 and later.

ValueType

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Specifies the type of observed value recorded in ObservedValueNumerator and ObservedValueDenominator.
  • Possible values:
    • Quantity
    • Range
    • Ratio

Usage

This object is used to record the different components of an observation, such as different tests that are part of a clinical observation. Component records are connected to the parent observation records using the CareObservationId field.

Associated Objects

This object has the following associated objects. Unless noted, they are available in the same API version as this object.

CareObservationComponentFeed
Feed tracking is available for the object.
CareObservationComponentHistory
History is available for tracked fields of the object.
CareObservationComponentChangeEvent (API version 61.0)
Change events are available for the object.