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

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

## Logical Model: Person OMOP Table 

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

 
This table serves as the central identity management for all Persons in the database. It contains records that uniquely identify each person or patient, and some demographic information. 

**Usages:**

* Use this Logical Model: [LogicalBundle](StructureDefinition-LogicalBundle.md)
* Refer to this Logical Model: [Condition Era OMOP Table](StructureDefinition-OMOPConditionEra.md), [Condition Occurrence OMOP Table](StructureDefinition-OMOPConditionOccurrence.md), [Death OMOP Table](StructureDefinition-OMOPDeath.md), [Device Exposure OMOP Table](StructureDefinition-OMOPDeviceExposure.md)...Show 13 more,[Dose Era OMOP Table](StructureDefinition-OMOPDoseEra.md),[Drug Era OMOP Table](StructureDefinition-OMOPDrugEra.md),[Drug Occurrence OMOP Table](StructureDefinition-OMOPDrugExposure.md),[Episode OMOP Table](StructureDefinition-OMOPEpisode.md),[Measurement OMOP Table](StructureDefinition-OMOPMeasurement.md),[Note OMOP Table](StructureDefinition-OMOPNote.md),[Observation OMOP Table](StructureDefinition-OMOPObservation.md),[Observation Period OMOP Table](StructureDefinition-OMOPObservationPeriod.md),[Payer Plan Period OMOP Table](StructureDefinition-OMOPPayerPlanPeriod.md),[Procedure Occurrence OMOP Table](StructureDefinition-OMOPProcedureOccurrence.md),[Specimen OMOP Table](StructureDefinition-OMOPSpecimen.md),[Visit Detail OMOP Table](StructureDefinition-OMOPVisitDetail.md)and[Visit Occurrence OMOP Table](StructureDefinition-OMOPVisitOccurrence.md)

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

### 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-OMOPPerson.csv), [Excel](StructureDefinition-OMOPPerson.xlsx) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "OMOPPerson",
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
      "valueCode" : "can-be-target"
    }
  ],
  "url" : "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPPerson",
  "version" : "0.1.0",
  "name" : "OMOPPerson",
  "title" : "Person 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" : "This table serves as the central identity management for all Persons in the database. It contains records that uniquely identify each person or patient, and some demographic information.",
  "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/OMOPPerson",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation" : "specialization",
  "differential" : {
    "element" : [
      {
        "id" : "OMOPPerson",
        "path" : "OMOPPerson",
        "short" : "Person OMOP Table",
        "definition" : "This table serves as the central identity management for all Persons in the database. It contains records that uniquely identify each person or patient, and some demographic information."
      },
      {
        "id" : "OMOPPerson.person-id",
        "path" : "OMOPPerson.person_id",
        "short" : "Person Identifier",
        "definition" : "It is assumed that every person with a different unique identifier is in fact a different person and should be treated independently.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPPerson.gender-concept-id",
        "path" : "OMOPPerson.gender_concept_id",
        "short" : "Gender",
        "definition" : "This field is meant to capture the biological sex at birth of the Person. This field should not be used to study gender identity issues.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPPerson.year-of-birth",
        "path" : "OMOPPerson.year_of_birth",
        "short" : "Year of Birth",
        "definition" : "Compute age using year_of_birth.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPPerson.month-of-birth",
        "path" : "OMOPPerson.month_of_birth",
        "short" : "Month of Birth",
        "definition" : "Month of Birth",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPPerson.day-of-birth",
        "path" : "OMOPPerson.day_of_birth",
        "short" : "Day of Birth",
        "definition" : "Day of Birth",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "integer"
          }
        ]
      },
      {
        "id" : "OMOPPerson.birth-datetime",
        "path" : "OMOPPerson.birth_datetime",
        "short" : "Birth Datetime",
        "definition" : "Birth Datetime",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "dateTime"
          }
        ]
      },
      {
        "id" : "OMOPPerson.race-concept-id",
        "path" : "OMOPPerson.race_concept_id",
        "short" : "Race",
        "definition" : "This field captures race or ethnic background of the person.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPPerson.ethnicity-concept-id",
        "path" : "OMOPPerson.ethnicity_concept_id",
        "short" : "Ethnicity",
        "definition" : "This field captures Ethnicity as defined by the Office of Management and Budget (OMB) of the US Government: it distinguishes only between “Hispanic” and “Not Hispanic”. Races and ethnic backgrounds are not stored here.",
        "min" : 1,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPPerson.location-id",
        "path" : "OMOPPerson.location_id",
        "short" : "Location",
        "definition" : "The location refers to the physical address of the person. This field should capture the last known location of the person.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPLocation"
            ]
          }
        ]
      },
      {
        "id" : "OMOPPerson.provider-id",
        "path" : "OMOPPerson.provider_id",
        "short" : "Provider",
        "definition" : "The Provider refers to the last known primary care provider (General Practitioner).",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPProvider"
            ]
          }
        ]
      },
      {
        "id" : "OMOPPerson.care-site-id",
        "path" : "OMOPPerson.care_site_id",
        "short" : "Care Site",
        "definition" : "The Care Site refers to where the Provider typically provides the primary care.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPCareSite"
            ]
          }
        ]
      },
      {
        "id" : "OMOPPerson.person-source-value",
        "path" : "OMOPPerson.person_source_value",
        "short" : "Person Identifier Source Value",
        "definition" : "Use this field to link back to persons in the source data. This is typically used for error checking of ETL logic.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPPerson.gender-source-value",
        "path" : "OMOPPerson.gender_source_value",
        "short" : "Gender Source Value",
        "definition" : "This field is used to store the biological sex of the person from the source data. It is not intended for use in standard analytics but for reference only.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPPerson.gender-source-concept-id",
        "path" : "OMOPPerson.gender_source_concept_id",
        "short" : "Gender Source Concept",
        "definition" : "If the source data codes biological sex in a non-standard vocabulary, store the concept_id here.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPPerson.race-source-value",
        "path" : "OMOPPerson.race_source_value",
        "short" : "Race Source Value",
        "definition" : "This field is used to store the race of the person from the source data. It is not intended for use in standard analytics but for reference only.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPPerson.race-source-concept-id",
        "path" : "OMOPPerson.race_source_concept_id",
        "short" : "Race Source Concept",
        "definition" : "If the source data codes race in an OMOP supported vocabulary store the concept_id here.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      },
      {
        "id" : "OMOPPerson.ethnicity-source-value",
        "path" : "OMOPPerson.ethnicity_source_value",
        "short" : "Ethnicity Source Value",
        "definition" : "This field is used to store the ethnicity of the person from the source data. It is not intended for use in standard analytics but for reference only.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "string"
          }
        ]
      },
      {
        "id" : "OMOPPerson.ethnicity-source-concept-id",
        "path" : "OMOPPerson.ethnicity_source_concept_id",
        "short" : "Ethnicity Source Concept",
        "definition" : "If the source data codes ethnicity in an OMOP supported vocabulary, store the concept_id here.",
        "min" : 0,
        "max" : "1",
        "type" : [
          {
            "code" : "Reference",
            "targetProfile" : [
              "https://interop.aphp.fr/ig/fhir/dm/StructureDefinition/OMOPConcept"
            ]
          }
        ]
      }
    ]
  }
}

```
