OpenMRS Core FHIR Implementation Guide
0.1.0 - ci-build

OpenMRS Core FHIR Implementation Guide, published by . This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/abertnamanya/openmrs-contrib-fhir2-ig/ and changes regularly. See the Directory of published versions

Resource Profile: OpenMRSObservation - Mappings

Active as of 2024-12-11

Mappings for the OpenMRS-observation resource profile.

Mappings for FHIR HL7 vs OMRS FHIR2 (Observation)

Observation is a FHIR resource that is used to support diagnosis, monitor progress, determine baselines and patterns and even capture demographic characteristics. As such, Observations have a wide range of uses and show up in a wide range of places. FHIR Observations are mapped to OpenMRS Obs objects.

OpenMRSObservation
Observation
   idobs.uuid
   basedOnObs.order
   statusObs.status
   categoryObs.concept
   codeObs.concept
   subjectObs.person
   encounterObs.encounter
   value[x]Obs.value
   interpretationObs.interpretation

Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

OpenMRSObservation
ObservationEvent
   identifierEvent.identifier
   basedOnEvent.basedOn
   partOfEvent.partOf
   statusEvent.status
   codeEvent.code
   subjectEvent.subject
   encounterEvent.context

Mappings for SNOMED CT Concept Domain Binding (http://snomed.info/conceptdomain)

OpenMRSObservation
Observation< 363787002 |Observable entity|
   status< 445584004 |Report by finality status|
   code< 363787002 |Observable entity| OR < 386053000 |Evaluation procedure|
   value[x]< 441742003 |Evaluation finding|
   interpretation< 260245000 |Findings values|
   referenceRange
      type< 260245000 |Findings values| OR < 365860008 |General clinical state finding| OR < 250171008 |Clinical history or observation findings| OR < 415229000 |Racial group| OR < 365400002 |Finding of puberty stage| OR < 443938003 |Procedure carried out on subject|

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

OpenMRSObservation
ObservationOBX
   identifierOBX.21 For OBX segments from systems without OBX-21 support a combination of ORC/OBR and OBX must be negotiated between trading partners to uniquely identify the OBX segment. Depending on how V2 has been implemented each of these may be an option: 1) OBR-3 + OBX-3 + OBX-4 or 2) OBR-3 + OBR-4 + OBX-3 + OBX-4 or 2) some other way to uniquely ID the OBR/ORC + OBX-3 + OBX-4.
   basedOnORC
   partOfVaries by domain
   statusOBX-11
   codeOBX-3
   subjectPID-3
   focusOBX-3
   encounterPV1
   value[x]OBX.2, OBX.5, OBX.6
   interpretationOBX-8
   noteNTE.3 (partner NTE to OBX, or sometimes another (child?) OBX)
   referenceRangeOBX.7
      lowOBX-7
      highOBX-7
      typeOBX-10
   hasMemberRelationships established by OBX-4 usage
   derivedFromRelationships established by OBX-4 usage

Mappings for RIM Mapping (http://hl7.org/v3)

OpenMRSObservation
ObservationEntity. Role, or Act, Observation[classCode=OBS, moodCode=EVN]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifierid
   basedOn.inboundRelationship[typeCode=COMP].source[moodCode=EVN]
   partOf.outboundRelationship[typeCode=FLFS].target
   statusstatus Amended & Final are differentiated by whether it is the subject of a ControlAct event with a type of "revise"
   category.outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="EVN"].code
   codecode
   subjectparticipation[typeCode=RTGT]
   focusparticipation[typeCode=SBJ]
   encounterinboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN]
   value[x]value
   interpretationinterpretationCode
   notesubjectOf.observationEvent[code="annotation"].value
   referenceRangeoutboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN]
      idn/a
      extensionn/a
      lowvalue:IVL_PQ.low
      highvalue:IVL_PQ.high
      typeinterpretationCode
   hasMemberoutBoundRelationship
   derivedFrom.targetObservation

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

OpenMRSObservation
Observation
   identifierFiveWs.identifier
   statusFiveWs.status
   categoryFiveWs.class
   codeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   focusFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context

Mappings for SNOMED CT Attribute Binding (http://snomed.org/attributebinding)

OpenMRSObservation
Observation
   code116680003 |Is a|
   value[x]363714003 |Interprets|
   interpretation363713009 |Has interpretation|