minimal Common Oncology Data Elements (mCODE) Implementation Guide
3.0.0 - STU3 Release United States of America flag

This page is part of the HL7 FHIR Implementation Guide: minimal Common Oncology Data Elements (mCODE) Release 1 - US Realm | STU1 (v3.0.0: STU 3) based on FHIR R4. This is the current published version. For a full list of available versions, see the Directory of published versions

Resource Profile: HumanSpecimen - Mappings

Draft as of 2023-10-26 Maturity Level: 1

Mappings for the mcode-human-specimen resource profile.

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

HumanSpecimen
SpecimenEntity. Role, or Act, Role[classCode=SPEC]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifier.id
   identifier (bodyStructureIdentifier)n/a, II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
      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
   accessionIdentifier.participation[typeCode=SBJ].act[classCode=ACSN, moodCode=EVN].id
   statusstatus
   type.code
   subject.scoper or .scoper.playsRole
   receivedTime.participation[typeCode=SBJ].act[code=SPCREC, moodCode=EVN].effectiveTime
   parent.scoper (if parent) .player.scopesRole[classCode=SPEC].player (if child)
   requestoutboundRelationship[typeCode=FLFS].target
   collection.participation[typeCode=SBJ].act[classCode=SPECCOLLECT, moodCode=EVN]
      idn/a
      extensionn/a
      modifierExtensionN/A
      collector.participation[typeCode=PFM].role
      collected[x].effectiveTime
      quantity.participation[typeCode=SBJ].role[classCode=SPEC].player.quantity
      method.methodCode
      bodySite.targetSiteCode
         idn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
   processing.participation[typeCode=SBJ].act[code=SPCTRT, moodCode=EVN]
      idn/a
      extensionn/a
      modifierExtensionN/A
      description.text
      procedure.code
      additive.participation[typeCode=CSM].role[classCode=ADTV].code
      time[x].effectiveTime
   container.player.scopingRole[classCode=CONT].scoper
      idn/a
      extensionn/a
      modifierExtensionN/A
      identifier.id
      description.desc
      type.code
      capacity.quantity
      specimenQuantity.playedRole[classCode=CONT].quantity
      additive[x].scopesRole[classCode=ADTV].player
   note.inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code="annotation"].value

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

HumanSpecimen
Specimen
   identifierFiveWs.identifier
   accessionIdentifierFiveWs.identifier
   statusFiveWs.status
   typeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   receivedTimeFiveWs.done[x]
   requestFiveWs.why[x]
   collection
      collectorFiveWs.actor
      collected[x]FiveWs.init
      durationFiveWs.init

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

HumanSpecimen
Specimen
   identifierSPM-2
   identifier (bodyStructureIdentifier)CX / EI (occasionally, more often EI maps to a resource id or a URL)
      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)
   accessionIdentifierSPM-30 (v2.7+)
   statusSPM-20
   typeSPM-4 and possibly SPM-5
   receivedTimeSPM-18
   requestORC? OBR-2/3?
   collectionSPM-14
      collectorPRT
      collected[x]SPM-17
      quantitySPM-12
      methodSPM-7
      bodySiteSPM-8 and SPM-9
         codingC*E.1-8, C*E.10-22
         textC*E.9. But note many systems use C*E.2 for this
      fastingStatus[x]OBR-
   processing
      additiveSPM-6
   container
      identifierSAC-3
      typeSPM-27
      capacityone of: SAC 16, SAC17 and SAC 20, or SAC 21 and SAC 20
      specimenQuantitySAC-23 (value) SAC-24 (units
      additive[x]SAC-27
   conditionSPM-24
   noteOBX