--- schema_version: "1" id: e1b5279ef6ad1065130057c92c35f29cd4e22a164506a0469815beaeefdf6414 title: Observation collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/life_sciences_dev_guide/map_fhir_observation.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/map_fhir_observation.htm source_site: developer.salesforce.com content_type: documentation content_hash: eac56e67882f8a8782febb68840ea552b36c136958f98306e884fa37a8ac6032 description: The observation FHIR resource maps to the CareObservation and CareObservationComponent objects in Salesforce. --- # Observation The observation FHIR resource maps to the CareObservation and CareObservationComponent objects in Salesforce. ## FHIR V4.0 - Clinical Data Model Mapping Here’s how the fields defined by FHIR for [observation](https://www.hl7.org/fhir/observation.html) map to the fields in Salesforce.

Table 1. observation - Salesforce
Observation Resource	Salesforce Field	Type	Salesforce Cardinality	Notes
`identifier`	N/A	N/A	N/A	Not supported
`basedOn`	`CareObservation.BasedOnId`	Polymorphic Lookup: `MedicationRequest`, `ClinicalServiceRequest`	0.1	While FHIR defines `observation.basedOn` as a zero-to-many reference, the Salesforce implementation is a zero-to-one text field. Only references to medication request and clinical service request records are supported.
`partOf`	`CareObservation.PartOfId`	Polymorphic Lookup: `MedicationStatement`, `PatientImmunization`, `PatientMedicalProcedure`	0.1	While FHIR defines `observation.partOf` as a zero-to-many reference, the Salesforce implementation is a zero-to-one text field. Only references to medication statement, patient immunization, and patient medical procedure records are supported.
`status`	`CareObservation.ObservationStatus`	Picklist	1.1	While FHIR defines `observation.status` as a reference to code set bundle, the Salesforce implementation is a picklist.
`category`	`CareObservation.Category`	Picklist	0.1	While FHIR defines `observation.category` as a zero-to-many reference to code set bundle, the Salesforce implementation is a zero-to-one picklist.
`code`	`CareObservation.CodeId`	Lookup: `CodeSet`	1.1	While FHIR defines `observation.code` as a one-to-one reference to code set bundle, Salesforce implements this as three separate `CodeSet` reference fields. The first one is a one-to-one field, while the other two are zero-to-one fields.
`code`	`CareObservation.AdditionalCode1Id`	Lookup: `CodeSet`	0.1	While FHIR defines `observation.code` as a one-to-one reference to code set bundle, Salesforce implements this as three separate `CodeSet` reference fields. The first one is a one-to-one field, while the other two are zero-to-one fields.
`code`	`CareObservation.AdditionalCode2Id`	Lookup: `CodeSet`	0.1	While FHIR defines `observation.code` as a one-to-one reference to code set bundle, Salesforce implements this as three separate `CodeSet` reference fields. The first one is a one-to-one field, while the other two are zero-to-one fields.
`subject`	`CareObservation.ObservedSubjectId`	Master-Detail: `Account`	1.1	The Salesforce implementation of `observation.subject` supports references to only patients.
`focus`	N/A	N/A	N/A	Not supported
`encounter`	`CareObservation.EncounterId`	Lookup: `ClinicalEncounter`	0.1	N/A
`effective.effectiveDateTime`	`CareObservation.EffectiveDateTime`	DateTime	0.1	N/A
`effective.effectivePeriod`	`CareObservation.EffectiveDateTime`	DateTime	0.1	Because Salesforce doesn’t support a native period data type, the `observation.effective.effectivePeriod` field is flattened into a set of effective date and end date fields.
`effective.effectivePeriod`	`CareObservation.EndDateTime`	DateTime	0.1	Because Salesforce doesn’t support a native period data type, the `observation.effective.effectivePeriod` field is flattened into a set of effective date and end date fields.
`effective.effectiveTiming`	N/A	N/A	N/A	Not supported
`effective.effectiveInstant`	N/A	N/A	N/A	Not supported
`issued`	`CareObservation.IssuedDateTime`	DateTime	0.1	Because Salesforce doesn’t support a native instant data type, the `observation.issued` FHIR resource is implemented as a date time field in Salesforce.
`performer`	`CareObservation.ObserverId`	Polymorphic Lookup: `Account`, `Healthcare Provider`	0.1	While FHIR defines `observation.performer` as a zero-to-many resource, the Salesforce implementation is a zero-to-one reference to `Account` and `Healthcare Provider`. References to care teams are not supported.
`resultsInterpreter`	`CareObservation.InterpretedById`	Lookup: `CarePerformer`	0.1	While FHIR defines `observation.resultsInterpreter` as a zero-to-many resource, the Salesforce implementation is a zero-to-one reference to `CarePerformer`.
value	`CareObservation.ObservedValueType`	Static Picklist	0.1	A Salesforce-original field that determines whether the value stored in `CareObservation.ObservedValueNumerator` and `CareObservation.ObservedValueDenominator` is a range, ratio, or quantity. This field is used only when the data entered for `observation.value` is one these data types.
value	`CareObservation.ObservedValueNumerator`	Double	0.1	Because Salesforce doesn’t support native range, ratio, and quantity data types, the `observation.value` FHIR resource is flattened to a set of numerator, denominator, and unit fields for this type of data. The Salesforce implementation of `observation.value` doesn’t support `observation.value.valueSampleData` and `observation.value.valueTime`. `CareObservation.ObservedValueUnitId` is a duplicate field that stores the same information as `CareObservation.UnitOfMeasureId`. Use only one of these two fields to specify the unit of a quantity value.
value	`CareObservation.ObservedValueDenominator`	Double	0.1	Because Salesforce doesn’t support native range, ratio, and quantity data types, the `observation.value` FHIR resource is flattened to a set of numerator, denominator, and unit fields for this type of data. The Salesforce implementation of `observation.value` doesn’t support `observation.value.valueSampleData` and `observation.value.valueTime`. `CareObservation.ObservedValueUnitId` is a duplicate field that stores the same information as `CareObservation.UnitOfMeasureId`. Use only one of these two fields to specify the unit of a quantity value.
value	`CareObservation.ObservedValueUnitId`	Lookup: `UnitOfMeasure`	0.1	Because Salesforce doesn’t support native range, ratio, and quantity data types, the `observation.value` FHIR resource is flattened to a set of numerator, denominator, and unit fields for this type of data. The Salesforce implementation of `observation.value` doesn’t support `observation.value.valueSampleData` and `observation.value.valueTime`. `CareObservation.ObservedValueUnitId` is a duplicate field that stores the same information as `CareObservation.UnitOfMeasureId`. Use only one of these two fields to specify the unit of a quantity value.
value	`CareObservation.ObservedValueDenominator`	Lookup: `CodeSetBundle`	0.1	N/A
value	`CareObservation.NumbericValue`	Double	0.1	N/A
value	`CareObservation.ObservedValueText`	String	0.1	N/A
value	`CareObservation.IsOutcomePositive`	Boolean	0.1	`CareObservation.IsObserved` is a duplicate field that can store the same information. Use only one of these two fields.
value	`CareObservation.ObservationStartTime`	DateTime	0.1	`CareObservation.ObservationStartTime` is used for both `observation.component.value.valueDateTime` and `observation.component.value.valuePeriod`. Because Salesforce doesn’t support a native period data type, the `observation.value.valuePeriod` FHIR resource is flattened to a set of start and end dates.
value	`CareObservation.ObservationEndTime`	DateTime	0.1	`CareObservation.ObservationStartTime` is used for both `observation.component.value.valueDateTime` and `observation.component.value.valuePeriod`. Because Salesforce doesn’t support a native period data type, the `observation.value.valuePeriod` FHIR resource is flattened to a set of start and end dates.
`dataAbsentReason`	N/A	N/A	N/A	Not supported
`interpretation`	`CareObservation.ValueInterpretation`	Picklist	0.1	While FHIR defines `observation.interpretation` as a zero-to-many code set bundle, the Salesforce implementation is a zero-to-one picklist.
`note`	N/A	N/A	N/A	Not supported
`bodySite`	`CareObservation.BodySiteId`	Lookup: `CodeSetBundle`	0.1	N/A
`method`	`CareObservation.MethodId`	Lookup: `CodeSetBundle`	0.1	N/A
`specimen`	N/A	N/A	N/A	Not supported
`device`	`CareObservation.DeviceId`	Lookup: `Asset`	0.1	References to device metrics records aren’t supported.
`referenceRange.low`	`CareObservation.LowerBaselineValue`	Double	0.1	Because Salesforce doesn’t support a native quantity data type, the `observation.referenceRange.low` FHIR resource is flattened to a set of value and unit fields for this type of data.
`referenceRange.low`	`CareObservation.BaselineUnitId`	Lookup: `UnitOfMeasure`	0.1	Because Salesforce doesn’t support a native quantity data type, the `observation.referenceRange.low` FHIR resource is flattened to a set of value and unit fields for this type of data.
`referenceRange.high`	`CareObservation.UpperBaselineValue`	Double	0.1	Because Salesforce doesn’t support a native quantity data type, the `observation.referenceRange.high` FHIR resource is flattened to a set of value and unit fields for this type of data.
`referenceRange.high`	`CareObservation.BaselineUnitId`	Lookup: `UnitOfMeasure`	0.1	Because Salesforce doesn’t support a native quantity data type, the `observation.referenceRange.high` FHIR resource is flattened to a set of value and unit fields for this type of data.
`referenceRange.type`	N/A	N/A	N/A	Not supported
`referenceRange.appliesTo`	N/A	N/A	N/A	Not supported
`referenceRange.age`	N/A	N/A	N/A	Not supported
`referenceRange.text`	`CareObservation.BaselineValueText`	String	0.1	N/A
`hasMember`	`CareObservation.RelatedObservationId`	Lookup: `CareObservation`	0.1	While FHIR defines `observation.hasMember` as a zero-to-many resource, the Salesforce implementation is zero-to-one. Only references to observation records are supported.
`derivedFrom`	`CareObservation.DerivationSourceId`	Lookup: CareObservation, DiagnosticSummary	0.1	While FHIR defines `observation.derivedFrom` as a zero-to-many resource, the Salesforce implementation is zero-to-one.
`component`	`CareObservationComponent`	Object	0.M	The component information for a care observation is represented as `CareObservationComponent` records that reference the `CareObservation` record using their `Identifier.CareObservationId` field.
`component.code`	`CareObservationComponent.ComponentTypeCodeId`	Lookup: `CodeSetBundle`	1.1	N/A
`component.value`	`CareObservationComponent.ValueType`	Static Picklist	0.1	A Salesforce-original field that determines whether the value stored in `CareObservationComponent.ObservedValueNumerator` and `CareObservationComponent.ObservedValueDenominator` is a range, ratio, or quantity. This field is used only when the data entered for `observation.component.value` is one these data types.
`component.value`	`CareObservationComponent.ObservedValueNumerator`	Double	0.1	Because Salesforce doesn’t support native range, ratio, and quantity data types, the `observation.component.value` FHIR resource is flattened to a set of numerator, denominator, and unit fields for this type of data. The Salesforce implementation of `observation.component.value` doesn’t support `observation.component.value.valueSampleData` and `observation.component.value.valueTime`.
`component.value`	`CareObservationComponent.ObservedValueDenominator`	Double	0.1	Because Salesforce doesn’t support native range, ratio, and quantity data types, the `observation.component.value` FHIR resource is flattened to a set of numerator, denominator, and unit fields for this type of data. The Salesforce implementation of `observation.component.value` doesn’t support `observation.component.value.valueSampleData` and `observation.component.value.valueTime`.
`component.value`	`CareObservationComponent.ObservedValueUnitId`	Lookup: `UnitOfMeasure`	0.1	Because Salesforce doesn’t support native range, ratio, and quantity data types, the `observation.component.value` FHIR resource is flattened to a set of numerator, denominator, and unit fields for this type of data. The Salesforce implementation of `observation.component.value` doesn’t support `observation.component.value.valueSampleData` and `observation.component.value.valueTime`.
`component.value`	`CareObservationComponent.ObservedValueCodeId`	Lookup: `CodeSetBundle`	0.1	N/A
`component.value`	`CareObservationComponent.NumericValue`	Double	0.1	N/A
`component.value`	`CareObservationComponent.ObservedValueText`	String	0.1	N/A
`component.value`	`CareObservationComponent.IsObserved`	Boolean	0.1	N/A
`component.value`	`CareObservationComponent.ObservationStartTime`	DateTime	0.1	`CareObservationComponent.ObservationStartTime` is used for both `observation.component.value.valueDateTime` and `observation.component.value.valuePeriod`. Because Salesforce doesn’t support a native period data type, the `observation.component.value.valuePeriod` FHIR resource is flattened to a set of start and end dates.
`component.value`	`CareObservationComponent.ObservationEndTime`	DateTime	0.1	`CareObservationComponent.ObservationStartTime` is used for both `observation.component.value.valueDateTime` and `observation.component.value.valuePeriod`. Because Salesforce doesn’t support a native period data type, the `observation.component.value.valuePeriod` FHIR resource is flattened to a set of start and end dates.
`component.dataAbsentReason`	`CareObservationComponent.MissingDataReason`	String	0.1	While FHIR defines `observation.component.dataAbsentReason` as a code set bundle reference, the Salesforce implementation is a text field.
`component.interpretation`	`CareObservationComponent.ValueInterpretation`	Lookup: `CodeSetBundle`	0.1	While FHIR defines `observation.component.interpretation` as a code set bundle reference, the Salesforce implementation is a picklist.
`component.referenceRange.low`	`CareObservationComponent.LowerBaselineValue`	Double	0.1	Because Salesforce doesn’t support a native quantity data type, the `observation.component.referenceRange.low` FHIR resource is flattened to a set of value and unit fields for this type of data.
`component.referenceRange.low`	`CareObservationComponent.BaselineUnitId`	Lookup: `UnitOfMeasure`	0.1	Because Salesforce doesn’t support a native quantity data type, the `observation.component.referenceRange.low` FHIR resource is flattened to a set of value and unit fields for this type of data.
`component.referenceRange.high`	`CareObservationComponent.UpperBaselineValue`	Double	0.1	Because Salesforce doesn’t support a native quantity data type, the `observation.component.referenceRange.high` FHIR resource is flattened to a set of value and unit fields for this type of data.
`component.referenceRange.high`	`CareObservationComponent.BaselineUnitId`	Lookup: `UnitOfMeasure`	0.1	Because Salesforce doesn’t support a native quantity data type, the `observation.component.referenceRange.high` FHIR resource is flattened to a set of value and unit fields for this type of data.
`component.referenceRange.type`	N/A	N/A	N/A	Not supported
`component.referenceRange.appliesTo`	N/A	N/A	N/A	Not supported
`component.referenceRange.age`	N/A	N/A	N/A	Not supported
`component.referenceRange.text`	`CareObservationComponent.BaselineValueText`	String	0.1	N/A

![Note](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/images/icon_note.png) #### Note The fields CareObservation.IsOutcomePositive and CareObservation.UnitOfMeasureId don’t have FHIR-defined validation rules built into them because these fields are used in other features and data models. You can define your own custom validation rules on them based on your business requirements.