# Observation OMOP Table - Data Management with FHIR v0.1.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Observation OMOP Table**

## Logical Model: Observation OMOP Table 

| | |
| :--- | :--- |
| *Official URL*:https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPObservation | *Version*:0.1.0 |
| Draft as of 2025-10-23 | *Computable Name*:OMOPObservation |

 
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. 

**Usages:**

* This Logical Model is not used by any profiles in this Implementation Guide

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/aphp.fhir.fr.dm|current/StructureDefinition/OMOPObservation)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-OMOPObservation.csv), [Excel](StructureDefinition-OMOPObservation.xlsx) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "OMOPObservation",
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
      "valueCode" : "can-be-target"
    }
  ],
  "url" : "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPObservation",
  "version" : "0.1.0",
  "name" : "OMOPObservation",
  "title" : "Observation OMOP Table",
  "status" : "draft",
  "date" : "2025-10-23T20:49:03+00:00",
  "publisher" : "AP-HP",
  "contact" : [
    {
      "name" : "AP-HP",
      "telecom" : [
        {
          "system" : "url",
          "value" : "https://aphp.fr"
        }
      ]
    }
  ],
  "description" : "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.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "FR",
          "display" : "France"
        }
      ]
    }
  ],
  "fhirVersion" : "4.0.1",
  "kind" : "logical",
  "abstract" : false,
  "type" : "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPObservation",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation" : "specialization",
  "differential" : {
    "element" : [
      {
        "id" : "OMOPObservation",
        "path" : "OMOPObservation",
        "short" : "Observation OMOP Table",
        "definition" : "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."
      },
      {
        "id" : "OMOPObservation.observation-id",
        "path" : "OMOPObservation.observation_id",
        "short" : "Observation Identifier",
        "definition" : "Observation Identifier",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPObservation.person-id",
        "path" : "OMOPObservation.person_id",
        "short" : "Person",
        "definition" : "The PERSON_ID of the Person for whom the Observation is recorded. This may be a system generated code.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPPerson"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.observation-concept-id",
        "path" : "OMOPObservation.observation_concept_id",
        "short" : "Observation",
        "definition" : "The OBSERVATION_CONCEPT_ID field is recommended for primary use in analyses, and must be used for network studies.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.observation-date",
        "path" : "OMOPObservation.observation_date",
        "short" : "Observation Date",
        "definition" : "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.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "date"
          }
        ]
      },
      {
        "id" : "OMOPObservation.observation-datetime",
        "path" : "OMOPObservation.observation_datetime",
        "short" : "Observation Datetime",
        "definition" : "Observation Datetime",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "dateTime"
          }
        ]
      },
      {
        "id" : "OMOPObservation.observation-type-concept-id",
        "path" : "OMOPObservation.observation_type_concept_id",
        "short" : "Observation Type",
        "definition" : "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.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.value-as-number",
        "path" : "OMOPObservation.value_as_number",
        "short" : "Value as Number",
        "definition" : "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.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPObservation.value-as-string",
        "path" : "OMOPObservation.value_as_string",
        "short" : "Value as String",
        "definition" : "This is the categorical value of the Result of the Observation, if applicable and available.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPObservation.value-as-concept-id",
        "path" : "OMOPObservation.value_as_concept_id",
        "short" : "Value as Concept",
        "definition" : "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.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.qualifier-concept-id",
        "path" : "OMOPObservation.qualifier_concept_id",
        "short" : "Qualifier",
        "definition" : "This field contains all attributes specifying the clinical fact further, such as as degrees, severities, drug-drug interaction alerts etc.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.unit-concept-id",
        "path" : "OMOPObservation.unit_concept_id",
        "short" : "Unit",
        "definition" : "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.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.provider-id",
        "path" : "OMOPObservation.provider_id",
        "short" : "Provider",
        "definition" : "The provider associated with the observation record, e.g. the provider who ordered the test or the provider who recorded the result.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPProvider"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.visit-occurrence-id",
        "path" : "OMOPObservation.visit_occurrence_id",
        "short" : "Visit Occurence",
        "definition" : "The visit during which the Observation occurred.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPVisitOccurrence"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.visit-detail-id",
        "path" : "OMOPObservation.visit_detail_id",
        "short" : "Visit Detail",
        "definition" : "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.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPVisitDetail"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.observation-source-value",
        "path" : "OMOPObservation.observation_source_value",
        "short" : "Observation Source Value",
        "definition" : "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.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPObservation.observation-source-concept-id",
        "path" : "OMOPObservation.observation_source_concept_id",
        "short" : "Observation Source",
        "definition" : "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.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPObservation.unit-source-value",
        "path" : "OMOPObservation.unit_source_value",
        "short" : "Unit Source Value",
        "definition" : "This field houses the verbatim value from the source data representing the unit of the Observation that occurred.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPObservation.qualifier-source-value",
        "path" : "OMOPObservation.qualifier_source_value",
        "short" : "Qualifier Source Value",
        "definition" : "This field houses the verbatim value from the source data representing the qualifier of the Observation that occurred.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPObservation.value-source-value",
        "path" : "OMOPObservation.value_source_value",
        "short" : "Value Source Value",
        "definition" : "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.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPObservation.observation-event-id",
        "path" : "OMOPObservation.observation_event_id",
        "short" : "Observation Event",
        "definition" : "If the Observation record is related to another record in the database, this field is the primary key of the linked record.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPObservation.obs-event-field-concept-id",
        "path" : "OMOPObservation.obs_event_field_concept_id",
        "short" : "Observation Event Field Concept",
        "definition" : "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.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      }
    ]
  }
}

```
