FHIR to OMOP FHIR IG
1.0.0 - INFORMATIVE 1 International flag

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 1.0.0 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

: Mapping Allergy resource to Observation OMOP Domain

Page standards status: Informative Maturity Level: 1

Raw json | Download

{
  "resourceType" : "StructureMap",
  "id" : "AllergyMap",
  "language" : "en",
  "text" : {
    "status" : "generated",
    "div" : "<div xml:lang=\"en\" xmlns=\"http://www.w3.org/1999/xhtml\" lang=\"en\"><p class=\"res-header-id\"><b>Generated Narrative: StructureMap AllergyMap</b></p><a name=\"AllergyMap\"> </a><a name=\"hcAllergyMap\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\">Language: en</p></div><pre class=\"fml\">\r\n<span style=\"color: #cc00cc\">/// <b>url</b> = </span><span style=\"color: blue\">'http://hl7.org/fhir/uv/omop/StructureMap/AllergyMap'</span>\r\n<span style=\"color: #cc00cc\">/// <b>name</b> = </span><span style=\"color: blue\">'AllergyMap'</span>\r\n<span style=\"color: #cc00cc\">/// <b>title</b> = </span><span style=\"color: blue\">'Mapping Allergy resource to Observation OMOP Domain'</span>\r\n<span style=\"color: #cc00cc\">/// <b>status</b> = </span><span style=\"color: blue\">'draft'</span>\r\n\r\n<b>uses</b><span style=\"color: navy\"> &quot;</span><a href=\"http://hl7.org/fhir/R5/allergyintolerance.html\" title=\"AllergyIntolerance\">http://hl7.org/fhir/StructureDefinition/AllergyIntolerance</a><span style=\"color: navy\">&quot; </span><b>alias </b>Allergy <b>as </b><b>source</b>\r\n<b>uses</b><span style=\"color: navy\"> &quot;</span><a href=\"StructureDefinition-Observation.html\" title=\"Observation OMOP Table\">http://hl7.org/fhir/uv/omop/StructureDefinition/Observation</a><span style=\"color: navy\">&quot; </span><b>alias </b>ObservationTable <b>as </b><b>target</b>\r\n\r\n<b>group </b>Observation<span style=\"color: navy\">(</span><b>source</b> <span style=\"color: maroon\">src</span><span style=\"color: navy\"> : </span>Allergy, <b>target</b> <span style=\"color: maroon\">tgt</span><span style=\"color: navy\"> : </span>ObservationTable<span style=\"color: navy\">)</span><span style=\"color: navy\"> {\r\n</span>  src.id<span style=\"color: navy\"><b> -&gt; </b></span>tgt.observation_id = <span style=\"color: blue\">'1'</span><span style=\"color: navy\">;</span> <span style=\"color: navy\">// </span><span style=\"color: green\">OMOP Observation ID would be a map from FHIR ID to an external key</span>\r\n  src.patient<span style=\"color: navy\"><b> -&gt; </b></span>tgt.person_id = <span style=\"color: blue\">'1'</span><span style=\"color: navy\">;</span> <span style=\"color: navy\">// </span><span style=\"color: green\">OMOP Person ID would be a map from the FHIR Allergy Patient reference to an external key</span>\r\n  src.encounter<span style=\"color: navy\"><b> -&gt; </b></span>tgt.visit_occurrence_id = <span style=\"color: blue\">'1'</span><span style=\"color: navy\">;</span> <span style=\"color: navy\">// </span><span style=\"color: green\">OMOP Visit Occurrence ID would be a map from the FHIR Allergy Encounter reference to an external key</span>\r\n  src.type<b> as </b><span style=\"color: maroon\">s</span><span style=\"color: navy\"><b> -&gt; </b></span><span style=\"color: maroon\">tgt</span><b> then</b><span style=\"color: navy\"> {\r\n</span>    s.coding<b> as </b><span style=\"color: maroon\">sc</span><span style=\"color: navy\"><b> -&gt; </b></span><span style=\"color: maroon\">tgt</span><b> then</b><span style=\"color: navy\"> {\r\n</span>      sc.code<b> as </b><span style=\"color: maroon\">code</span><b> where </b>(code = 'allergy')<b> then</b><span style=\"color: navy\"> {\r\n</span>        src.category<b> as </b><span style=\"color: maroon\">category</span><span style=\"color: navy\"><b> -&gt; </b></span>tgt.observation_concept_id = <b>translate</b><span style=\"color: navy\">(</span><span style=\"color: maroon\">category</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'http://hl7.org/fhir/uv/omop/ConceptMap/AllergyType'</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'code'</span><span style=\"color: navy\">)</span><span style=\"color: navy\">;</span>\r\n      <span style=\"color: navy\">}</span><span style=\"color: navy\">;</span>\r\n      src.code<b> as </b><span style=\"color: maroon\">code</span><b> where </b>(code = 'intolerance')<b> then</b><span style=\"color: navy\"> {\r\n</span>        src.category<b> as </b><span style=\"color: maroon\">category</span><span style=\"color: navy\"><b> -&gt; </b></span>tgt.observation_concept_id = <b>translate</b><span style=\"color: navy\">(</span><span style=\"color: maroon\">category</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'http://hl7.org/fhir/uv/omop/ConceptMap/IntoleranceType'</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'code'</span><span style=\"color: navy\">)</span><span style=\"color: navy\">;</span>\r\n      <span style=\"color: navy\">}</span><span style=\"color: navy\">;</span>\r\n    <span style=\"color: navy\">}</span><span style=\"color: navy\">;</span>\r\n  <span style=\"color: navy\">}</span><span style=\"color: navy\">;</span>\r\n  src.code<b> as </b><span style=\"color: maroon\">s</span><span style=\"color: navy\"><b> -&gt; </b></span><span style=\"color: maroon\">tgt</span><b> then</b><span style=\"color: navy\"> {\r\n</span>    s.coding<b> as </b><span style=\"color: maroon\">sc</span><span style=\"color: navy\"><b> -&gt; </b></span><span style=\"color: maroon\">tgt</span><b> then</b><span style=\"color: navy\"> {\r\n</span>      sc.code<b> as </b><span style=\"color: maroon\">code</span><span style=\"color: navy\"><b> -&gt; </b></span> tgt.value_as_concept_id = <b>translate</b><span style=\"color: navy\">(</span><span style=\"color: maroon\">code</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'http://hl7.org/fhir/uv/omop/ConceptMap/AllergySubstanceType'</span><span style=\"color: navy\">, </span><span style=\"color: blue\">'code'</span><span style=\"color: navy\">)</span><span style=\"color: navy\">, </span> tgt.value_source_value = <span style=\"color: maroon\">code</span><span style=\"color: navy\">;</span>\r\n    <span style=\"color: navy\">}</span><span style=\"color: navy\">;</span>\r\n  <span style=\"color: navy\">}</span><span style=\"color: navy\">;</span>\r\n  src.recordedDate<span style=\"color: navy\"> : </span>dateTime<b> as </b><span style=\"color: maroon\">osd</span><span style=\"color: navy\"><b> -&gt; </b></span> tgt.observation_date = <span style=\"color: navy\">(</span>src.recordedDate.toString().substring(0, 10)<span style=\"color: navy\">)</span><span style=\"color: navy\">, </span> tgt.observation_datetime = <span style=\"color: maroon\">osd</span><span style=\"color: navy\">;</span>\r\n<span style=\"color: navy\">}\r\n\r\n</span></pre></div>"
  },
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode" : "brr"
    },
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger" : 1,
      "_valueInteger" : {
        "extension" : [
          {
            "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical" : "http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop"
          }
        ]
      }
    },
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode" : "informative",
      "_valueCode" : {
        "extension" : [
          {
            "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical" : "http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop"
          }
        ]
      }
    }
  ],
  "url" : "http://hl7.org/fhir/uv/omop/StructureMap/AllergyMap",
  "version" : "1.0.0",
  "name" : "AllergyMap",
  "title" : "Mapping Allergy resource to Observation OMOP Domain",
  "status" : "draft",
  "date" : "2026-04-02T22:51:15+00:00",
  "publisher" : "HL7 International / Biomedical Research and Regulation",
  "contact" : [
    {
      "name" : "HL7 International / Biomedical Research and Regulation",
      "telecom" : [
        {
          "system" : "url",
          "value" : "http://www.hl7.org/Special/committees/rcrim"
        }
      ]
    }
  ],
  "description" : "This mapping maps FHIR AllergyIntolerance instances to OMOP Observation Table objects.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code" : "001",
          "display" : "World"
        }
      ]
    }
  ],
  "structure" : [
    {
      "url" : "http://hl7.org/fhir/StructureDefinition/AllergyIntolerance",
      "mode" : "source",
      "alias" : "Allergy"
    },
    {
      "url" : "http://hl7.org/fhir/uv/omop/StructureDefinition/Observation",
      "mode" : "target",
      "alias" : "ObservationTable"
    }
  ],
  "group" : [
    {
      "name" : "Observation",
      "input" : [
        {
          "name" : "src",
          "type" : "Allergy",
          "mode" : "source"
        },
        {
          "name" : "tgt",
          "type" : "ObservationTable",
          "mode" : "target"
        }
      ],
      "rule" : [
        {
          "name" : "id",
          "source" : [
            {
              "context" : "src",
              "element" : "id"
            }
          ],
          "target" : [
            {
              "context" : "tgt",
              "element" : "observation_id",
              "transform" : "copy",
              "parameter" : [
                {
                  "valueString" : "1"
                }
              ]
            }
          ],
          "documentation" : "OMOP Observation ID would be a map from FHIR ID to an external key"
        },
        {
          "name" : "patient",
          "source" : [
            {
              "context" : "src",
              "element" : "patient"
            }
          ],
          "target" : [
            {
              "context" : "tgt",
              "element" : "person_id",
              "transform" : "copy",
              "parameter" : [
                {
                  "valueString" : "1"
                }
              ]
            }
          ],
          "documentation" : "OMOP Person ID would be a map from the FHIR Allergy Patient reference to an external key"
        },
        {
          "name" : "encounter",
          "source" : [
            {
              "context" : "src",
              "element" : "encounter"
            }
          ],
          "target" : [
            {
              "context" : "tgt",
              "element" : "visit_occurrence_id",
              "transform" : "copy",
              "parameter" : [
                {
                  "valueString" : "1"
                }
              ]
            }
          ],
          "documentation" : "OMOP Visit Occurrence ID would be a map from the FHIR Allergy Encounter reference to an external key"
        },
        {
          "name" : "type",
          "source" : [
            {
              "context" : "src",
              "element" : "type",
              "variable" : "s"
            }
          ],
          "target" : [
            {
              "transform" : "copy",
              "parameter" : [
                {
                  "valueId" : "tgt"
                }
              ]
            }
          ],
          "rule" : [
            {
              "name" : "coding",
              "source" : [
                {
                  "context" : "s",
                  "element" : "coding",
                  "variable" : "sc"
                }
              ],
              "target" : [
                {
                  "transform" : "copy",
                  "parameter" : [
                    {
                      "valueId" : "tgt"
                    }
                  ]
                }
              ],
              "rule" : [
                {
                  "name" : "code",
                  "source" : [
                    {
                      "context" : "sc",
                      "element" : "code",
                      "variable" : "code",
                      "condition" : "(code = 'allergy')"
                    }
                  ],
                  "rule" : [
                    {
                      "name" : "category",
                      "source" : [
                        {
                          "context" : "src",
                          "element" : "category",
                          "variable" : "category"
                        }
                      ],
                      "target" : [
                        {
                          "context" : "tgt",
                          "element" : "observation_concept_id",
                          "transform" : "translate",
                          "parameter" : [
                            {
                              "valueId" : "category"
                            },
                            {
                              "valueString" : "http://hl7.org/fhir/uv/omop/ConceptMap/AllergyType"
                            },
                            {
                              "valueString" : "code"
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "name" : "code",
                  "source" : [
                    {
                      "context" : "src",
                      "element" : "code",
                      "variable" : "code",
                      "condition" : "(code = 'intolerance')"
                    }
                  ],
                  "rule" : [
                    {
                      "name" : "category",
                      "source" : [
                        {
                          "context" : "src",
                          "element" : "category",
                          "variable" : "category"
                        }
                      ],
                      "target" : [
                        {
                          "context" : "tgt",
                          "element" : "observation_concept_id",
                          "transform" : "translate",
                          "parameter" : [
                            {
                              "valueId" : "category"
                            },
                            {
                              "valueString" : "http://hl7.org/fhir/uv/omop/ConceptMap/IntoleranceType"
                            },
                            {
                              "valueString" : "code"
                            }
                          ]
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "name" : "code",
          "source" : [
            {
              "context" : "src",
              "element" : "code",
              "variable" : "s"
            }
          ],
          "target" : [
            {
              "transform" : "copy",
              "parameter" : [
                {
                  "valueId" : "tgt"
                }
              ]
            }
          ],
          "rule" : [
            {
              "name" : "coding",
              "source" : [
                {
                  "context" : "s",
                  "element" : "coding",
                  "variable" : "sc"
                }
              ],
              "target" : [
                {
                  "transform" : "copy",
                  "parameter" : [
                    {
                      "valueId" : "tgt"
                    }
                  ]
                }
              ],
              "rule" : [
                {
                  "name" : "code",
                  "source" : [
                    {
                      "context" : "sc",
                      "element" : "code",
                      "variable" : "code"
                    }
                  ],
                  "target" : [
                    {
                      "context" : "tgt",
                      "element" : "value_as_concept_id",
                      "transform" : "translate",
                      "parameter" : [
                        {
                          "valueId" : "code"
                        },
                        {
                          "valueString" : "http://hl7.org/fhir/uv/omop/ConceptMap/AllergySubstanceType"
                        },
                        {
                          "valueString" : "code"
                        }
                      ]
                    },
                    {
                      "context" : "tgt",
                      "element" : "value_source_value",
                      "transform" : "copy",
                      "parameter" : [
                        {
                          "valueId" : "code"
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "name" : "recordedDateDateTime",
          "source" : [
            {
              "context" : "src",
              "type" : "dateTime",
              "element" : "recordedDate",
              "variable" : "osd"
            }
          ],
          "target" : [
            {
              "context" : "tgt",
              "element" : "observation_date",
              "transform" : "evaluate",
              "parameter" : [
                {
                  "valueString" : "src.recordedDate.toString().substring(0, 10)"
                }
              ]
            },
            {
              "context" : "tgt",
              "element" : "observation_datetime",
              "transform" : "copy",
              "parameter" : [
                {
                  "valueId" : "osd"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}