MyHealtheVet PHR FHIR API
0.3.9-current - ci-build United States of America flag

MyHealtheVet PHR FHIR API, published by VA Digital Services. This guide is not an authorized publication; it is the continuous build for version 0.3.9-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/department-of-veterans-affairs/mhv-fhir-phr-mapping/ and changes regularly. See the Directory of published versions

Resource Profile: MHVimagingExam - Mappings

Page standards status: Trial-use Maturity Level: 1

Mappings for the VA.MHV.PHR.imaging resource profile.

Mappings for VIA to mhv-fhir-phr (ImagingExamTO)

MHVimagingExam
DiagnosticReportImagingExamTO
   identifier (TOid){StationNbr} and {ImagingExamTO.id}
   identifier (accessionNumber)ImagingExamTO.accessionNum
   identifier (casenum)ImagingExamTO.casenum
   basedOnContained ServiceRequest(ImagingExamTO.order)
   status`final` if not `entered-in-error`
   category`LOINC#LP29684-5`
   code
      codingCPT ImagingExamTO.type
      textImagingExamTO.imagingType
   subjectGetPatient()
   encounter
      identifieridentifier.value = ImagingExamTO.encounterId
   effective[x] (effectiveDateTime)ConvertDate(ImagingExamTO.timestamp)
   issuedtext {Date Verified}
   performerGetLocation(ImagingExamTO.imagingLocation)
   resultsInterpreterGetPractitioner(ImagingStudyTO.provider.[UserTO])
   conclusionImagingStudyTO.interpretation
   presentedForm
      contentType`text/plain`
      dataBase64Encode(ImagingStudyTO.radiologyReportTo.text)
      titleImagingExamTO.radiologyReportTo.title
      creationtext {Date Reported}

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

MHVimagingExam
DiagnosticReportEvent
   identifierEvent.identifier
   identifier (TOid)Event.identifier
   identifier (accessionNumber)Event.identifier
   identifier (casenum)Event.identifier
   basedOnEvent.basedOn
   statusEvent.status
   codeEvent.code
   subjectEvent.subject
   encounterEvent.encounter
   effective[x]Event.occurrence[x]
   effective[x] (effectiveDateTime)Event.occurrence[x]
   performerEvent.performer.actor
   resultsInterpreterEvent.performer.actor

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

MHVimagingExam
DiagnosticReportORU -> OBR
   identifierOBR-51/ for globally unique filler ID - OBR-3 , For non-globally unique filler-id the flller/placer number must be combined with the universal service Id - OBR-2(if present)+OBR-3+OBR-4
   identifier (TOid)OBR-51/ for globally unique filler ID - OBR-3 , For non-globally unique filler-id the flller/placer number must be combined with the universal service Id - OBR-2(if present)+OBR-3+OBR-4
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (accessionNumber)OBR-51/ for globally unique filler ID - OBR-3 , For non-globally unique filler-id the flller/placer number must be combined with the universal service Id - OBR-2(if present)+OBR-3+OBR-4
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (casenum)OBR-51/ for globally unique filler ID - OBR-3 , For non-globally unique filler-id the flller/placer number must be combined with the universal service Id - OBR-2(if present)+OBR-3+OBR-4
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   basedOnORC? OBR-2/3?
   statusOBR-25 (not 1:1 mapping)
   categoryOBR-24
   category (us-core)OBR-24
   codeOBR-4 (HL7 v2 doesn't provide an easy way to indicate both the ordered test and the performed panel)
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this
   subjectPID-3 (no HL7 v2 mapping for Group or Device)
   encounterPV1-19
   effective[x]OBR-7
   effective[x] (effectiveDateTime)OBR-7
   issuedOBR-22
   performerPRT-8 (where this PRT-4-Participation = "PO")
   resultsInterpreterOBR-32, PRT-8 (where this PRT-4-Participation = "PI")
   conclusionOBX
   presentedFormOBX
      contentTypeED.2+ED.3/RP.2+RP.3. Note conversion may be needed if old style values are being used
      dataED.5
      urlRP.1+RP.2 - if they refer to a URL (see v2.6)

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

MHVimagingExam
DiagnosticReportEntity. Role, or Act, Observation[classCode=OBS, moodCode=EVN]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifierid
   identifier (TOid)id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (accessionNumber)id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (casenum)id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   basedOnoutboundRelationship[typeCode=FLFS].target
   statusstatusCode Note: final and amended are distinguished by whether observation is the subject of a ControlAct event of type "revise"
   categoryinboundRelationship[typeCode=COMP].source[classCode=LIST, moodCode=EVN, code < LabService].code
   category (us-core)inboundRelationship[typeCode=COMP].source[classCode=LIST, moodCode=EVN, code < LabService].code
   codecode
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data
   subjectparticipation[typeCode=SBJ]
   encounterinboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN]
      idn/a
      extensionn/a
      typeN/A
      identifier.identifier
      displayN/A
   effective[x]effectiveTime
   effective[x] (effectiveDateTime)effectiveTime
   issuedparticipation[typeCode=VRF or AUT].time
   performer.participation[typeCode=PRF]
   resultsInterpreter.participation[typeCode=PRF]
   conclusioninboundRelationship[typeCode="SPRT"].source[classCode=OBS, moodCode=EVN, code=LOINC:48767-8].value (type=ST)
   presentedFormtext (type=ED)
      idn/a
      extensionn/a
      contentType./mediaType, ./charset
      language./language
      data./data
      url./reference/literal
      sizeN/A (needs data type R3 proposal)
      hash.integrityCheck[parent::ED/integrityCheckAlgorithm="SHA-1"]
      title./title/data
      creationN/A (needs data type R3 proposal)

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

MHVimagingExam
DiagnosticReport
   identifierFiveWs.identifier
   identifier (TOid)FiveWs.identifier
   identifier (accessionNumber)FiveWs.identifier
   identifier (casenum)FiveWs.identifier
   statusFiveWs.status
   categoryFiveWs.class
   category (us-core)FiveWs.class
   codeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   effective[x]FiveWs.done[x]
   effective[x] (effectiveDateTime)FiveWs.done[x]
   issuedFiveWs.recorded
   performerFiveWs.actor
   resultsInterpreterFiveWs.actor