Data Management with FHIR
0.1.0 - ci-build

Data Management with FHIR - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Logical Model: OMOPObservation - Detailed Descriptions

Draft as of 2025-10-23

Definitions for the OMOPObservation logical model.

- Key Elements Table
- Differential Elements Table
- Snapshot Elements Table

Guidance on how to interpret the contents of this table can be foundhere

0. OMOPObservation
Définition | The OBSERVATION table captures clinical facts about a Person obtained in the context of examination, questioning or a procedure. Any data that cannot be represented by any other domains, such as social and lifestyle facts, medical history, family history, etc. are recorded here.
Short | Observation OMOP Table
Control | 0..*
Is Modifier | false
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. OMOPObservation.observation-id
Définition | Observation Identifier
Short | Observation Identifier
Control | 1..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
4. OMOPObservation.person-id
Définition | The PERSON_ID of the Person for whom the Observation is recorded. This may be a system generated code.
Short | Person
Control | 1..1
Type | Reference(Person OMOP Table)
6. OMOPObservation.observation-concept-id
Définition | The OBSERVATION_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies.
Short | Observation
Control | 1..1
Type | Reference(Concept OMOP Table)
8. OMOPObservation.observation-date
Définition | The date of the Observation. Depending on what the Observation represents this could be the date of a lab test, the date of a survey, or the date a patient's family history was taken.
Short | Observation Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
10. OMOPObservation.observation-datetime
Définition | Observation Datetime
Short | Observation Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
12. OMOPObservation.observation-type-concept-id
Définition | This field can be used to determine the provenance of the Observation record, as in whether the measurement was from an EHR system, insurance claim, registry, or other sources.
Short | Observation Type
Control | 1..1
Type | Reference(Concept OMOP Table)
14. OMOPObservation.value-as-number
Définition | This is the numerical value of the Result of the Observation, if applicable and available. It is not expected that all Observations will have numeric results, rather, this field is here to house values should they exist.
Short | Value as Number
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
16. OMOPObservation.value-as-string
Définition | This is the categorical value of the Result of the Observation, if applicable and available.
Short | Value as String
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. OMOPObservation.value-as-concept-id
Définition | It is possible that some records destined for the Observation table have two clinical ideas represented in one source code. This is common with ICD10 codes that describe a family history of some Condition, for example. In OMOP the Vocabulary breaks these two clinical ideas into two codes; one becomes the OBSERVATION_CONCEPT_ID and the other becomes the VALUE_AS_CONCEPT_ID. It is important when using the Observation table to keep this possibility in mind and to examine the VALUE_AS_CONCEPT_ID field for relevant information.
Short | Value as Concept
Control | 0..1
Type | Reference(Concept OMOP Table)
20. OMOPObservation.qualifier-concept-id
Définition | This field contains all attributes specifying the clinical fact further, such as as degrees, severities, drug-drug interaction alerts etc.
Short | Qualifier
Control | 0..1
Type | Reference(Concept OMOP Table)
22. OMOPObservation.unit-concept-id
Définition | There is currently no recommended unit for individual observation concepts. UNIT_SOURCE_VALUES should be mapped to a Standard Concept in the Unit domain that best represents the unit as given in the source data.
Short | Unit
Control | 0..1
Type | Reference(Concept OMOP Table)
24. OMOPObservation.provider-id
Définition | The provider associated with the observation record, e.g. the provider who ordered the test or the provider who recorded the result.
Short | Provider
Control | 0..1
Type | Reference(Provider OMOP Table)
26. OMOPObservation.visit-occurrence-id
Définition | The visit during which the Observation occurred.
Short | Visit Occurence
Control | 0..1
Type | Reference(Visit Occurrence OMOP Table)
28. OMOPObservation.visit-detail-id
Définition | The VISIT_DETAIL record during which the Observation occurred. For example, if the Person was in the ICU at the time the VISIT_OCCURRENCE record would reflect the overall hospital stay and the VISIT_DETAIL record would reflect the ICU stay during the hospital visit.
Short | Visit Detail
Control | 0..1
Type | Reference(Visit Detail OMOP Table)
30. OMOPObservation.observation-source-value
Définition | This field houses the verbatim value from the source data representing the Observation that occurred. For example, this could be an ICD10 or Read code.
Short | Observation Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
32. OMOPObservation.observation-source-concept-id
Définition | This is the concept representing the OBSERVATION_SOURCE_VALUE and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Observation necessary for a given analytic use case. Consider using OBSERVATION_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.
Short | Observation Source
Control | 0..1
Type | Reference(Concept OMOP Table)
34. OMOPObservation.unit-source-value
Définition | This field houses the verbatim value from the source data representing the unit of the Observation that occurred.
Short | Unit Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
36. OMOPObservation.qualifier-source-value
Définition | This field houses the verbatim value from the source data representing the qualifier of the Observation that occurred.
Short | Qualifier Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
38. OMOPObservation.value-source-value
Définition | This field houses the verbatim result value of the Observation from the source data. Do not get confused with the Observation_source_value which captures source value of the observation mapped to observation_concept_id. This field is the observation result value from the source.
Short | Value Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
40. OMOPObservation.observation-event-id
Définition | If the Observation record is related to another record in the database, this field is the primary key of the linked record.
Short | Observation Event
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
42. OMOPObservation.obs-event-field-concept-id
Définition | If the Observation record is related to another record in the database, this field is the CONCEPT_ID that identifies which table the primary key of the linked record came from.
Short | Observation Event Field Concept
Control | 0..1
Type | Reference(Concept OMOP Table)

Guidance on how to interpret the contents of this table can be foundhere

0. OMOPObservation
Définition | The OBSERVATION table captures clinical facts about a Person obtained in the context of examination, questioning or a procedure. Any data that cannot be represented by any other domains, such as social and lifestyle facts, medical history, family history, etc. are recorded here.
Short | Observation OMOP Table
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. OMOPObservation.observation-id
Définition | Observation Identifier
Short | Observation Identifier
Control | 1..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
4. OMOPObservation.person-id
Définition | The PERSON_ID of the Person for whom the Observation is recorded. This may be a system generated code.
Short | Person
Control | 1..1
Type | Reference(Person OMOP Table)
6. OMOPObservation.observation-concept-id
Définition | The OBSERVATION_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies.
Short | Observation
Control | 1..1
Type | Reference(Concept OMOP Table)
8. OMOPObservation.observation-date
Définition | The date of the Observation. Depending on what the Observation represents this could be the date of a lab test, the date of a survey, or the date a patient's family history was taken.
Short | Observation Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
10. OMOPObservation.observation-datetime
Définition | Observation Datetime
Short | Observation Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
12. OMOPObservation.observation-type-concept-id
Définition | This field can be used to determine the provenance of the Observation record, as in whether the measurement was from an EHR system, insurance claim, registry, or other sources.
Short | Observation Type
Control | 1..1
Type | Reference(Concept OMOP Table)
14. OMOPObservation.value-as-number
Définition | This is the numerical value of the Result of the Observation, if applicable and available. It is not expected that all Observations will have numeric results, rather, this field is here to house values should they exist.
Short | Value as Number
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
16. OMOPObservation.value-as-string
Définition | This is the categorical value of the Result of the Observation, if applicable and available.
Short | Value as String
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. OMOPObservation.value-as-concept-id
Définition | It is possible that some records destined for the Observation table have two clinical ideas represented in one source code. This is common with ICD10 codes that describe a family history of some Condition, for example. In OMOP the Vocabulary breaks these two clinical ideas into two codes; one becomes the OBSERVATION_CONCEPT_ID and the other becomes the VALUE_AS_CONCEPT_ID. It is important when using the Observation table to keep this possibility in mind and to examine the VALUE_AS_CONCEPT_ID field for relevant information.
Short | Value as Concept
Control | 0..1
Type | Reference(Concept OMOP Table)
20. OMOPObservation.qualifier-concept-id
Définition | This field contains all attributes specifying the clinical fact further, such as as degrees, severities, drug-drug interaction alerts etc.
Short | Qualifier
Control | 0..1
Type | Reference(Concept OMOP Table)
22. OMOPObservation.unit-concept-id
Définition | There is currently no recommended unit for individual observation concepts. UNIT_SOURCE_VALUES should be mapped to a Standard Concept in the Unit domain that best represents the unit as given in the source data.
Short | Unit
Control | 0..1
Type | Reference(Concept OMOP Table)
24. OMOPObservation.provider-id
Définition | The provider associated with the observation record, e.g. the provider who ordered the test or the provider who recorded the result.
Short | Provider
Control | 0..1
Type | Reference(Provider OMOP Table)
26. OMOPObservation.visit-occurrence-id
Définition | The visit during which the Observation occurred.
Short | Visit Occurence
Control | 0..1
Type | Reference(Visit Occurrence OMOP Table)
28. OMOPObservation.visit-detail-id
Définition | The VISIT_DETAIL record during which the Observation occurred. For example, if the Person was in the ICU at the time the VISIT_OCCURRENCE record would reflect the overall hospital stay and the VISIT_DETAIL record would reflect the ICU stay during the hospital visit.
Short | Visit Detail
Control | 0..1
Type | Reference(Visit Detail OMOP Table)
30. OMOPObservation.observation-source-value
Définition | This field houses the verbatim value from the source data representing the Observation that occurred. For example, this could be an ICD10 or Read code.
Short | Observation Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
32. OMOPObservation.observation-source-concept-id
Définition | This is the concept representing the OBSERVATION_SOURCE_VALUE and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Observation necessary for a given analytic use case. Consider using OBSERVATION_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.
Short | Observation Source
Control | 0..1
Type | Reference(Concept OMOP Table)
34. OMOPObservation.unit-source-value
Définition | This field houses the verbatim value from the source data representing the unit of the Observation that occurred.
Short | Unit Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
36. OMOPObservation.qualifier-source-value
Définition | This field houses the verbatim value from the source data representing the qualifier of the Observation that occurred.
Short | Qualifier Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
38. OMOPObservation.value-source-value
Définition | This field houses the verbatim result value of the Observation from the source data. Do not get confused with the Observation_source_value which captures source value of the observation mapped to observation_concept_id. This field is the observation result value from the source.
Short | Value Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
40. OMOPObservation.observation-event-id
Définition | If the Observation record is related to another record in the database, this field is the primary key of the linked record.
Short | Observation Event
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
42. OMOPObservation.obs-event-field-concept-id
Définition | If the Observation record is related to another record in the database, this field is the CONCEPT_ID that identifies which table the primary key of the linked record came from.
Short | Observation Event Field Concept
Control | 0..1
Type | Reference(Concept OMOP Table)

Guidance on how to interpret the contents of this table can be foundhere

0. OMOPObservation
Définition | The OBSERVATION table captures clinical facts about a Person obtained in the context of examination, questioning or a procedure. Any data that cannot be represented by any other domains, such as social and lifestyle facts, medical history, family history, etc. are recorded here.
Short | Observation OMOP Table
Control | 0..*
Is Modifier | false
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. OMOPObservation.observation-id
Définition | Observation Identifier
Short | Observation Identifier
Control | 1..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
4. OMOPObservation.person-id
Définition | The PERSON_ID of the Person for whom the Observation is recorded. This may be a system generated code.
Short | Person
Control | 1..1
Type | Reference(Person OMOP Table)
6. OMOPObservation.observation-concept-id
Définition | The OBSERVATION_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies.
Short | Observation
Control | 1..1
Type | Reference(Concept OMOP Table)
8. OMOPObservation.observation-date
Définition | The date of the Observation. Depending on what the Observation represents this could be the date of a lab test, the date of a survey, or the date a patient's family history was taken.
Short | Observation Date
Control | 1..1
Type | date
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
10. OMOPObservation.observation-datetime
Définition | Observation Datetime
Short | Observation Datetime
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
12. OMOPObservation.observation-type-concept-id
Définition | This field can be used to determine the provenance of the Observation record, as in whether the measurement was from an EHR system, insurance claim, registry, or other sources.
Short | Observation Type
Control | 1..1
Type | Reference(Concept OMOP Table)
14. OMOPObservation.value-as-number
Définition | This is the numerical value of the Result of the Observation, if applicable and available. It is not expected that all Observations will have numeric results, rather, this field is here to house values should they exist.
Short | Value as Number
Control | 0..1
Type | integer
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
16. OMOPObservation.value-as-string
Définition | This is the categorical value of the Result of the Observation, if applicable and available.
Short | Value as String
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. OMOPObservation.value-as-concept-id
Définition | It is possible that some records destined for the Observation table have two clinical ideas represented in one source code. This is common with ICD10 codes that describe a family history of some Condition, for example. In OMOP the Vocabulary breaks these two clinical ideas into two codes; one becomes the OBSERVATION_CONCEPT_ID and the other becomes the VALUE_AS_CONCEPT_ID. It is important when using the Observation table to keep this possibility in mind and to examine the VALUE_AS_CONCEPT_ID field for relevant information.
Short | Value as Concept
Control | 0..1
Type | Reference(Concept OMOP Table)
20. OMOPObservation.qualifier-concept-id
Définition | This field contains all attributes specifying the clinical fact further, such as as degrees, severities, drug-drug interaction alerts etc.
Short | Qualifier
Control | 0..1
Type | Reference(Concept OMOP Table)
22. OMOPObservation.unit-concept-id
Définition | There is currently no recommended unit for individual observation concepts. UNIT_SOURCE_VALUES should be mapped to a Standard Concept in the Unit domain that best represents the unit as given in the source data.
Short | Unit
Control | 0..1
Type | Reference(Concept OMOP Table)
24. OMOPObservation.provider-id
Définition | The provider associated with the observation record, e.g. the provider who ordered the test or the provider who recorded the result.
Short | Provider
Control | 0..1
Type | Reference(Provider OMOP Table)
26. OMOPObservation.visit-occurrence-id
Définition | The visit during which the Observation occurred.
Short | Visit Occurence
Control | 0..1
Type | Reference(Visit Occurrence OMOP Table)
28. OMOPObservation.visit-detail-id
Définition | The VISIT_DETAIL record during which the Observation occurred. For example, if the Person was in the ICU at the time the VISIT_OCCURRENCE record would reflect the overall hospital stay and the VISIT_DETAIL record would reflect the ICU stay during the hospital visit.
Short | Visit Detail
Control | 0..1
Type | Reference(Visit Detail OMOP Table)
30. OMOPObservation.observation-source-value
Définition | This field houses the verbatim value from the source data representing the Observation that occurred. For example, this could be an ICD10 or Read code.
Short | Observation Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
32. OMOPObservation.observation-source-concept-id
Définition | This is the concept representing the OBSERVATION_SOURCE_VALUE and may not necessarily be standard. This field is discouraged from use in analysis because it is not required to contain Standard Concepts that are used across the OHDSI community, and should only be used when Standard Concepts do not adequately represent the source detail for the Observation necessary for a given analytic use case. Consider using OBSERVATION_CONCEPT_ID instead to enable standardized analytics that can be consistent across the network.
Short | Observation Source
Control | 0..1
Type | Reference(Concept OMOP Table)
34. OMOPObservation.unit-source-value
Définition | This field houses the verbatim value from the source data representing the unit of the Observation that occurred.
Short | Unit Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
36. OMOPObservation.qualifier-source-value
Définition | This field houses the verbatim value from the source data representing the qualifier of the Observation that occurred.
Short | Qualifier Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
38. OMOPObservation.value-source-value
Définition | This field houses the verbatim result value of the Observation from the source data. Do not get confused with the Observation_source_value which captures source value of the observation mapped to observation_concept_id. This field is the observation result value from the source.
Short | Value Source Value
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
40. OMOPObservation.observation-event-id
Définition | If the Observation record is related to another record in the database, this field is the primary key of the linked record.
Short | Observation Event
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
42. OMOPObservation.obs-event-field-concept-id
Définition | If the Observation record is related to another record in the database, this field is the CONCEPT_ID that identifies which table the primary key of the linked record came from.
Short | Observation Event Field Concept
Control | 0..1
Type | Reference(Concept OMOP Table)