HL7 Version 2 to FHIR
1.0.0-ballot - ballot International flag

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

ConceptMap: Message ADT_A17 to Bundle Map (Experimental)

Official URL: http://hl7.org/fhir/uv/v2mappings/message-adt-a17-to-bundle Version: 1.0.0-ballot
Active as of 2024-04-24 Computable Name: MessageADT_A17ToBundle

Copyright/Legal: Copyright (c) 2020, HL7 International, Inc., All Rights Reserved.

This ConceptMap represents a mapping from the HL7 V2 Message ADT_A17 to the FHIR Message Bundle.

This ConceptMap represents the mapping from the HL7 V2 ADT_A17 Message to the FHIR Message Bundle. See also the FHIR Shorthand or the CSV Source.

</thead> </table>
HL7 v2Condition (IF True, args)HL7 FHIRComments
Sort OrderIdentifierSyntaxNameCardinality - MinCardinality - MaxComputable ANTLRComputable FHIRPathNarrativePrimary TargetSegment MapReferences
1ADT_A17.MSHMSHMessage Header11BundleMSH[Bundle]
1ADT_A17.MSHMSHMessage Header11MessageHeaderMSH[MessageHeader]Processing of the MSH segment results in the creation of a new MessageHeader resource.
1ADT_A17.MSHMSHMessage Header11If there is a source in MSH-4, or known based on the configuration.ProvenanceMSH[Provenance-Source]Provenance[1].target.reference=Bundle.id; Provenance[1].target.reference=MessageHeader[1].idIf the FHIR transformation does not yield a FHIR message, but only a set of resource (APIs, repository, etc.) than one should consider attaching this Proviance resource instance to the relevant FHIR resources generated.
1ADT_A17.MSHMSHMessage Header11ProvenanceMSH[Provenance-Transformation]Provenance[2].target.reference=Bundle.idIf the FHIR transformation does not yield a FHIR Bunlde, but only a set of resource (APIs, repository, etc.) than one should consider attaching this Provenance resource instance to the relevant FHIR resources generated.
2ADT_A17.ARV[{ ARV }]Access Restrictions0-1
3ADT_A17.SFT[{ SFT }]Software Segment0-1If the software does represent not the original source systemProvenance.entity.what(Device)SFT[Device]Provenance[1].entity.what.reference=Device.id Provenance[1].entity.role="derivation"
3ADT_A17.SFT[{ SFT }]Software Segment0-1If the software represents the original source systemProvenance.entity.what(Device)SFT[Device]Provenance[1].entity.what.reference=Device.id Provenance[1].entity.role="source"
4ADT_A17.UAC[ UAC ]User Authentication Credential01
5ADT_A17.EVNEVNEvent Type11ProvenanceEVN[Provenance]Provenance[3].target.reference=MessageHeader[1].id
5ADT_A17.EVNEVNEvent Type11IF EVN-5 NOT VALUED AND (MSH-22 IS VALUED OR MSH-4 IS VALUED)ProvenanceMSH[Provenance-Operator]Provenance[3].target.reference=MessageHeader[1].idIf EVN-5 is not valued, then the MSH may have either the sending responsible organization (MSH-22) or the sending facility (MSH-4) to reasonable approximate the agent relevant for this Provenance instance.
6ADT_A17.PIDPIDPatient Identification11PatientPID[Patient]Processing of the PID segment results in the creation of a new Patient resource
6ADT_A17.PIDPIDPatient Identification11AccountPID[Account]Account[1].subject.reference=Patient[1].id
6ADT_A17.PIDPIDPatient Identification11IF PID-33 AND PID-34 VALUEDOne may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date.ProvenancePID[Provenance-Patient]Provenance[4].target.reference=Patient[1].id
7ADT_A17.PD1[ PD1 ]Additional Demographics01PatientPD1[Patient]Incorporate PD1 content into the Patient created from the PID segment.
8ADT_A17.PV1PV1Patient Visit11EncounterPV1[Encounter]Encounter[1].subject.reference=Patient[1].idProcessing of the PV1 segment results in the creation of a new Encounter resource
8ADT_A17.PV1PV1Patient Visit11PatientPV1[Patient]
9ADT_A17.PV2[ PV2 ]Patient Visit - Additional Info.01EncounterPV2[Encounter]Incorporate PV2 content into the Encounter created from the PV1 segment.
10ADT_A17.DB1[{ DB1 }]Disability Information0-1
12ADT_A17.OBSERVATION[{--- OBSERVATION begin0-1
12.1ADT_A17.OBSERVATION.OBXOBXObservation/Result0-1Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.ObservationOBX[Observation]Observation[1].subject.reference=Patient[1].idOne cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1].
12.1ADT_A17.OBSERVATION.OBXOBXObservation/Result0-1Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.ObservationOBX[Observation-Component]Observation[1].subject.reference=Patient[1].idOne cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1].
12.2ADT_A17.OBSERVATION.PRT[{ PRT }]Participation0-1
12.3/ADT_A17.OBSERVATION}]--- OBSERVATION end
13ADT_A17.PIDPIDPatient Identification11PatientPID[Patient]Processing of the PID segment results in the creation of a new Patient resource
13ADT_A17.PIDPIDPatient Identification11AccountPID[Account]Account[2].subject.reference=Patient[2].id
13ADT_A17.PIDPIDPatient Identification11IF PID-33 AND PID-34 VALUEDOne may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date.ProvenancePID[Provenance-Patient]Provenance[5].target.reference=Patient[2].id
14ADT_A17.PD1[ PD1 ]Additional Demographics01PatientPD1[Patient]Incorporate PD1 content into the Patient created from the PID segment.
15ADT_A17.PV1PV1Patient Visit11EncounterPV1[Encounter]Encounter[2].subject.reference=Patient[2].idProcessing of the PV1 segment results in the creation of a new Encounter resource
15ADT_A17.PV1PV1Patient Visit11PatientPV1[Patient]
16ADT_A17.PV2[ PV2 ]Patient Visit - Additional Info.01EncounterPV2[Encounter]Incorporate PV2 content into the Encounter created from the PV1 segment.
17ADT_A17.DB1[{ DB1 }]Disability Information0-1
18ADT_A17.OBSERVATION[{--- OBSERVATION begin0-1
18.1ADT_A17.OBSERVATION.OBXOBXObservation/Result0-1Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.ObservationOBX[Observation]Observation[2].subject.reference=Patient[2].idOne cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1].
18.1ADT_A17.OBSERVATION.OBXOBXObservation/Result0-1Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.ObservationOBX[Observation-Component]Observation[2].subject.reference=Patient[2].idOne cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1].
18.2ADT_A17.OBSERVATION.PRT[{ PRT }]Participation0-1
18.3/ADT_A17.OBSERVATION}]--- OBSERVATION end

Mapping from ADT_A17 to Bundle

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 Message ADT_A17 to the FHIR Message Bundle.


Group 1 Mapping from unspecified code system to unspecified code system

Source Concept DetailsRelationshipTarget Concept DetailsCommentProperties
Codes from segmentmapreferencesCodes from narrativeantlr
ADT_A17.MSHMessage HeaderMSH[Bundle]is equivalent toBundleBundle
ADT_A17.MSHMessage HeaderMSH[MessageHeader]is equivalent toMessageHeader[1]MessageHeader[1]Processing of the MSH segment results in the creation of a new MessageHeader resource.
ADT_A17.MSHMessage HeaderMSH[Provenance-Source]Provenance[1].target.reference=Bundle.id; Provenance[1].target.reference=MessageHeader[1].idis equivalent toProvenance[1]Provenance[1]If there is a source in MSH-4, or known based on the configuration.If the FHIR transformation does not yield a FHIR message, but only a set of resource (APIs, repository, etc.) than one should consider attaching this Proviance resource instance to the relevant FHIR resources generated.
ADT_A17.MSHMessage HeaderMSH[Provenance-Transformation]Provenance[2].target.reference=Bundle.idis equivalent toProvenance[2]Provenance[2]If the FHIR transformation does not yield a FHIR Bunlde, but only a set of resource (APIs, repository, etc.) than one should consider attaching this Provenance resource instance to the relevant FHIR resources generated.
ADT_A17.SFTSoftware SegmentSFT[Device]Provenance[1].entity.what.reference=Device.id Provenance[1].entity.role="derivation"\is equivalent toProvenance[1].entity.what(Device)Provenance[1].entity.what(Device)If the software does represent not the original source system
ADT_A17.SFTSoftware SegmentSFT[Device]Provenance[1].entity.what.reference=Device.id Provenance[1].entity.role="source"\is equivalent toProvenance[1].entity.what(Device)Provenance[1].entity.what(Device)If the software represents the original source system
ADT_A17.EVNEvent TypeEVN[Provenance]Provenance[3].target.reference=MessageHeader[1].idis equivalent toProvenance[3]Provenance[3]
ADT_A17.EVNEvent TypeMSH[Provenance-Operator]Provenance[3].target.reference=MessageHeader[1].idis equivalent toProvenance[3]Provenance[3]IF EVN-5 NOT VALUED AND (MSH-22 IS VALUED OR MSH-4 IS VALUED)If EVN-5 is not valued, then the MSH may have either the sending responsible organization (MSH-22) or the sending facility (MSH-4) to reasonable approximate the agent relevant for this Provenance instance.
ADT_A17.PIDPatient IdentificationPID[Patient]is equivalent toPatient[1]Patient[1]Processing of the PID segment results in the creation of a new Patient resource
ADT_A17.PIDPatient IdentificationPID[Account]Account[1].subject.reference=Patient[1].idis equivalent toAccount[1]Account[1]
ADT_A17.PIDPatient IdentificationPID[Provenance-Patient]Provenance[4].target.reference=Patient[1].idis equivalent toProvenance[4]Provenance[4]One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date.IF PID-33 AND PID-34 VALUED
ADT_A17.PD1Additional DemographicsPD1[Patient]is equivalent toPatient[1]Patient[1]Incorporate PD1 content into the Patient created from the PID segment.
ADT_A17.PV1Patient VisitPV1[Encounter]Encounter[1].subject.reference=Patient[1].idis equivalent toEncounter[1]Encounter[1]Processing of the PV1 segment results in the creation of a new Encounter resource
ADT_A17.PV1Patient VisitPV1[Patient]is equivalent toPatient[1]Patient[1]
ADT_A17.PV2Patient Visit - Additional Info.PV2[Encounter]is equivalent toEncounter[1]Encounter[1]Incorporate PV2 content into the Encounter created from the PV1 segment.
ADT_A17.OBSERVATION.OBXObservation/ResultOBX[Observation]Observation[1].subject.reference=Patient[1].idis equivalent toObservation[1]Observation[1]Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.One cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1].
ADT_A17.OBSERVATION.OBXObservation/ResultOBX[Observation-Component]Observation[1].subject.reference=Patient[1].idis equivalent toObservation[1]Observation[1]Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.One cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1].
ADT_A17.PIDPatient IdentificationPID[Patient]is equivalent toPatient[2]Patient[2]Processing of the PID segment results in the creation of a new Patient resource
ADT_A17.PIDPatient IdentificationPID[Account]Account[2].subject.reference=Patient[2].idis equivalent toAccount[2]Account[2]
ADT_A17.PIDPatient IdentificationPID[Provenance-Patient]Provenance[5].target.reference=Patient[2].idis equivalent toProvenance[5]Provenance[5]One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date.IF PID-33 AND PID-34 VALUED
ADT_A17.PD1Additional DemographicsPD1[Patient]is equivalent toPatient[2]Patient[2]Incorporate PD1 content into the Patient created from the PID segment.
ADT_A17.PV1Patient VisitPV1[Encounter]Encounter[2].subject.reference=Patient[2].idis equivalent toEncounter[2]Encounter[2]Processing of the PV1 segment results in the creation of a new Encounter resource
ADT_A17.PV1Patient VisitPV1[Patient]is equivalent toPatient[2]Patient[2]
ADT_A17.PV2Patient Visit - Additional Info.PV2[Encounter]is equivalent toEncounter[2]Encounter[2]Incorporate PV2 content into the Encounter created from the PV1 segment.
ADT_A17.OBSERVATION.OBXObservation/ResultOBX[Observation]Observation[2].subject.reference=Patient[2].idis equivalent toObservation[2]Observation[2]Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.One cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1].
ADT_A17.OBSERVATION.OBXObservation/ResultOBX[Observation-Component]Observation[2].subject.reference=Patient[2].idis equivalent toObservation[2]Observation[2]Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.One cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1].

Notes: