HL7 Version 2 to FHIR
1.0.0-ballot - ballot
HL7 Version 2 to FHIR
1.0.0-ballot - ballot
HL7 Version 2 to FHIR, published by HL7 International / Orders and Observations. This guide is not an authorized publication; it is the continuous build for version 1.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/v2-to-fhir/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/uv/v2mappings/segment-obx-component-to-observation | Version: 1.0.0-ballot | |||
| Active as of 2024-04-24 | Computable Name: SegmentOBXComponentToObservation | |||
Copyright/Legal: Copyright (c) 2020, HL7 International, Inc., All Rights Reserved. |
||||
This ConceptMap represents a mapping from the HL7 V2 Segment OBX to the FHIR Observation Resource.
This ConceptMap represents the mapping from the HL7 V2 OBX Segment to the FHIR Observation Resource. See also the FHIR Shorthand or the CSV Source.
| HL7 v2 | Condition (IF True, args) | HL7 FHIR | Comments | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Sort Order | Identifier | Name | Data Type | Cardinality - Min | Cardinality - Max | Computable ANTLR | Computable FHIRPath | Narrative | FHIR Attribute | Extension | Data Type | Cardinality - Min | Cardinality - Max | Data Type Mapping | Vocabulary Mapping (IS, ID, CE, CEN, CWE) | Assignment | |
| 1 | OBX-1 | Set ID – OBX | SI | 0 | 1 | ||||||||||||
| 2 | OBX-2 | Value Type | ID | 0 | 1 | ValueType | OBX-2 determines the flavor of Observation.value[x] is used in OBX-5 | ||||||||||
| 3 | OBX-3 | Observation Identifier | CWE | 1 | 1 | Observation.code | Observation.CodeableConcept | 1 | 1 | CWE[CodeableConcept] | |||||||
| 3 | OBX-3 | Observation Identifier | CWE | 1 | 1 | Observation.component.code | Observation.CodeableConcept | 1 | 1 | CWE[CodeableConcept] | |||||||
| 4 | OBX-4 | Observation Sub-ID | ST | 0 | 1 | Map to Observation.partOf or Observation.hasMember or Observation.DerivedFrom according to the implementation guidance for the v2 message at hand, otherwise map to the extension-sub-id to enable the final destination to determine how to structure the observations. | Observation.$this | OG[Extension-Subidentifier] | OBX-4 Sub Identifier would determine how to use Observation.partOf or Observation.hasMember or Observation.DerivedFrom, but is highly dependent on the local implementation of OBX-4 or an implementation guide (e.g., LRI, Clinical Genomics). That is not known at the standard level, so we cannot provide specific mapping guidance here. However, if the mapper does not have access to the syntax used and its meaning, we need to be able to pass on OBX-4 Sub Identifier to the final destination that should know how to then structure it using FHIR attributes. | ||||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "NM" | Observation.component.valueQuantity | Observation.quantity | 0 | 1 | NM[Quantity] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 IN ("ST", "FT", "TX") | Any markup in ST, FT or TX data may not present properly given that valueString is a string data type | Observation.component.valueString | Observation.string | 0 | 1 | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "CF" | Observation.component.valueCodeableConcept | Observation.CodeableConcept | 0 | 1 | CF[CodeableConcept] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "CNE" | Observation.component.valueCodeableConcept | Observation.CodeableConcept | 0 | 1 | CNE[CodeableConcept] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "CE" | Observation.component.valueCodeableConcept | Observation.CodeableConcept | 0 | 1 | CE[CodeableConcept] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "CWE" | Observation.component.valueCodeableConcept | Observation.CodeableConcept | 0 | 1 | CWE[CodeableConcept] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "IS" | Observation.component.valueCodeableConcept | Observation.CodeableConcept | 0 | 1 | IS[CodeableConcept] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "DR" | Observation.component.valuePeriod | Observation.Period | 0 | 1 | DR[Period] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 IN ("DTM", "DT") | Observation.component.valueDateTime | Observation.dateTime | 0 | 1 | |||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "NR" | Observation.component.valueRange | Observation.Range | 0 | 1 | NR[Range] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "VR" | Observation.component.valueString | Observation.string | 0 | 1 | OBX-5.1+"-"+OBX-5.2 | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "TM" | Observation.component.valueTime | Observation.time | 0 | 1 | |||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF (OBX-2 EQUALS "SN" AND OBX-5.3 IN (":", "/") | Observation.component.valueRatio | Observation.Ratio | 0 | 1 | SN[Ratio] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "SN" and OBX-5.3 EQUALS "-" | Observation.component.valueRange | Observation.Range | 0 | 1 | SN[Range] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "SN" and OBX-5.3 EQUALS "+" | Observation.component.valueString | Observation.string | 0 | 1 | OBX-5.1+""+OBX-5.2+""+OBX-5.3+""+OBX-5.4 | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "SN" and OBX-5.3 NOT IN (":", "/", "-", "+") | Observation.component.valueQuantity | Observation.Quantity | 0 | 1 | SN[Quantity] | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "NA" | Observation.component.valueSampledData | Observation.SampledData | 0 | 1 | Need to add text on converting from NA to SampledData | ||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "ED" AND IF OBX-5.4 EQUALS "Base64" | If none of the other observations in OBX-5 are not derived from the documentation included | Observation.component.extension.url | Observation.uri | 1 | 1 | "https://hl7.org/fhir/R5/StructureDefinition/extension-Observation.valueAttachment | Some implementers may include in OBX-5 the documentation that the other OBX-5 components are derived from. In that situations | ||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "ED" AND IF OBX-5.4 EQUALS "Base64" | If none of the other observations in OBX-5 are not derived from the documentation included | Observation.component.extension.valueAttachment | Observation.Attachment | 1 | 1 | ED[Attachment] | We are for now addressing Base64 that cover .pdf, pictures and other binaries. If somebody does this, we will address those. | ||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "ED" AND IF OBX-5.4 EQUALS "Base64" | And if other observation in OBX-5 are derived from the documentation included | Observation.derivedFrom(Observation.DocumentReference) | Reference | ED[DocumentReference] | |||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "EI" | Requires more work to properly map. Use case: An OBX under OBR that points to the calibration/quality control/etc. settings/values/result/etc. that the other OBX-s under the OBR would be "subject" to. | ||||||||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "RP" | If none of the other observations in OBX-5 are not derived from the documentation referenced | Observation.component.extension.url | Observation.uri | 1 | 1 | "https://hl7.org/fhir/R5/StructureDefinition/extension-Observation.valueAttachment | |||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "RP" | If none of the other observations in OBX-5 are not derived from the documentation referenced | Observation.component.extension.valueAttachment | Observation.Attachment | 1 | 1 | RP[Attachment] | To be resolved when we resolve DocumentReference and valueAttachment | ||||
| 5 | OBX-5 | Observation Value | varies | 0 | -1 | IF OBX-2 EQUALS "RP" | And if other observation in OBX-5 are derived from the documentation being referenced | Observation.derivedFrom(Observation.DocumentReference) | Reference | RP[DocumentReference] | |||||||
| 6 | OBX-6 | Units | CWE | 0 | 1 | IF OBX-2 EQUALS "SN" and OBX-5.3 NOT IN (":", "/", "-", "+") | Observation.component.valueQuantity | Observation.Quantity | CWE[Quantity] | ||||||||
| 6 | OBX-6 | Units | CWE | 0 | 1 | IF OBX-2 IN ("NA", "NM") | Observation.component.valueQuantity | Observation.Quantity | CWE[Quantity] | ||||||||
| 6 | OBX-6 | Units | CWE | 0 | 1 | IF OBX-2 EQUALS "SN" AND OBX-5.3 EQUALS "-" | Observation.component.valueRange.low | Observation.SimpleQuantity | CWE[Quantity] | ||||||||
| 6 | OBX-6 | Units | CWE | 0 | 1 | IF OBX-2 EQUALS "SN" AND OBX-5.3 EQUALS "-" | Observation.component.valueRange.high | Observation.SimpleQuantity | CWE[Quantity] | ||||||||
| 6 | OBX-6 | Units | CWE | 0 | 1 | IF (OBX-2 EQUALS "SN" AND (OBX-5.3 IN (":", "/")) | Observation.component.valueRatio.numerator | Observation.Quantity | CWE[Quantity] | ||||||||
| 6 | OBX-6 | Units | CWE | 0 | 1 | IF (OBX-2 EQUALS "SN" AND (OBX-5.3 IN (":", "/")) | Observation.component.valueRatio.denominator | Observation.Quantity | CWE[Quantity] | ||||||||
| 7 | OBX-7 | References Range | ST | 0 | 1 | Observation.component.referenceRange.text | If OBX-7 is sufficiently parseable, then the low, high, type, appliesTo, and/or age may be used. | ||||||||||
| 8 | OBX-8 | Interpretation Codes | CWE | 0 | -1 | Observation.interpretation | Observation.CodeableConcept | 0 | -1 | CWE[CodeableConcept] | InterpretationCode | ||||||
| 9 | OBX-9 | Probability | NM | 0 | 1 | ||||||||||||
| 10 | OBX-10 | Nature of Abnormal Test | ID | 0 | -1 | Observation.extension.uri | Observation.uri | 0 | -1 | "http://hl7.org/fhir/StructureDefinition/observation-nature-of-abnormal-test" | |||||||
| 10 | OBX-10 | Nature of Abnormal Test | ID | 0 | -1 | Observation.extension.valueCodeableConcept | Observation.CodeableConcept | 0 | -1 | CWE[CodeableConcept] | NatureOfAbnormalTesting | ||||||
| 11 | OBX-11 | Observation Result Status | ID | 1 | 1 | Observation.status | Observation.code | 1 | 1 | ObservationStatus | |||||||
| 12 | OBX-12 | Effective Date of Reference Range | DTM | 0 | 1 | ||||||||||||
| 13 | OBX-13 | User Defined Access Checks | ST | 0 | 1 | ||||||||||||
| 14 | OBX-14 | Date/Time of the Observation | DTM | 0 | 1 | Observation.effectiveDateTime | Observation.dateTime | 0 | 1 | ||||||||
| 15 | OBX-15 | Producer's ID | CWE | 0 | 1 | extension??-producerIdentifier | Observation.identifier | 0 | 1 | CWE[Identifier] | |||||||
| 16 | OBX-16 | Responsible Observer | XCN | 0 | -1 | Observation.performer(Observation.PractitionerRole.practitioner(Observation.Practitioner) | Reference(Observation.PractitionerRole) | 0 | -1 | XCN[PractitionerRole] | |||||||
| 16 | OBX-16 | Responsible Observer | XCN | 0 | -1 | Observation.performer(Observation.PractitionerRole.code.coding.code) | Observation.string | 0 | -1 | "responsibleObserver" | |||||||
| 16 | OBX-16 | Responsible Observer | XCN | 0 | -1 | Observation.performer(Observation.PractitionerRole.code.coding.system) | Observation.uri | "http://terminology.hl7.org/CodeSystem/practitioner-role" | |||||||||
| 17 | OBX-17 | Observation Method | CWE | 0 | -1 | Observation.method | Observation.CodeableConcept | 0 | 1 | CWE[CodeableConcept] | The cardinality of Observation.method is 0..1 while the source allows for multiple methods. As we are not aware of anybody populating multiples in HL7 v2, we did not provide further mapping guidance. If you need to support multiples, please submit a gForge to OO for the HL7 v2 to FHIR mapping Implementation Guide. | ||||||
| 18 | OBX-18 | Equipment Instance Identifier | EI | 0 | -1 | Observation.device(Observation.Device.identifier) | Observation.Identifier | 0 | -1 | EI[Identifier-Extension] | |||||||
| 19 | OBX-19 | Date/Time of the Analysis | DTM | 0 | 1 | Observation.extension.url | Observation.uri | 0 | 1 | "http://hl7.org/fhir/StructureDefinition/observation-analysis-date-time" | |||||||
| 19 | OBX-19 | Date/Time of the Analysis | DTM | 0 | 1 | Observation.extension.valueDateTime | Observation.dateTime | 0 | 1 | ||||||||
| 20 | OBX-20 | Observation Site | CWE | 0 | -1 | Observation.bodySite | Observation.CodeableConcept | 0 | 1 | CWE[CodeableConcept] | The cardinality of Observation.bodySite is 0..1 while the source allows for multiple body sites. As we are not aware of anybody populating multiples in HL7 v2, we did not provide further mapping guidance. If you need to support multiples, please submit a gForge to OO for the HL7 v2 to FHIR mapping Implementation Guide. | ||||||
| 21 | OBX-21 | Observation Instance Identifier | EI | 0 | 1 | Observation.identifier | Observation.Identifier | 0 | -1 | EI[Identifier-Extension] | |||||||
| 21 | OBX-21 | Observation Instance Identifier | EI | 0 | 1 | Observation.identifier.type.coding.code | Observation.code | 0 | 1 | "FILL" | |||||||
| 22 | OBX-22 | Mood Code | CNE | 0 | 1 | ||||||||||||
| 23 | OBX-23 | Performing Organization Name | XON | 0 | 1 | Observation.performer(Observation.Organization) | Reference(Observation.Organization) | 0 | -1 | XON[Organization] | |||||||
| 23 | OBX-23 | Performing Organization Name | XON | 0 | 1 | IF OBX-25 VALUED | Observation.performer(Observation.PractitionerRole.organization(Observation.Organization) | Reference(Observation.Organization) | 0 | -1 | XON[Organization] | ||||||
| 24 | OBX-24 | Performing Organization Address | XAD | 0 | 1 | Observation.performer(Observation.Organization.address) | Observation.Address | 0 | -1 | XAD[Address] | |||||||
| 24 | OBX-24 | Performing Organization Address | XAD | 0 | 1 | IF OBX-25 VALUED | Observation.performer(Observation.PractitionerRole.organization(Observation.Organization.address) | Observation.Address | 0 | -1 | XAD[Address] | ||||||
| 25 | OBX-25 | Performing Organization Medical Director | XCN | 0 | 1 | Observation.performer(Observation.PractitionerRole) | Reference(Observation.PractitionerRole) | 0 | 1 | XCN[PractitionerRole] | |||||||
| 25 | OBX-25 | Performing Organization Medical Director | XCN | 0 | 1 | Observation.performer(Observation.PractitionerRole.code.coding.value) | Observation.string | "MDIR" | |||||||||
| 25 | OBX-25 | Performing Organization Medical Director | XCN | 0 | 1 | Observation.performer(Observation.PractitionerRole.code.coding.system) | Observation.uri | "http://terminology.hl7.org/CodeSystem/v2-0912" | |||||||||
| 26 | OBX-26 | Patient Results Release Category | ID | 0 | 1 | ||||||||||||
| 27 | OBX-27 | Root Cause | CWE | 0 | 1 | ||||||||||||
| 28 | OBX-28 | Local Process Control | CWE | 0 | -1 | ||||||||||||
| 29 | OBX-29 | Observation Type | ID | 0 | 1 | extension??-type | Observation.code | 0 | 1 | ||||||||
| 30 | OBX-30 | Observation Sub-Type | ID | 0 | 1 | extension??-subType | Observation.code | 0 | 1 | ||||||||
| 31 | OBX-31 | Action Code | ID | 0 | 1 | ||||||||||||
| 32 | OBX-32 | Observation Value Absent Reason | CWE | 0 | -1 | ||||||||||||
| 33 | OBX-33 | Observation Related Specimen Identifier | EIP | 0 | -1 | IF OBX-33 COUNT>1 | Observation.extension.uri | Reference | 0 | 1 | "http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.specimen | Note that in v2 messages the observations that a calculated observation is derived from on and involve multiple specimens are typically not included with the message. To enable relating the calculated observation to the correct specimens it relates to, the v2 message should include the originating observations that in turn use OBX-33 to link to the correct specimens. Without that, and if there are multiple specimens in OBX-33, there is no standard method to correctly associate the observation with the correct specimens. The implementer will have to devise an appropriate method for that in their context. | |||||
| 33 | OBX-33 | Observation Related Specimen Identifier | EIP | 0 | -1 | IF OBX-33 COUNT>1 | Observation.extension.valueReference(Observation.Group.member.entity(Observation.Specimen.identifier) | 0 | 1 | ||||||||
| 33 | OBX-33 | Observation Related Specimen Identifier | EIP | 0 | -1 | IF OBX-33 COUNT>1 | Observation.extension.uri | 0 | 1 | "http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.specimen | |||||||
| 33 | OBX-33 | Observation Related Specimen Identifier | EIP | 0 | -1 | IF OBX-33 COUNT>1 | Observation.extension.valueReference(Observation.Group.member.entity(Observation.Specimen.identifier) | 0 | 1 | ||||||||
| 33 | OBX-33 | Observation Related Specimen Identifier | EIP | 0 | -1 | IF OBX-33 COUNT=1 | Observation.specimen(Observation.Specimen.identifier) | Observation.Identifier | EIP[Identifier-PlacerAssignedIdentifier] | ||||||||
| 33 | OBX-33 | Observation Related Specimen Identifier | EIP | 0 | -1 | IF OBX-33 COUNT=1 | Observation.specimen(Observation.Specimen.identifier) | Observation.Identifier | EIP[Identifier-FillerAssignedIdentifier] | ||||||||
Mapping from OBX to Observation
ACTIVE (not intended for production usage). Published on 2024-04-24 by HL7 International / Orders and Observations (HL7 Orders and Observations Workgroup: http://www.hl7.org/Special/com..., Keith W. Boone: kboone@ainq.com, Rob Hausam: rrhausam@gmail.com). Copyright (c) 2020, HL7 International, Inc., All Rights Reserved.
This ConceptMap represents a mapping from the HL7 V2 Segment OBX to the FHIR Observation Resource.
Group 1 Mapping from unspecified code system to unspecified code system
| Source Concept Details | Relationship | Target Concept Details | Comment | Properties | ||||||||||
| Codes from | vocabularymap | datatypemap | value | Codes from | narrative | antlr | ||||||||
| OBX-3 | Observation Identifier | CWE[CodeableConcept] | is equivalent to | code | code | |||||||||
| OBX-3 | Observation Identifier | CWE[CodeableConcept] | is equivalent to | component[each].code | component[each].code | |||||||||
| OBX-4 | Observation Sub-ID | OG[Extension-Subidentifier] | is equivalent to | $this | $this | Map to Observation.partOf or Observation.hasMember or Observation.DerivedFrom according to the implementation guidance for the v2 message at hand, otherwise map to the extension-sub-id to enable the final destination to determine how to structure the observations. | OBX-4 Sub Identifier would determine how to use Observation.partOf or Observation.hasMember or Observation.DerivedFrom, but is highly dependent on the local implementation of OBX-4 or an implementation guide (e.g., LRI, Clinical Genomics). That is not known at the standard level, so we cannot provide specific mapping guidance here. However, if the mapper does not have access to the syntax used and its meaning, we need to be able to pass on OBX-4 Sub Identifier to the final destination that should know how to then structure it using FHIR attributes. | |||||||
| OBX-5 | Observation Value | NM[Quantity] | is equivalent to | component[each].valueQuantity | component[each].valueQuantity | IF OBX-2 EQUALS "NM" | ||||||||
| OBX-5 | Observation Value | is equivalent to | component[each].valueString | component[each].valueString | Any markup in ST, FT or TX data may not present properly given that valueString is a string data type | IF OBX-2 IN ("ST", "FT", "TX") | ||||||||
| OBX-5 | Observation Value | CF[CodeableConcept] | is equivalent to | component[each].valueCodeableConcept | component[each].valueCodeableConcept | IF OBX-2 EQUALS "CF" | ||||||||
| OBX-5 | Observation Value | CNE[CodeableConcept] | is equivalent to | component[each].valueCodeableConcept | component[each].valueCodeableConcept | IF OBX-2 EQUALS "CNE" | ||||||||
| OBX-5 | Observation Value | CE[CodeableConcept] | is equivalent to | component[each].valueCodeableConcept | component[each].valueCodeableConcept | IF OBX-2 EQUALS "CE" | ||||||||
| OBX-5 | Observation Value | CWE[CodeableConcept] | is equivalent to | component[each].valueCodeableConcept | component[each].valueCodeableConcept | IF OBX-2 EQUALS "CWE" | ||||||||
| OBX-5 | Observation Value | IS[CodeableConcept] | is equivalent to | component[each].valueCodeableConcept | component[each].valueCodeableConcept | IF OBX-2 EQUALS "IS" | ||||||||
| OBX-5 | Observation Value | DR[Period] | is equivalent to | component[each].valuePeriod | component[each].valuePeriod | IF OBX-2 EQUALS "DR" | ||||||||
| OBX-5 | Observation Value | is equivalent to | component[each].valueDateTime | component[each].valueDateTime | IF OBX-2 IN ("DTM", "DT") | |||||||||
| OBX-5 | Observation Value | NR[Range] | is equivalent to | component[each].valueRange | component[each].valueRange | IF OBX-2 EQUALS "NR" | ||||||||
| OBX-5 | Observation Value | OBX-5.1+"-"+OBX-5.2 | is equivalent to | component[each].valueString | component[each].valueString | IF OBX-2 EQUALS "VR" | ||||||||
| OBX-5 | Observation Value | is equivalent to | component[each].valueTime | component[each].valueTime | IF OBX-2 EQUALS "TM" | |||||||||
| OBX-5 | Observation Value | SN[Ratio] | is equivalent to | component[each].valueRatio | component[each].valueRatio | IF (OBX-2 EQUALS "SN" AND OBX-5.3 IN (":", "/") | ||||||||
| OBX-5 | Observation Value | SN[Range] | is equivalent to | component[each].valueRange | component[each].valueRange | IF OBX-2 EQUALS "SN" and OBX-5.3 EQUALS "-" | ||||||||
| OBX-5 | Observation Value | OBX-5.1+""+OBX-5.2+""+OBX-5.3+""+OBX-5.4 | is equivalent to | component[each].valueString | component[each].valueString | IF OBX-2 EQUALS "SN" and OBX-5.3 EQUALS "+" | ||||||||
| OBX-5 | Observation Value | SN[Quantity] | is equivalent to | component[each].valueQuantity | component[each].valueQuantity | IF OBX-2 EQUALS "SN" and OBX-5.3 NOT IN (":", "/", "-", "+") | ||||||||
| OBX-5 | Observation Value | is equivalent to | component[each].valueSampledData | component[each].valueSampledData | IF OBX-2 EQUALS "NA" | Need to add text on converting from NA to SampledData | ||||||||
| OBX-5 | Observation Value | "https://hl7.org/fhir/R5/StructureDefinition/extension-Observation.valueAttachment | is equivalent to | component[each].extension[1].url | component[each].extension[1].url | If none of the other observations in OBX-5 are not derived from the documentation included | IF OBX-2 EQUALS "ED" AND IF OBX-5.4 EQUALS "Base64" | Some implementers may include in OBX-5 the documentation that the other OBX-5 components are derived from. In that situations | ||||||
| OBX-5 | Observation Value | ED[Attachment] | is equivalent to | component[each].extension[1].valueAttachment | component[each].extension[1].valueAttachment | If none of the other observations in OBX-5 are not derived from the documentation included | IF OBX-2 EQUALS "ED" AND IF OBX-5.4 EQUALS "Base64" | We are for now addressing Base64 that cover .pdf, pictures and other binaries. If somebody does this, we will address those. | ||||||
| OBX-5 | Observation Value | ED[DocumentReference] | is equivalent to | derivedFrom(DocumentReference) | derivedFrom(DocumentReference) | And if other observation in OBX-5 are derived from the documentation included | IF OBX-2 EQUALS "ED" AND IF OBX-5.4 EQUALS "Base64" | |||||||
| OBX-5 | Observation Value | "https://hl7.org/fhir/R5/StructureDefinition/extension-Observation.valueAttachment | is equivalent to | component[each].extension[1].url | component[each].extension[1].url | If none of the other observations in OBX-5 are not derived from the documentation referenced | IF OBX-2 EQUALS "RP" | |||||||
| OBX-5 | Observation Value | RP[Attachment] | is equivalent to | component[each].extension[1].valueAttachment | component[each].extension[1].valueAttachment | If none of the other observations in OBX-5 are not derived from the documentation referenced | IF OBX-2 EQUALS "RP" | To be resolved when we resolve DocumentReference and valueAttachment | ||||||
| OBX-5 | Observation Value | RP[DocumentReference] | is equivalent to | derivedFrom(DocumentReference) | derivedFrom(DocumentReference) | And if other observation in OBX-5 are derived from the documentation being referenced | IF OBX-2 EQUALS "RP" | |||||||
| OBX-6 | Units | CWE[Quantity] | is equivalent to | component[each].valueQuantity | component[each].valueQuantity | IF OBX-2 EQUALS "SN" and OBX-5.3 NOT IN (":", "/", "-", "+") | ||||||||
| OBX-6 | Units | CWE[Quantity] | is equivalent to | component[each].valueQuantity | component[each].valueQuantity | IF OBX-2 IN ("NA", "NM") | ||||||||
| OBX-6 | Units | CWE[Quantity] | is equivalent to | component[each].valueRange.low | component[each].valueRange.low | IF OBX-2 EQUALS "SN" AND OBX-5.3 EQUALS "-" | ||||||||
| OBX-6 | Units | CWE[Quantity] | is equivalent to | component[each].valueRange.high | component[each].valueRange.high | IF OBX-2 EQUALS "SN" AND OBX-5.3 EQUALS "-" | ||||||||
| OBX-6 | Units | CWE[Quantity] | is equivalent to | component[each].valueRatio.numerator | component[each].valueRatio.numerator | IF (OBX-2 EQUALS "SN" AND (OBX-5.3 IN (":", "/")) | ||||||||
| OBX-6 | Units | CWE[Quantity] | is equivalent to | component[each].valueRatio.denominator | component[each].valueRatio.denominator | IF (OBX-2 EQUALS "SN" AND (OBX-5.3 IN (":", "/")) | ||||||||
| OBX-7 | References Range | is equivalent to | component[each].referenceRange.text | component[each].referenceRange.text | If OBX-7 is sufficiently parseable, then the low, high, type, appliesTo, and/or age may be used. | |||||||||
| OBX-8 | Interpretation Codes | InterpretationCode | CWE[CodeableConcept] | is equivalent to | interpretation | interpretation | ||||||||
| OBX-10 | Nature of Abnormal Test | "http://hl7.org/fhir/StructureDefinition/observation-nature-of-abnormal-test" | is equivalent to | extension[2].uri | extension[2].uri | |||||||||
| OBX-10 | Nature of Abnormal Test | NatureOfAbnormalTesting | CWE[CodeableConcept] | is equivalent to | extension[2].valueCodeableConcept | extension[2].valueCodeableConcept | ||||||||
| OBX-11 | Observation Result Status | ObservationStatus | is equivalent to | status | status | |||||||||
| OBX-14 | Date/Time of the Observation | is equivalent to | effectiveDateTime | effectiveDateTime | ||||||||||
| OBX-16 | Responsible Observer | XCN[PractitionerRole] | is equivalent to | performer[1](PractitionerRole.practitioner(Practitioner)) | performer[1](PractitionerRole.practitioner(Practitioner)) | |||||||||
| OBX-16 | Responsible Observer | "responsibleObserver" | is equivalent to | performer[1](PractitionerRole.code.coding.code) | performer[1](PractitionerRole.code.coding.code) | |||||||||
| OBX-16 | Responsible Observer | "http://terminology.hl7.org/CodeSystem/practitioner-role" | is equivalent to | performer[1](PractitionerRole.code.coding.system) | performer[1](PractitionerRole.code.coding.system) | |||||||||
| OBX-17 | Observation Method | CWE[CodeableConcept] | is equivalent to | method | method | The cardinality of Observation.method is 0..1 while the source allows for multiple methods. As we are not aware of anybody populating multiples in HL7 v2, we did not provide further mapping guidance. If you need to support multiples, please submit a gForge to OO for the HL7 v2 to FHIR mapping Implementation Guide. | ||||||||
| OBX-18 | Equipment Instance Identifier | EI[Identifier-Extension] | is equivalent to | device(Device.identifier) | device(Device.identifier) | |||||||||
| OBX-19 | Date/Time of the Analysis | is equivalent to | extension[1].url | extension[1].url | "http://hl7.org/fhir/StructureDefinition/observation-analysis-date-time" | |||||||||
| OBX-19 | Date/Time of the Analysis | is equivalent to | extension[1].valueDateTime | extension[1].valueDateTime | ||||||||||
| OBX-20 | Observation Site | CWE[CodeableConcept] | is equivalent to | bodySite | bodySite | The cardinality of Observation.bodySite is 0..1 while the source allows for multiple body sites. As we are not aware of anybody populating multiples in HL7 v2, we did not provide further mapping guidance. If you need to support multiples, please submit a gForge to OO for the HL7 v2 to FHIR mapping Implementation Guide. | ||||||||
| OBX-21 | Observation Instance Identifier | EI[Identifier-Extension] | is equivalent to | identifier | identifier | |||||||||
| OBX-21 | Observation Instance Identifier | "FILL" | is equivalent to | identifier.type.coding.code | identifier.type.coding.code | |||||||||
| OBX-23 | Performing Organization Name | XON[Organization] | is equivalent to | performer[2](Organization) | performer[2](Organization) | |||||||||
| OBX-23 | Performing Organization Name | XON[Organization] | is equivalent to | performer[2](PractitionerRole.organization(Organization)) | performer[2](PractitionerRole.organization(Organization)) | IF OBX-25 VALUED | ||||||||
| OBX-24 | Performing Organization Address | XAD[Address] | is equivalent to | performer[2](Organization.address) | performer[2](Organization.address) | |||||||||
| OBX-24 | Performing Organization Address | XAD[Address] | is equivalent to | performer[2](PractitionerRole.organization(Organization.address)) | performer[2](PractitionerRole.organization(Organization.address)) | IF OBX-25 VALUED | ||||||||
| OBX-25 | Performing Organization Medical Director | XCN[PractitionerRole] | is equivalent to | performer[2](PractitionerRole) | performer[2](PractitionerRole) | |||||||||
| OBX-25 | Performing Organization Medical Director | "MDIR" | is equivalent to | performer[2](PractitionerRole.code.coding.value) | performer[2](PractitionerRole.code.coding.value) | |||||||||
| OBX-25 | Performing Organization Medical Director | "http://terminology.hl7.org/CodeSystem/v2-0912" | is equivalent to | performer[2](PractitionerRole.code.coding.system) | performer[2](PractitionerRole.code.coding.system) | |||||||||
| OBX-33 | Observation Related Specimen Identifier | "http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.specimen | is equivalent to | extension[1].uri | extension[1].uri | IF OBX-33 COUNT>1 | Note that in v2 messages the observations that a calculated observation is derived from on and involve multiple specimens are typically not included with the message. To enable relating the calculated observation to the correct specimens it relates to, the v2 message should include the originating observations that in turn use OBX-33 to link to the correct specimens. Without that, and if there are multiple specimens in OBX-33, there is no standard method to correctly associate the observation with the correct specimens. The implementer will have to devise an appropriate method for that in their context. | |||||||
| OBX-33 | Observation Related Specimen Identifier | is equivalent to | extension[1].valueReference(Group.member.entity(Specimen.identifier[1]) | extension[1].valueReference(Group.member.entity(Specimen.identifier[1]) | IF OBX-33 COUNT>1 | |||||||||
| OBX-33 | Observation Related Specimen Identifier | "http://hl7.org/fhir/5.0/StructureDefinition/extension-Observation.specimen | is equivalent to | extension[2].uri | extension[2].uri | IF OBX-33 COUNT>1 | ||||||||
| OBX-33 | Observation Related Specimen Identifier | is equivalent to | extension[2].valueReference(Group.member.entity(Specimen.identifier[2])) | extension[2].valueReference(Group.member.entity(Specimen.identifier[2])) | IF OBX-33 COUNT>1 | |||||||||
| OBX-33 | Observation Related Specimen Identifier | EIP[Identifier-PlacerAssignedIdentifier] | is equivalent to | specimen(Specimen.identifier[1]) | specimen(Specimen.identifier[1]) | IF OBX-33 COUNT=1 | ||||||||
| OBX-33 | Observation Related Specimen Identifier | EIP[Identifier-FillerAssignedIdentifier] | is equivalent to | specimen(Specimen.identifier[2]) | specimen(Specimen.identifier[2]) | IF OBX-33 COUNT=1 | ||||||||
IG © 2020+ HL7 International / Orders and Observations. Package hl7.fhir.uv.v2mappings#1.0.0-ballot based on FHIR 4.0.1. Generated 2024-04-24
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change