FHIR to OMOP FHIR IG
2.0.0-ballot - STU 1 Ballot
FHIR to OMOP FHIR IG
2.0.0-ballot - STU 1 Ballot
FHIR to OMOP FHIR IG, published by HL7 International / Biomedical Research and Regulation. This guide is not an authorized publication; it is the continuous build for version 2.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-omop-ig/ and changes regularly. See the Directory of published versions
| Page standards status: Trial-use | Maturity Level: 2 |
@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
# - resource -------------------------------------------------------------------
<http://hl7.org/fhir/StructureMap/PersonMap> a fhir:StructureMap ;
fhir:nodeRole fhir:treeRoot ;
fhir:id [ fhir:v "PersonMap"] ; #
fhir:language [ fhir:v "en"] ; #
fhir:text [
fhir:status [ fhir:v "generated" ] ;
fhir:div [ fhir:v "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: StructureMap PersonMap</b></p><a name=\"PersonMap\"> </a><a name=\"hcPersonMap\"> </a><pre class=\"fml\">#xD;\n<span style=\"color: #cc00cc\">/// <b>url</b> = </span><span style=\"color: blue\">'http://hl7.org/fhir/uv/omop/StructureMap/PersonMap'</span>#xD;\n<span style=\"color: #cc00cc\">/// <b>name</b> = </span><span style=\"color: blue\">'PersonMap'</span>#xD;\n<span style=\"color: #cc00cc\">/// <b>title</b> = </span><span style=\"color: blue\">'Mapping Patient resource to Person OMOP Domain'</span>#xD;\n<span style=\"color: #cc00cc\">/// <b>status</b> = </span><span style=\"color: blue\">'active'</span>#xD;\n<span style=\"color: #cc00cc\">/// <b>description</b> = </span><span style=\"color: blue\">'This mapping maps FHIR Patient instances to OMOP Person Table objects.'</span>#xD;\n#xD;\n<b>uses</b><span style=\"color: navy\"> \"</span><a href=\"http://hl7.org/fhir/R5/patient.html\" title=\"Patient\">http://hl7.org/fhir/StructureDefinition/Patient</a><span style=\"color: navy\">\" </span><b>alias </b>Patient <b>as </b><b>source</b>#xD;\n<b>uses</b><span style=\"color: navy\"> \"</span><a href=\"StructureDefinition-Person.html\" title=\"Person OMOP Table\">http://hl7.org/fhir/uv/omop/StructureDefinition/Person</a><span style=\"color: navy\">\" </span><b>alias </b>PersonTable <b>as </b><b>target</b>#xD;\n#xD;\n<b>group </b>Person<span style=\"color: navy\">(</span><b>source</b> <span style=\"color: maroon\">src</span><span style=\"color: navy\"> : </span>Patient, <b>target</b> <span style=\"color: maroon\">tgt</span><span style=\"color: navy\"> : </span>PersonTable<span style=\"color: navy\">)</span><span style=\"color: navy\"> {#xD;\n</span> <span style=\"color: navy\">// </span><span style=\"color: green\">OMOP person ID would be a map from FHIR ID to an external key</span>#xD;\n src<b> as </b><span style=\"color: maroon\">s</span><span style=\"color: navy\"><b> -> </b></span>tgt<b> then</b><span style=\"color: navy\"> {#xD;\n</span> s.id<b> as </b><span style=\"color: maroon\">id</span><span style=\"color: navy\"><b> -> </b></span> tgt.person_source_value<span style=\"color: navy\">, </span> tgt.person_id = <b>cast</b><span style=\"color: navy\">(</span><span style=\"color: maroon\">id</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'integer'</span><span style=\"color: navy\">)</span><span style=\"color: navy\">;</span>#xD;\n <span style=\"color: navy\">}</span> <i>\"personID\"</i><span style=\"color: navy\">;</span>#xD;\n src.gender<b> as </b><span style=\"color: maroon\">gender</span><span style=\"color: navy\"><b> -> </b></span> tgt.gender_concept_id = <b>translate</b><span style=\"color: navy\">(</span><span style=\"color: maroon\">gender</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'http://hl7.org/fhir/uv/omop/ConceptMap/GenderClass'</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'code'</span><span style=\"color: navy\">)</span><span style=\"color: navy\">, </span> tgt.gender_source_value = <span style=\"color: maroon\">gender</span><span style=\"color: navy\">;</span>#xD;\n src<b> where </b><span style=\"color: navy\">(</span>src.gender.empty()<span style=\"color: navy\">)</span><span style=\"color: navy\"><b> -> </b></span> tgt.gender_concept_id = <span style=\"color: blue\">0</span><span style=\"color: navy\">, </span> tgt.gender_source_value = <span style=\"color: blue\">'unknown'</span> <i>\"nogender\"</i><span style=\"color: navy\">;</span>#xD;\n src.birthDate<b> as </b><span style=\"color: maroon\">bdSrc</span><span style=\"color: navy\"><b> -> </b></span> tgt.birth_datetime = <b>cast</b><span style=\"color: navy\">(</span><span style=\"color: maroon\">bdSrc</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'dateTime'</span><span style=\"color: navy\">)</span><span style=\"color: navy\">, </span> tgt.year_of_birth = <span style=\"color: navy\">(</span>src.birthDate.toString().substring(0, 4)<span style=\"color: navy\">)</span><span style=\"color: navy\">, </span> tgt.month_of_birth = <span style=\"color: navy\">(</span>src.birthDate.toString().substring(5, 2)<span style=\"color: navy\">)</span><span style=\"color: navy\">, </span> tgt.day_of_birth = <span style=\"color: navy\">(</span>src.birthDate.toString().substring(8, 2)<span style=\"color: navy\">)</span><span style=\"color: navy\">;</span>#xD;\n<span style=\"color: navy\">}#xD;\n#xD;\n</span></pre></div>"^^rdf:XMLLiteral ]
] ; #
fhir:extension ( [
fhir:url [ fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg"^^xsd:anyURI ] ;
fhir:value [
a fhir:code ;
fhir:v "brr"
]
] [
fhir:url [ fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm"^^xsd:anyURI ] ;
fhir:value [
a fhir:integer ;
fhir:v 2 ;
fhir:extension ( [
fhir:url [ fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom"^^xsd:anyURI ] ;
fhir:value [
a fhir:canonical ;
fhir:v "http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop"^^xsd:anyURI ;
fhir:link <http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop>
]
] )
]
] [
fhir:url [ fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status"^^xsd:anyURI ] ;
fhir:value [
a fhir:code ;
fhir:v "trial-use" ;
fhir:extension ( [
fhir:url [ fhir:v "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom"^^xsd:anyURI ] ;
fhir:value [
a fhir:canonical ;
fhir:v "http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop"^^xsd:anyURI ;
fhir:link <http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop>
]
] )
]
] ) ; #
fhir:url [ fhir:v "http://hl7.org/fhir/uv/omop/StructureMap/PersonMap"^^xsd:anyURI] ; #
fhir:identifier ( [
fhir:system [ fhir:v "urn:ietf:rfc:3986"^^xsd:anyURI ] ;
fhir:value [ fhir:v "urn:oid:2.16.840.1.113883.4.642.40.77.43.8" ]
] ) ; #
fhir:version [ fhir:v "2.0.0-ballot"] ; #
fhir:name [ fhir:v "PersonMap"] ; #
fhir:title [ fhir:v "Mapping Patient resource to Person OMOP Domain"] ; #
fhir:status [ fhir:v "active"] ; #
fhir:date [ fhir:v "2026-08-14T16:09:20+00:00"^^xsd:dateTime] ; #
fhir:publisher [ fhir:v "HL7 International / Biomedical Research and Regulation"] ; #
fhir:contact ( [
fhir:name [ fhir:v "HL7 International / Biomedical Research and Regulation" ] ;
fhir:telecom ( [
fhir:system [ fhir:v "url" ] ;
fhir:value [ fhir:v "http://www.hl7.org/Special/committees/rcrim" ]
] )
] ) ; #
fhir:description [ fhir:v "This mapping maps FHIR Patient instances to OMOP Person Table objects."] ; #
fhir:jurisdiction ( [
fhir:coding ( [
fhir:system [ fhir:v "http://unstats.un.org/unsd/methods/m49/m49.htm"^^xsd:anyURI ] ;
fhir:code [ fhir:v "001" ] ;
fhir:display [ fhir:v "World" ]
] )
] ) ; #
fhir:structure ( [
fhir:url [
fhir:v "http://hl7.org/fhir/StructureDefinition/Patient"^^xsd:anyURI ;
fhir:link <http://hl7.org/fhir/StructureDefinition/Patient>
] ;
fhir:mode [ fhir:v "source" ] ;
fhir:alias [ fhir:v "Patient" ]
] [
fhir:url [
fhir:v "http://hl7.org/fhir/uv/omop/StructureDefinition/Person"^^xsd:anyURI ;
fhir:link <http://hl7.org/fhir/uv/omop/StructureDefinition/Person>
] ;
fhir:mode [ fhir:v "target" ] ;
fhir:alias [ fhir:v "PersonTable" ]
] ) ; #
fhir:group ( [
fhir:name [ fhir:v "Person" ] ;
fhir:input ( [
fhir:name [ fhir:v "src" ] ;
fhir:type [ fhir:v "Patient" ] ;
fhir:mode [ fhir:v "source" ]
] [
fhir:name [ fhir:v "tgt" ] ;
fhir:type [ fhir:v "PersonTable" ] ;
fhir:mode [ fhir:v "target" ]
] ) ;
fhir:rule ( [
fhir:name [ fhir:v "personID" ] ;
fhir:source ( [
fhir:context [ fhir:v "src" ] ;
fhir:variable [ fhir:v "s" ]
] ) ;
fhir:target ( [
fhir:context [ fhir:v "tgt" ]
] ) ;
fhir:rule ( [
fhir:name [ fhir:v "id" ] ;
fhir:source ( [
fhir:context [ fhir:v "s" ] ;
fhir:element [ fhir:v "id" ] ;
fhir:variable [ fhir:v "id" ]
] ) ;
fhir:target ( [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "person_source_value" ]
] [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "person_id" ] ;
fhir:transform [ fhir:v "cast" ] ;
fhir:parameter ( [
fhir:value [
a fhir:id ;
fhir:v "id"
]
] [
fhir:value [
a fhir:string ;
fhir:v "integer"
]
] )
] )
] ) ;
fhir:documentation [ fhir:v "OMOP person ID would be a map from FHIR ID to an external key" ]
] [
fhir:name [ fhir:v "gender" ] ;
fhir:source ( [
fhir:context [ fhir:v "src" ] ;
fhir:element [ fhir:v "gender" ] ;
fhir:variable [ fhir:v "gender" ]
] ) ;
fhir:target ( [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "gender_concept_id" ] ;
fhir:transform [ fhir:v "translate" ] ;
fhir:parameter ( [
fhir:value [
a fhir:id ;
fhir:v "gender"
]
] [
fhir:value [
a fhir:string ;
fhir:v "http://hl7.org/fhir/uv/omop/ConceptMap/GenderClass"
]
] [
fhir:value [
a fhir:string ;
fhir:v "code"
]
] )
] [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "gender_source_value" ] ;
fhir:transform [ fhir:v "copy" ] ;
fhir:parameter ( [
fhir:value [
a fhir:id ;
fhir:v "gender"
]
] )
] )
] [
fhir:name [ fhir:v "nogender" ] ;
fhir:source ( [
fhir:context [ fhir:v "src" ] ;
fhir:condition [ fhir:v "src.gender.empty()" ]
] ) ;
fhir:target ( [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "gender_concept_id" ] ;
fhir:transform [ fhir:v "copy" ] ;
fhir:parameter ( [
fhir:value [
a fhir:integer ;
fhir:v 0
]
] )
] [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "gender_source_value" ] ;
fhir:transform [ fhir:v "copy" ] ;
fhir:parameter ( [
fhir:value [
a fhir:string ;
fhir:v "unknown"
]
] )
] )
] [
fhir:name [ fhir:v "birthDate" ] ;
fhir:source ( [
fhir:context [ fhir:v "src" ] ;
fhir:element [ fhir:v "birthDate" ] ;
fhir:variable [ fhir:v "bdSrc" ]
] ) ;
fhir:target ( [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "birth_datetime" ] ;
fhir:transform [ fhir:v "cast" ] ;
fhir:parameter ( [
fhir:value [
a fhir:id ;
fhir:v "bdSrc"
]
] [
fhir:value [
a fhir:string ;
fhir:v "dateTime"
]
] )
] [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "year_of_birth" ] ;
fhir:transform [ fhir:v "evaluate" ] ;
fhir:parameter ( [
fhir:value [
a fhir:string ;
fhir:v "src.birthDate.toString().substring(0, 4)"
]
] )
] [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "month_of_birth" ] ;
fhir:transform [ fhir:v "evaluate" ] ;
fhir:parameter ( [
fhir:value [
a fhir:string ;
fhir:v "src.birthDate.toString().substring(5, 2)"
]
] )
] [
fhir:context [ fhir:v "tgt" ] ;
fhir:element [ fhir:v "day_of_birth" ] ;
fhir:transform [ fhir:v "evaluate" ] ;
fhir:parameter ( [
fhir:value [
a fhir:string ;
fhir:v "src.birthDate.toString().substring(8, 2)"
]
] )
] )
] )
] ) . #
IG © 2023+ HL7 International / Biomedical Research and Regulation.
Package hl7.fhir.uv.omop#2.0.0-ballot based on FHIR 5.0.0.
Generated
2026-08-14
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change