AI Transparency on FHIR, published by HL7 International / Electronic Health Records. This guide is not an authorized publication; it is the continuous build for version 1.0.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/aitransparency-ig/ and changes regularly. See the Directory of published versions
Mappings for the AI-ModelCard resource profile.
| Name | Workflow Pattern | FHIR Composition | RIM Mapping | CDA (R2) | FiveWs Pattern Mapping | HL7 v2 Mapping | XDS metadata equivalent |
 DocumentReference |
Event |
when describing a Composition |
Document[classCode="DOC" and moodCode="EVN"] |
when describing a CDA |
|
|
|
  DocumentReference / id |
|
|
|
|
|
|
|
  DocumentReference / meta |
|
|
|
|
|
|
|
  DocumentReference / implicitRules |
|
|
|
|
|
|
|
  DocumentReference / language |
|
|
|
|
|
|
|
  DocumentReference / text |
|
|
Act.text? |
|
|
|
|
  DocumentReference / contained |
|
|
N/A |
|
|
|
|
  DocumentReference / extension |
|
|
N/A |
|
|
|
|
  DocumentReference / modifierExtension |
|
|
N/A |
|
|
|
|
  DocumentReference / masterIdentifier |
Event.identifier |
Composition.identifier |
.id |
ClinicalDocument/id |
FiveWs.identifier |
TXA-12 |
DocumentEntry.uniqueId |
  DocumentReference / identifier |
Event.identifier |
|
.id / .setId |
|
FiveWs.identifier |
TXA-16? |
DocumentEntry.entryUUID |
  DocumentReference / status |
Event.status |
|
- .completionCode="IN" & ./statusCode[isNormalDatatype()]="active"; final: .completionCode="AU" && ./statusCode[isNormalDatatype()]="complete" and not(./inboundRelationship[typeCode="SUBJ" and isNormalActRelationship()]/source[subsumesCode("ActClass#CACT") and moodCode="EVN" and domainMember("ReviseDocument"
- .completionCode="AU" && ./statusCode[isNormalDatatype()]="complete" and ./inboundRelationship[typeCode="SUBJ" and isNormalActRelationship()]/source[subsumesCode("ActClass#CACT") and moodCode="EVN" and domainMember("ReviseDocument"
- .completionCode=NI && ./statusCode[isNormalDatatype()]="obsolete"
|
|
FiveWs.status |
TXA-19 |
DocumentEntry.availabilityStatus |
  DocumentReference / docStatus |
|
Composition.status |
.statusCode |
|
FiveWs.status |
TXA-17 |
|
  DocumentReference / type |
Event.code |
Composition.type |
./code |
- ClinicalDocument/code/@code
The typeCode should be mapped from the ClinicalDocument/code element to a set of document type codes configured in the affinity domain. One suggested coding system to use for typeCode is LOINC
- in which case the mapping step can be omitted.
|
FiveWs.class |
TXA-2 |
DocumentEntry.type |
  DocumentReference / Slices for category |
|
Composition.class |
- .outboundRelationship[typeCode="COMP].target[classCode="LIST"
- moodCode="EVN"].code
|
- Derived from a mapping of /ClinicalDocument/code/@code to an Affinity Domain specified coded value to use and coding system. Affinity Domains are encouraged to use the appropriate value for Type of Service
- based on the LOINC Type of Service (see Page 53 of the LOINC User's Manual). Must be consistent with /ClinicalDocument/code/@code
|
FiveWs.class |
|
DocumentEntry.class |
   DocumentReference / Slices for category / category:AImodelCardMD |
|
Composition.class |
- .outboundRelationship[typeCode="COMP].target[classCode="LIST"
- moodCode="EVN"].code
|
- Derived from a mapping of /ClinicalDocument/code/@code to an Affinity Domain specified coded value to use and coding system. Affinity Domains are encouraged to use the appropriate value for Type of Service
- based on the LOINC Type of Service (see Page 53 of the LOINC User's Manual). Must be consistent with /ClinicalDocument/code/@code
|
FiveWs.class |
|
DocumentEntry.class |
   DocumentReference / Slices for category / category:AImodelCardCHAI |
|
Composition.class |
- .outboundRelationship[typeCode="COMP].target[classCode="LIST"
- moodCode="EVN"].code
|
- Derived from a mapping of /ClinicalDocument/code/@code to an Affinity Domain specified coded value to use and coding system. Affinity Domains are encouraged to use the appropriate value for Type of Service
- based on the LOINC Type of Service (see Page 53 of the LOINC User's Manual). Must be consistent with /ClinicalDocument/code/@code
|
FiveWs.class |
|
DocumentEntry.class |
  DocumentReference / subject |
Event.subject |
Composition.subject |
.participation[typeCode="SBJ"].role[typeCode="PAT"] |
ClinicalDocument/recordTarget/ |
FiveWs.subject |
PID-3 (No standard way to define a Practitioner or Group subject in HL7 v2 MDM message) |
DocumentEntry.patientId |
  DocumentReference / date |
Event.occurrence[x] |
Composition.date |
.availabilityTime[type="TS"] |
|
FiveWs.recorded |
|
|
  DocumentReference / author |
Event.performer.actor |
Composition.author |
.participation[typeCode="AUT"].role[classCode="ASSIGNED"] |
ClinicalDocument/author |
|
TXA-9 (No standard way to indicate a Device in HL7 v2 MDM message) |
DocumentEntry.author |
  DocumentReference / authenticator |
Event.performer.actor |
Composition.attester |
.participation[typeCode="AUTHEN"].role[classCode="ASSIGNED"] |
ClinicalDocument/legalAuthenticator |
FiveWs.witness |
TXA-10 |
DocumentEntry.legalAuthenticator |
  DocumentReference / custodian |
Event.performer.actor |
Composition.custodian |
.participation[typeCode="RCV"].role[classCode="CUST"].scoper[classCode="ORG" and determinerCode="INST"] |
|
|
|
|
  DocumentReference / relatesTo |
|
Composition.relatesTo |
.outboundRelationship |
|
|
|
DocumentEntry Associations |
   DocumentReference / relatesTo / id |
|
|
n/a |
|
|
|
|
   DocumentReference / relatesTo / extension |
|
|
n/a |
|
|
|
|
   DocumentReference / relatesTo / modifierExtension |
|
|
N/A |
|
|
|
|
   DocumentReference / relatesTo / code |
|
Composition.relatesTo.code |
.outboundRelationship.typeCode |
|
|
|
DocumentEntry Associations type |
   DocumentReference / relatesTo / target |
|
Composition.relatesTo.target |
- .target[classCode="DOC"
- moodCode="EVN"].id
|
|
|
|
DocumentEntry Associations reference |
  DocumentReference / description |
|
|
.outboundRelationship[typeCode="SUBJ"].target.text |
|
|
TXA-25 |
DocumentEntry.comments |
  DocumentReference / securityLabel |
|
- Composition.confidentiality
- Composition.meta.security
|
.confidentialityCode |
ClinicalDocument/confidentialityCode/@code |
|
TXA-18 |
DocumentEntry.confidentialityCode |
  DocumentReference / Slices for content |
|
Bundle(Composition+*) |
document.text |
|
|
|
|
   DocumentReference / Slices for content / content:All Slices |
|
|
|
|
|
|
|
    DocumentReference / Slices for content / content:All Slices / id |
|
|
n/a |
|
|
|
|
    DocumentReference / Slices for content / content:All Slices / extension |
|
|
n/a |
|
|
|
|
    DocumentReference / Slices for content / content:All Slices / modifierExtension |
|
|
N/A |
|
|
|
|
    DocumentReference / Slices for content / content:All Slices / attachment |
|
- Composition.language
-
Composition.title
-
Composition.date
|
document.text |
- ClinicalDocument/languageCode
- ClinicalDocument/title
- ClinicalDocument/date
|
|
TXA-3 for mime type |
- DocumentEntry.mimeType
- DocumentEntry.languageCode
- DocumentEntry.URI
- DocumentEntry.size
- DocumentEntry.hash
- DocumentEntry.title
- DocumentEntry.creationTime
|
    DocumentReference / Slices for content / content:All Slices / format |
|
Composition.meta.profile |
document.text |
derived from the IHE Profile or Implementation Guide templateID |
|
|
DocumentEntry.formatCode |
   DocumentReference / Slices for content / content:MarkdownFormat |
|
Bundle(Composition+*) |
document.text |
|
|
|
|
    DocumentReference / Slices for content / content:MarkdownFormat / id |
|
|
n/a |
|
|
|
|
    DocumentReference / Slices for content / content:MarkdownFormat / extension |
|
|
n/a |
|
|
|
|
    DocumentReference / Slices for content / content:MarkdownFormat / modifierExtension |
|
|
N/A |
|
|
|
|
    DocumentReference / Slices for content / content:MarkdownFormat / attachment |
|
- Composition.language
-
Composition.title
-
Composition.date
|
document.text |
- ClinicalDocument/languageCode
- ClinicalDocument/title
- ClinicalDocument/date
|
|
TXA-3 for mime type |
- DocumentEntry.mimeType
- DocumentEntry.languageCode
- DocumentEntry.URI
- DocumentEntry.size
- DocumentEntry.hash
- DocumentEntry.title
- DocumentEntry.creationTime
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / id |
|
|
n/a |
|
|
|
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / extension |
|
|
n/a |
|
|
|
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / contentType |
|
|
|
|
|
ED.2+ED.3/RP.2+RP.3. Note conversion may be needed if old style values are being used |
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / language |
|
|
./language |
|
|
|
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / data |
|
|
./data |
|
|
ED.5 |
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / url |
|
|
./reference/literal |
|
|
RP.1+RP.2 - if they refer to a URL (see v2.6) |
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / size |
|
|
N/A (needs data type R3 proposal) |
|
|
|
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / hash |
|
|
:ED/integrityCheckAlgorithm="SHA-1"] |
|
|
|
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / title |
|
|
./title/data |
|
|
|
|
     DocumentReference / Slices for content / content:MarkdownFormat / attachment / creation |
|
|
N/A (needs data type R3 proposal) |
|
|
|
|
    DocumentReference / Slices for content / content:MarkdownFormat / format |
|
Composition.meta.profile |
document.text |
derived from the IHE Profile or Implementation Guide templateID |
|
|
DocumentEntry.formatCode |
   DocumentReference / Slices for content / content:CHAIformat |
|
Bundle(Composition+*) |
document.text |
|
|
|
|
    DocumentReference / Slices for content / content:CHAIformat / id |
|
|
n/a |
|
|
|
|
    DocumentReference / Slices for content / content:CHAIformat / extension |
|
|
n/a |
|
|
|
|
    DocumentReference / Slices for content / content:CHAIformat / modifierExtension |
|
|
N/A |
|
|
|
|
    DocumentReference / Slices for content / content:CHAIformat / attachment |
|
- Composition.language
-
Composition.title
-
Composition.date
|
document.text |
- ClinicalDocument/languageCode
- ClinicalDocument/title
- ClinicalDocument/date
|
|
TXA-3 for mime type |
- DocumentEntry.mimeType
- DocumentEntry.languageCode
- DocumentEntry.URI
- DocumentEntry.size
- DocumentEntry.hash
- DocumentEntry.title
- DocumentEntry.creationTime
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / id |
|
|
n/a |
|
|
|
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / extension |
|
|
n/a |
|
|
|
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / contentType |
|
|
|
|
|
ED.2+ED.3/RP.2+RP.3. Note conversion may be needed if old style values are being used |
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / language |
|
|
./language |
|
|
|
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / data |
|
|
./data |
|
|
ED.5 |
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / url |
|
|
./reference/literal |
|
|
RP.1+RP.2 - if they refer to a URL (see v2.6) |
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / size |
|
|
N/A (needs data type R3 proposal) |
|
|
|
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / hash |
|
|
:ED/integrityCheckAlgorithm="SHA-1"] |
|
|
|
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / title |
|
|
./title/data |
|
|
|
|
     DocumentReference / Slices for content / content:CHAIformat / attachment / creation |
|
|
N/A (needs data type R3 proposal) |
|
|
|
|
    DocumentReference / Slices for content / content:CHAIformat / format |
|
Composition.meta.profile |
document.text |
derived from the IHE Profile or Implementation Guide templateID |
|
|
DocumentEntry.formatCode |
  DocumentReference / context |
|
|
outboundRelationship[typeCode="SUBJ"].target[classCode<'ACT'] |
|
|
|
|
   DocumentReference / context / id |
|
|
n/a |
|
|
|
|
   DocumentReference / context / extension |
|
|
n/a |
|
|
|
|
   DocumentReference / context / modifierExtension |
|
|
N/A |
|
|
|
|
   DocumentReference / context / encounter |
Event.context |
Composition.encounter |
- unique(highest(./outboundRelationship[typeCode="SUBJ" and isNormalActRelationship()]
- priorityNumber)/target[moodCode="EVN" and classCode=("ENC"
- "PCPR") and isNormalAct])
|
|
FiveWs.context |
|
|
   DocumentReference / context / event |
|
Composition.event.code |
.code |
|
|
|
DocumentEntry.eventCodeList |
   DocumentReference / context / period |
|
Composition.event.period |
.effectiveTime |
ClinicalDocument/documentationOf/
serviceEvent/effectiveTime/low/
@value --> ClinicalDocument/documentationOf/
serviceEvent/effectiveTime/high/
@value |
|
|
- DocumentEntry.serviceStartTime
- DocumentEntry.serviceStopTime
|
   DocumentReference / context / facilityType |
|
usually from a mapping to a local ValueSet |
.participation[typeCode="LOC"].role[classCode="DSDLOC"].code |
usually a mapping to a local ValueSet. Must be consistent with /clinicalDocument/code |
|
|
DocumentEntry.healthcareFacilityTypeCode |
   DocumentReference / context / practiceSetting |
|
usually from a mapping to a local ValueSet |
.participation[typeCode="LOC"].role[classCode="DSDLOC"].code |
usually from a mapping to a local ValueSet |
|
|
DocumentEntry.practiceSettingCode |
   DocumentReference / context / sourcePatientInfo |
|
Composition.subject |
.participation[typeCode="SBJ"].role[typeCode="PAT"] |
ClinicalDocument/recordTarget/ |
|
|
- DocumentEntry.sourcePatientInfo
- DocumentEntry.sourcePatientId
|
   DocumentReference / context / related |
|
Composition.event.detail |
./outboundRelationship[typeCode="PERT" and isNormalActRelationship()] / target[isNormalAct] |
ClinicalDocument/relatedDocument |
|
|
DocumentEntry.referenceIdList |
Documentation for this format |