US Veterans Health Administration FHIR Map Set Implementation Guide
1.6.49 - 250701 United States of America flag

Publication Build: This will be filled in by the publication tooling

Resource Profile: ObservationEXAM - Mappings

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.

Mapping Sources

Use Case: Observation EXAM (Source)Use Case: Observation EXAM (Source)PATIENT/IHS (9000001).01NAMEV EXAM (9000010.13).01EXAM.02PATIENT NAME.03VISIT.04RESULT220MAGNITUDE221UCUM CODE1201EVENT DATE AND TIME1204ENCOUNTER PROVIDER81101COMMENTSEXAM (9999999.15).01NAME200PRINT NAME210CODE MAPPINGSCODE MAPPINGS (9999999.18)1CODEUCUM CODES (757.5).01DESCRIPTION OF THE UNIT1UCUM CODE

Cross Mappings

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    

Raw Mappings

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

Mappings for Veterans Health Information Systems Technology and Architecture (VistA) ()

ObservationEXAM
Observation
   status1589: fixed value = #final
   category1591: 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

         system1580-1: fixed value = http://va.gov/terminology/vistaDefinedTerms/9999999.15

generated from mapParameter line 1

         code1580-2: source value based on V EXAM - EXAM > EXAM - NAME (9000010.13-.01 > 9999999.15-.01)

generated from mapParameter line 2

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

         system1581-1: fixed value = urn:see-termmap-in-mapParameter

generated from mapParameter line 1

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

   subject1582: reference based on V EXAM - PATIENT NAME > PATIENT/IHS - NAME (9000010.13-.02 > 9000001-.01)

in CDW through PatientSID

   encounter1583: 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)
   performer1590: 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-)
      value1585: source value based on V EXAM - MAGNITUDE (9000010.13-220)
      unit1586-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

      code1586-2: source value based on V EXAM - UCUM CODE > UCUM CODES - UCUM CODE (9000010.13-221 > 757.5-1)

generated from mapParameter line 2

   interpretation1584: transform using VF_ExamResultInterpretation on V EXAM - RESULT (9000010.13-.04)
   note
      text1587: source value based on V EXAM - COMMENTS (9000010.13-81101)

Mappings for Clinical Data Warehouse (CDW) ()

ObservationEXAM
Observation
   code
      coding
      coding (va-code)Outpat.VExam.ExamIEN
         codeOutpat.VExam.ExamIEN Dim.Exam.Exam
         displayOutpat.VExam.ExamIEN
      coding (va-sct)Outpat.VExam.ExamIEN
         codeOutpat.VExam.ExamIEN
   subjectOutpat.VExam.PatientIEN
   encounterOutpat.VExam.VisitDateTime Outpat.VExam.VisitIEN
   effective[x] (effectiveDateTime)Outpat.VExam.EventDateTime
   performerOutpat.VExam.EncounterProviderIEN
   value[x]
   value[x] (valueQuantity)
      unitDim.UCUMCode.DescriptionOfTheUnit
      codeDim.UCUMCode.UCUMCode
   interpretationOutpat.VExam.AbnormalNormal
   note
      textOutpat.VExam.Comments

Mappings for Summary Document Architecure (SDA) ()

ObservationEXAM
Observation
   code
      coding
      coding (va-code)PhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description
         codePhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description
         displayPhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description
      coding (va-sct)PhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description
         codePhysicalExam.PhysExamCode PhysicalExam.PhysExamCode[PhysExam].Description
   encounterPhysicalExam.EncounterNumber PhysicalExam.EnteredAt PhysicalExam.EnteredBy PhysicalExam.EnteredOn
   effective[x] (effectiveDateTime)PhysicalExam.PhysExamTime
   value[x]
   value[x] (valueQuantity)PhysicalExam.Extension[PhysicalExamExtension].Units
      valuePhysicalExam.Extension[PhysicalExamExtension].ResultValue
      unitPhysicalExam.Extension[PhysicalExamExtension].Units
      codePhysicalExam.Extension[PhysicalExamExtension].Units
   interpretationPhysicalExam.PhysExamObsValue
   note
      textPhysicalExam.NoteText

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

ObservationEXAM
ObservationEvent
   identifierEvent.identifier
   basedOnEvent.basedOn
   partOfEvent.partOf
   statusEvent.status
   codeEvent.code
   subjectEvent.subject
   encounterEvent.context
   effective[x]Event.occurrence[x]
   effective[x] (effectiveDateTime)Event.occurrence[x]
   performerEvent.performer.actor

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

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|

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

ObservationEXAM
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
      codingC*E.1-8, C*E.10-22
      coding (va-code)C*E.1-8, C*E.10-22
         systemC*E.3
         versionC*E.7
         codeC*E.1
         displayC*E.2 - but note this is not well followed
         userSelectedSometimes implied by being first
      coding (va-sct)C*E.1-8, C*E.10-22
         systemC*E.3
         versionC*E.7
         codeC*E.1
         displayC*E.2 - but note this is not well followed
         userSelectedSometimes implied by being first
      textC*E.9. But note many systems use C*E.2 for this
   subjectPID-3
   focusOBX-3
   encounterPV1
   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)
   issuedOBR.22 (or MSH.7), or perhaps OBX-19 (depends on who observation made)
   performerOBX.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
      valueSN.2 / CQ - N/A
      comparatorSN.1 / CQ.1
      unit(see OBX.6 etc.) / CQ.2
      system(see OBX.6 etc.) / CQ.2
      code(see OBX.6 etc.) / CQ.2
   dataAbsentReasonN/A
   interpretationOBX-8
   noteNTE.3 (partner NTE to OBX, or sometimes another (child?) OBX)
      author[x]N/A
      timeN/A
      textN/A
   bodySiteOBX-20
   methodOBX-17
   specimenSPM segment
   deviceOBX-17 / PRT -10
   referenceRangeOBX.7
      lowOBX-7
      highOBX-7
      typeOBX-10
      appliesToOBX-10
      textOBX-7
   hasMemberRelationships established by OBX-4 usage
   derivedFromRelationships established by OBX-4 usage
   componentcontainment by OBX-4?
      codeOBX-3
      value[x]OBX.2, OBX.5, OBX.6
      dataAbsentReasonN/A
      interpretationOBX-8
      referenceRangeOBX.7

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

ObservationEXAM
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
      idn/a
      extensionn/a
      codingunion(., ./translation)
      coding (va-code)union(., ./translation)
         idn/a
         extensionn/a
         system./codeSystem
         version./codeSystemVersion
         code./code
         displayCV.displayName
         userSelectedCD.codingRationale
      coding (va-sct)union(., ./translation)
         idn/a
         extensionn/a
         system./codeSystem
         version./codeSystemVersion
         code./code
         displayCV.displayName
         userSelectedCD.codingRationale
      text./originalText[mediaType/code="text/plain"]/data
   subjectparticipation[typeCode=RTGT]
   focusparticipation[typeCode=SBJ]
   encounterinboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN]
   effective[x]effectiveTime
   effective[x] (effectiveDateTime)effectiveTime
   issuedparticipation[typeCode=AUT].time
   performerparticipation[typeCode=PRF]
   value[x]value
   value[x] (valueQuantity)value
      idn/a
      extensionn/a
      valuePQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
      comparatorIVL properties
      unitPQ.unit
      systemCO.codeSystem, PQ.translation.codeSystem
      codePQ.code, MO.currency, PQ.translation.code
   dataAbsentReasonvalue.nullFlavor
   interpretationinterpretationCode
   notesubjectOf.observationEvent[code="annotation"].value
      idn/a
      extensionn/a
      author[x]Act.participant[typeCode=AUT].role
      timeAct.effectiveTime
      textAct.text
   bodySitetargetSiteCode
   methodmethodCode
   specimenparticipation[typeCode=SPC].specimen
   deviceparticipation[typeCode=DEV]
   referenceRangeoutboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN]
      idn/a
      extensionn/a
      modifierExtensionN/A
      lowvalue:IVL_PQ.low
      highvalue:IVL_PQ.high
      typeinterpretationCode
      appliesTointerpretationCode
      ageoutboundRelationship[typeCode=PRCN].targetObservationCriterion[code="age"].value
      textvalue:ST
   hasMemberoutBoundRelationship
   derivedFrom.targetObservation
   componentoutBoundRelationship[typeCode=COMP]
      idn/a
      extensionn/a
      modifierExtensionN/A
      codecode
      value[x]value
      dataAbsentReasonvalue.nullFlavor
      interpretationinterpretationCode
      referenceRangeoutboundRelationship[typeCode=REFV]/target[classCode=OBS, moodCode=EVN]

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

ObservationEXAM
Observation
   identifierFiveWs.identifier
   statusFiveWs.status
   categoryFiveWs.class
   codeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   focusFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   effective[x]FiveWs.done[x]
   effective[x] (effectiveDateTime)FiveWs.done[x]
   issuedFiveWs.recorded
   performerFiveWs.actor
   component
      codeFiveWs.what[x]

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

ObservationEXAM
Observation
   code116680003 |Is a|
   value[x]363714003 |Interprets|
   value[x] (valueQuantity)363714003 |Interprets|
   interpretation363713009 |Has interpretation|
   bodySite718497002 |Inherent location|
   specimen704319004 |Inherent in|
   device424226004 |Using device|
   component
      value[x]363714003 |Interprets|
      interpretation363713009 |Has interpretation|