CodeX Radiation Therapy
2.0.0 - STU2 flag

CodeX Radiation Therapy, published by HL7 International / Cross-Group Projects. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/codex-radiation-therapy/ and changes regularly. See the Directory of published versions

Resource Profile: RadiotherapyTreatedFraction - Mappings

Draft as of 2025-02-17

Mappings for the codexrt-radiotherapy-treated-fraction resource profile.

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

RadiotherapyTreatedFraction
ProcedureEvent
   identifierEvent.identifier
   identifier (displayName)Event.identifier
   identifier (official)Event.identifier
   instantiatesCanonicalEvent.instantiatesCanonical
   instantiatesUriEvent.instantiatesUri
   basedOnEvent.basedOn
   basedOn (treatment-plan)Event.basedOn
   basedOn (planned-phase)Event.basedOn
   partOfEvent.partOf
   partOf (treated-plan)Event.partOf
   partOf (treated-phase)Event.partOf
   statusEvent.status
   statusReasonEvent.statusReason
   codeEvent.code
   subjectEvent.subject
   encounterEvent.context
   performed[x]Event.occurrence[x]
   performerEvent.performer
      functionEvent.performer.function
      actorEvent.performer.actor
   performer (organization)Event.performer
      functionEvent.performer.function
      actorEvent.performer.actor
   reasonCodeEvent.reasonCode
   reasonReferenceEvent.reasonReference
   noteEvent.note

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

RadiotherapyTreatedFraction
ProcedureEntity. Role, or Act, Procedure[moodCode=EVN]
   textAct.text?
   containedN/A
   extension
   extension (modalityAndTechnique)
      idn/a
      extension
      extension (modality)
         idn/a
         urlN/A
         value[x]N/A
      extension (technique)
         idn/a
         urlN/A
         value[x]N/A
      extension (radiotherapyEnergyOrIsotope)
      extension (radiotherapyTreatmentApplicatorType)
      urlN/A
   extension (imageGuidedRadiotherapyModality)
   extension (doseDeliveredToVolume)
      idn/a
      extension
      extension (volume)
         idn/a
         urlN/A
         value[x]N/A
      extension (totalDoseDelivered)
         idn/a
         urlN/A
         value[x]N/A
      urlN/A
   modifierExtensionN/A
   identifier.id
   identifier (displayName).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 (official).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
   instantiatesCanonical.outboundRelationship[typeCode=DEFN].target
   instantiatesUri.outboundRelationship[typeCode=DEFN].target
   basedOn.outboundRelationship[typeCode=FLFS].target[classCode=(various e.g. PROC, OBS, PCPR, ACT, moodCode=RQO].code
   basedOn (treatment-plan).outboundRelationship[typeCode=FLFS].target[classCode=(various e.g. PROC, OBS, PCPR, ACT, moodCode=RQO].code
   basedOn (planned-phase).outboundRelationship[typeCode=FLFS].target[classCode=(various e.g. PROC, OBS, PCPR, ACT, moodCode=RQO].code
   partOf.inboundRelationship[typeCode=COMP].source[classCode=SBADM or PROC or OBS, moodCode=EVN]
   partOf (treated-plan).inboundRelationship[typeCode=COMP].source[classCode=SBADM or PROC or OBS, moodCode=EVN]
   partOf (treated-phase).inboundRelationship[typeCode=COMP].source[classCode=SBADM or PROC or OBS, moodCode=EVN]
   statusstatusCode
   statusReason.reason.Observation.value
   category.outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="EVN"].code
   code.code
   subject.participation[typeCode=SBJ].role
   encounter.inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN]
   performed[x].effectiveTime
      idn/a
      extensionn/a
      start./low
      end./high
   recorder.participation[typeCode=AUT].role
   asserter.participation[typeCode=INF].role
   performer.participation[typeCode=PRF]
      idn/a
      extensionn/a
      modifierExtensionN/A
      function.functionCode
      actor.role
      onBehalfOf.scoper
   performer (organization).participation[typeCode=PRF]
      idn/a
      extensionn/a
      modifierExtensionN/A
      function.functionCode
      actor.role
      onBehalfOf.scoper
   location.participation[typeCode=LOC].role[classCode=SDLOC]
   reasonCode.reasonCode
   reasonReference.reasonCode
   bodySite.targetSiteCode
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data
   outcome.outboundRelationship[typeCode=OUT].target.text
   report.inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN]
   complication.outboundRelationship[typeCode=OUTC].target[classCode=OBS, code="complication", moodCode=EVN].value
   complicationDetail.outboundRelationship[typeCode=OUTC].target[classCode=OBS, code="complication", moodCode=EVN].value
   followUp.outboundRelationship[typeCode=COMP].target[classCode=ACT, moodCode=INT].code
   note.inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="annotation"].value
   focalDevice.participation[typeCode=DEV].role[classCode=MANU]
      idn/a
      extensionn/a
      modifierExtensionN/A
      action.inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="procedure device action"].value=:procedure device action codes
      manipulated.participation[typeCode=DEV].role[classCode=SDLOC]
   focalDevice (seedDevice).participation[typeCode=DEV].role[classCode=MANU]
      idn/a
      extensionn/a
      modifierExtensionN/A
      action.inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="procedure device action"].value=:procedure device action codes
      manipulated.participation[typeCode=DEV].role[classCode=SDLOC]
   usedReference.participation[typeCode=DEV].role[classCode=MANU] or .participation[typeCode=CSM].role[classCode=ADMM] (for Medication or Substance)
   usedReference (treatmentDevice).participation[typeCode=DEV].role[classCode=MANU] or .participation[typeCode=CSM].role[classCode=ADMM] (for Medication or Substance)
   usedCodeparticipation[typeCode=Dev].role[classCode=MANU]

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

RadiotherapyTreatedFraction
Procedure
   identifierFiveWs.identifier
   identifier (displayName)FiveWs.identifier
   identifier (official)FiveWs.identifier
   statusFiveWs.status
   categoryFiveWs.class
   codeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   performed[x]FiveWs.done[x]
   recorderFiveWs.author
   asserterFiveWs.source
   performer
      actorFiveWs.actor
   performer (organization)
      actorFiveWs.actor
   locationFiveWs.where[x]
   reasonCodeFiveWs.why[x]
   reasonReferenceFiveWs.why[x]

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

RadiotherapyTreatedFraction
Procedure
   identifierSome combination of ORC-2 / ORC-3 / OBR-2 / OBR-3 / IPC-1 / IPC-2 / IPC-3 / IPC-4
   identifier (displayName)Some combination of ORC-2 / ORC-3 / OBR-2 / OBR-3 / IPC-1 / IPC-2 / IPC-3 / IPC-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 (official)Some combination of ORC-2 / ORC-3 / OBR-2 / OBR-3 / IPC-1 / IPC-2 / IPC-3 / IPC-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)
   codeOBR-44/OBR-45
   subjectPID-3
   encounterPV1-19
   performed[x]OBR-7
      startDR.1
      endDR.2
   performer
      functionSome combination of STF-18 / PRA-3 / PRT-4 / ROL-3 / ORC-12 / OBR-16 / PV1-7 / PV1-8 / PV1-9 / PV1-17 / OBX-25
      actorORC-19/PRT-5
   performer (organization)
      functionSome combination of STF-18 / PRA-3 / PRT-4 / ROL-3 / ORC-12 / OBR-16 / PV1-7 / PV1-8 / PV1-9 / PV1-17 / OBX-25
      actorORC-19/PRT-5
   bodySiteOBX-20
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this
   noteNTE