US Veterans Health Administration FHIR Map Set Implementation Guide
1.6.49 - 250701
Publication Build: This will be filled in by the publication tooling
Draft as of 2025-06-13 |
Mappings for the ObservationEXAM resource profile.
Scroll down for the Raw FHIR, CDW & SDA mappings (if any).
Note that the CDW, SDA and VPR XML mappings are derived from a look-up based on the VistA source.
FHIR Path | VistA | CDW | SDA | VPR |
---|---|---|---|---|
Observation.code.coding[va-code] | 9999999.15- | |||
Observation.code.coding[va-code].code | 9999999.15-.01 | Dim.Exam.Exam | ||
Observation.code.coding[va-code].display | 9999999.15-200 | |||
Observation.code.coding[va-sct] | 9999999.18 | |||
Observation.code.coding[va-sct].code | 9999999.18-1 | |||
Observation.subject | 9000001-.01 | |||
Observation.encounter | 9000010.13-.03 | Outpat.VExam.VisitDateTime Outpat.VExam.VisitIEN |
PhysicalExam.EncounterNumber PhysicalExam.EnteredAt PhysicalExam.EnteredBy PhysicalExam.EnteredOn |
|
Observation.interpretation | 9000010.13-.04 | Outpat.VExam.AbnormalNormal | PhysicalExam.PhysExamObsValue | |
Observation.valueQuantity.value | 9000010.13-220 | PhysicalExam.Extension[PhysicalExamExtension].ResultValue | ||
Observation.valueQuantity | 757.5- | |||
Observation.valueQuantity.unit | 757.5-.01 | Dim.UCUMCode.DescriptionOfTheUnit | ||
Observation.valueQuantity.code | 757.5-1 | Dim.UCUMCode.UCUMCode | ||
Observation.note.text | 9000010.13-81101 | Outpat.VExam.Comments | PhysicalExam.NoteText | |
Observation.effectiveDateTime | 9000010.13-1201 | Outpat.VExam.EventDateTime | PhysicalExam.PhysExamTime | |
Observation.performer | 9000010.13-1204 | Outpat.VExam.EncounterProviderIEN |
key | status | direction | source | mapApproach | mapCase | FHIR Path | subPath | mapValue | mapParameter | mapComment | FHIR URL | Ver |
---|---|---|---|---|---|---|---|---|---|---|---|
1580 | in process | V2F | V EXAM - EXAM > EXAM (9000010.13-.01 > 9999999.15-) | source value | Observation.code.coding[va-code] | .system= http://va.gov/terminology/vistaDefinedTerms/9999999.15 .code = {NAME(.01)} .display = {PRINT NAME(200)} |
in CDW through ExamSID | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | |||
1581 | in process | V2F | V EXAM - EXAM > EXAM - CODE MAPPINGS > CODE MAPPINGS (9000010.13-.01 > 9999999.15-210>9999999.18) | source value | Observation.code.coding[va-sct] | .system = termmap(VF_ICDCodingSystems,{CODING SYSTEM(.01)}) .code = {CODE(1)} |
in CDW through ExamSID | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | |||
1582 | in process | V2F | V EXAM - PATIENT NAME > PATIENT/IHS - NAME (9000010.13-.02 > 9000001-.01) | reference | Observation.subject | /Patient | in CDW through PatientSID | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | |||
1583 | in process | V2F | V EXAM - VISIT (9000010.13-.03) | reference | Observation.encounter | /EncounterOutpatient | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | ||||
1584 | in process | V2F | V EXAM - RESULT (9000010.13-.04) | transform | Observation.interpretation | VF_ExamResultInterpretation | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | ||||
1585 | in process | V2F | V EXAM - MAGNITUDE (9000010.13-220) | source value | Observation.valueQuantity | .value | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | ||||
1586 | in process | V2F | V EXAM - UCUM CODE > UCUM CODES (9000010.13-221 > 757.5-) | source value | Observation.valueQuantity | .unit = {DESCRIPTION OF THE UNIT (.01)} .code= {UCUM CODE (1)} |
http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | ||||
1587 | in process | V2F | V EXAM - COMMENTS (9000010.13-81101) | source value | Observation.note | .text | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | ||||
1588 | in process | V2F | V EXAM - EVENT DATE AND TIME (9000010.13-1201) | source value | Observation.effectiveDateTime | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | |||||
1589 | in process | V2F | fixed value | Observation.status | #final | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | |||||
1590 | in process | V2F | V EXAM - ENCOUNTER PROVIDER (9000010.13-1204) | reference | Observation.performer | /Practitioner | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 | ||||
1591 | in process | V2F | fixed value | Observation.category | http://terminology.hl7.org/CodeSystem/observation-category#exam | http://hl7.org/fhir/StructureDefinition/Observation | 4.0.1 |
ObservationEXAM | ||
Observation | ||
status | 1589: fixed value = #final | |
category | 1591: fixed value = http://terminology.hl7.org/CodeSystem/observation-category#exam | |
code | ||
coding | ||
coding (va-code) | 1580: source value based on V EXAM - EXAM > EXAM (9000010.13-.01 > 9999999.15-) | in CDW through ExamSID |
system | 1580-1: fixed value = http://va.gov/terminology/vistaDefinedTerms/9999999.15 | generated from mapParameter line 1 |
code | 1580-2: source value based on V EXAM - EXAM > EXAM - NAME (9000010.13-.01 > 9999999.15-.01) | generated from mapParameter line 2 |
display | 1580-3: source value based on V EXAM - EXAM > EXAM - PRINT NAME (9000010.13-.01 > 9999999.15-200) | generated from mapParameter line 3 |
coding (va-sct) | 1581: source value based on V EXAM - EXAM > EXAM - CODE MAPPINGS > CODE MAPPINGS (9000010.13-.01 > 9999999.15-210>9999999.18) | in CDW through ExamSID |
system | 1581-1: fixed value = urn:see-termmap-in-mapParameter | generated from mapParameter line 1 |
code | 1581-2: source value based on V EXAM - EXAM > EXAM - CODE MAPPINGS > CODE MAPPINGS - CODE (9000010.13-.01 > 9999999.15-210>9999999.18-1) | generated from mapParameter line 2 |
subject | 1582: reference based on V EXAM - PATIENT NAME > PATIENT/IHS - NAME (9000010.13-.02 > 9000001-.01) | in CDW through PatientSID |
encounter | 1583: reference based on V EXAM - VISIT (9000010.13-.03) | |
effective[x] (effectiveDateTime) | 1588: source value based on V EXAM - EVENT DATE AND TIME (9000010.13-1201) | |
performer | 1590: reference based on V EXAM - ENCOUNTER PROVIDER (9000010.13-1204) | |
value[x] | ||
value[x] (valueQuantity) | 1586: source value based on V EXAM - UCUM CODE > UCUM CODES (9000010.13-221 > 757.5-) | |
value | 1585: source value based on V EXAM - MAGNITUDE (9000010.13-220) | |
unit | 1586-1: source value based on V EXAM - UCUM CODE > UCUM CODES - DESCRIPTION OF THE UNIT (9000010.13-221 > 757.5-.01) | generated from mapParameter line 1 |
code | 1586-2: source value based on V EXAM - UCUM CODE > UCUM CODES - UCUM CODE (9000010.13-221 > 757.5-1) | generated from mapParameter line 2 |
interpretation | 1584: transform using VF_ExamResultInterpretation on V EXAM - RESULT (9000010.13-.04) | |
note | ||
text | 1587: source value based on V EXAM - COMMENTS (9000010.13-81101) |
ObservationEXAM | ||
Observation | ||
code | ||
coding | ||
coding (va-code) | Outpat.VExam.ExamIEN | |
code | Outpat.VExam.ExamIEN Dim.Exam.Exam | |
display | Outpat.VExam.ExamIEN | |
coding (va-sct) | Outpat.VExam.ExamIEN | |
code | Outpat.VExam.ExamIEN | |
subject | Outpat.VExam.PatientIEN | |
encounter | Outpat.VExam.VisitDateTime Outpat.VExam.VisitIEN | |
effective[x] (effectiveDateTime) | Outpat.VExam.EventDateTime | |
performer | Outpat.VExam.EncounterProviderIEN | |
value[x] | ||
value[x] (valueQuantity) | ||
unit | Dim.UCUMCode.DescriptionOfTheUnit | |
code | Dim.UCUMCode.UCUMCode | |
interpretation | Outpat.VExam.AbnormalNormal | |
note | ||
text | Outpat.VExam.Comments |
ObservationEXAM | ||
Observation | ||
code | ||
coding | ||
coding (va-code) | PhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description | |
code | PhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description | |
display | PhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description | |
coding (va-sct) | PhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description | |
code | PhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description | |
encounter | PhysicalExam.EncounterNumber PhysicalExam.EnteredAt PhysicalExam.EnteredBy PhysicalExam.EnteredOn | |
effective[x] (effectiveDateTime) | PhysicalExam.PhysExamTime | |
value[x] | ||
value[x] (valueQuantity) | PhysicalExam.Extension[PhysicalExamExtension].Units | |
value | PhysicalExam.Extension[PhysicalExamExtension].ResultValue | |
unit | PhysicalExam.Extension[PhysicalExamExtension].Units | |
code | PhysicalExam.Extension[PhysicalExamExtension].Units | |
interpretation | PhysicalExam.PhysExamObsValue | |
note | ||
text | PhysicalExam.NoteText |
ObservationEXAM | ||
Observation | Event | |
identifier | Event.identifier | |
basedOn | Event.basedOn | |
partOf | Event.partOf | |
status | Event.status | |
code | Event.code | |
subject | Event.subject | |
encounter | Event.context | |
effective[x] | Event.occurrence[x] | |
effective[x] (effectiveDateTime) | Event.occurrence[x] | |
performer | Event.performer.actor |
ObservationEXAM | ||
Observation | < 363787002 |Observable entity| | |
status | < 445584004 |Report by finality status| | |
code | < 363787002 |Observable entity| OR < 386053000 |Evaluation procedure| | |
value[x] | < 441742003 |Evaluation finding| | |
value[x] (valueQuantity) | < 441742003 |Evaluation finding| | |
interpretation | < 260245000 |Findings values| | |
bodySite | < 123037004 |Body structure| | |
specimen | < 123038009 |Specimen| | |
device | < 49062001 |Device| | |
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| | |
appliesTo | < 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| | |
component | ||
code | < 363787002 |Observable entity| OR < 386053000 |Evaluation procedure| | |
value[x] | 363714003 |Interprets| < 441742003 |Evaluation finding| | |
interpretation | < 260245000 |Findings values| |
ObservationEXAM | ||
Observation | OBX | |
identifier | OBX.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. | |
basedOn | ORC | |
partOf | Varies by domain | |
status | OBX-11 | |
code | OBX-3 | |
coding | C*E.1-8, C*E.10-22 | |
coding (va-code) | C*E.1-8, C*E.10-22 | |
system | C*E.3 | |
version | C*E.7 | |
code | C*E.1 | |
display | C*E.2 - but note this is not well followed | |
userSelected | Sometimes implied by being first | |
coding (va-sct) | C*E.1-8, C*E.10-22 | |
system | C*E.3 | |
version | C*E.7 | |
code | C*E.1 | |
display | C*E.2 - but note this is not well followed | |
userSelected | Sometimes implied by being first | |
text | C*E.9. But note many systems use C*E.2 for this | |
subject | PID-3 | |
focus | OBX-3 | |
encounter | PV1 | |
effective[x] | OBX-14, and/or OBX-19 after v2.4 (depends on who observation made) | |
effective[x] (effectiveDateTime) | OBX-14, and/or OBX-19 after v2.4 (depends on who observation made) | |
issued | OBR.22 (or MSH.7), or perhaps OBX-19 (depends on who observation made) | |
performer | OBX.15 / (Practitioner) OBX-16, PRT-5:PRT-4='RO' / (Device) OBX-18 , PRT-10:PRT-4='EQUIP' / (Organization) OBX-23, PRT-8:PRT-4='PO' | |
value[x] | OBX.2, OBX.5, OBX.6 | |
value[x] (valueQuantity) | OBX.2, OBX.5, OBX.6 | |
value | SN.2 / CQ - N/A | |
comparator | SN.1 / CQ.1 | |
unit | (see OBX.6 etc.) / CQ.2 | |
system | (see OBX.6 etc.) / CQ.2 | |
code | (see OBX.6 etc.) / CQ.2 | |
dataAbsentReason | N/A | |
interpretation | OBX-8 | |
note | NTE.3 (partner NTE to OBX, or sometimes another (child?) OBX) | |
author[x] | N/A | |
time | N/A | |
text | N/A | |
bodySite | OBX-20 | |
method | OBX-17 | |
specimen | SPM segment | |
device | OBX-17 / PRT -10 | |
referenceRange | OBX.7 | |
low | OBX-7 | |
high | OBX-7 | |
type | OBX-10 | |
appliesTo | OBX-10 | |
text | OBX-7 | |
hasMember | Relationships established by OBX-4 usage | |
derivedFrom | Relationships established by OBX-4 usage | |
component | containment by OBX-4? | |
code | OBX-3 | |
value[x] | OBX.2, OBX.5, OBX.6 | |
dataAbsentReason | N/A | |
interpretation | OBX-8 | |
referenceRange | OBX.7 |
ObservationEXAM | ||
Observation | Entity. Role, or Act, Observation[classCode=OBS, moodCode=EVN] | |
text | Act.text? | |
contained | N/A | |
extension | N/A | |
modifierExtension | N/A | |
identifier | id | |
basedOn | .inboundRelationship[typeCode=COMP].source[moodCode=EVN] | |
partOf | .outboundRelationship[typeCode=FLFS].target | |
status | status 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 | |
code | code | |
id | n/a | |
extension | n/a | |
coding | union(., ./translation) | |
coding (va-code) | union(., ./translation) | |
id | n/a | |
extension | n/a | |
system | ./codeSystem | |
version | ./codeSystemVersion | |
code | ./code | |
display | CV.displayName | |
userSelected | CD.codingRationale | |
coding (va-sct) | union(., ./translation) | |
id | n/a | |
extension | n/a | |
system | ./codeSystem | |
version | ./codeSystemVersion | |
code | ./code | |
display | CV.displayName | |
userSelected | CD.codingRationale | |
text | ./originalText[mediaType/code="text/plain"]/data | |
subject | participation[typeCode=RTGT] | |
focus | participation[typeCode=SBJ] | |
encounter | inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN] | |
effective[x] | effectiveTime | |
effective[x] (effectiveDateTime) | effectiveTime | |
issued | participation[typeCode=AUT].time | |
performer | participation[typeCode=PRF] | |
value[x] | value | |
value[x] (valueQuantity) | value | |
id | n/a | |
extension | n/a | |
value | PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value | |
comparator | IVL properties | |
unit | PQ.unit | |
system | CO.codeSystem, PQ.translation.codeSystem | |
code | PQ.code, MO.currency, PQ.translation.code | |
dataAbsentReason | value.nullFlavor | |
interpretation | interpretationCode | |
note | subjectOf.observationEvent[code="annotation"].value | |
id | n/a | |
extension | n/a | |
author[x] | Act.participant[typeCode=AUT].role | |
time | Act.effectiveTime | |
text | Act.text | |
bodySite | targetSiteCode | |
method | methodCode | |
specimen | participation[typeCode=SPC].specimen | |
device | participation[typeCode=DEV] | |
referenceRange | outboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN] | |
id | n/a | |
extension | n/a | |
modifierExtension | N/A | |
low | value:IVL_PQ.low | |
high | value:IVL_PQ.high | |
type | interpretationCode | |
appliesTo | interpretationCode | |
age | outboundRelationship[typeCode=PRCN].targetObservationCriterion[code="age"].value | |
text | value:ST | |
hasMember | outBoundRelationship | |
derivedFrom | .targetObservation | |
component | outBoundRelationship[typeCode=COMP] | |
id | n/a | |
extension | n/a | |
modifierExtension | N/A | |
code | code | |
value[x] | value | |
dataAbsentReason | value.nullFlavor | |
interpretation | interpretationCode | |
referenceRange | outboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN] |
ObservationEXAM | ||
Observation | ||
identifier | FiveWs.identifier | |
status | FiveWs.status | |
category | FiveWs.class | |
code | FiveWs.what[x] | |
subject | FiveWs.subject[x], FiveWs.subject | |
focus | FiveWs.subject[x], FiveWs.subject | |
encounter | FiveWs.context | |
effective[x] | FiveWs.done[x] | |
effective[x] (effectiveDateTime) | FiveWs.done[x] | |
issued | FiveWs.recorded | |
performer | FiveWs.actor | |
component | ||
code | FiveWs.what[x] |
ObservationEXAM | ||
Observation | ||
code | 116680003 |Is a| | |
value[x] | 363714003 |Interprets| | |
value[x] (valueQuantity) | 363714003 |Interprets| | |
interpretation | 363713009 |Has interpretation| | |
bodySite | 718497002 |Inherent location| | |
specimen | 704319004 |Inherent in| | |
device | 424226004 |Using device| | |
component | ||
value[x] | 363714003 |Interprets| | |
interpretation | 363713009 |Has interpretation| |