臺灣社政領域基礎實作指引
0.0.1 - ci-build

臺灣社政領域基礎實作指引, published by 衛生福利部社會及家庭署. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/sfaassn2025-source/base/ and changes regularly. See the Directory of published versions

Resource Profile: DocumentReferenceTWSSBase - Mappings

Draft as of 2026-10-21

Mappings for the DocumentReference-twss-base resource profile.

Mappings to Structures in this Implementation Guide

NameMapping to TWSSBase DocumentReferencedoco
DocumentReference
    DocumentReference / id
      DocumentReference / meta
        DocumentReference / implicitRules
          DocumentReference / language
            DocumentReference / text
              DocumentReference / contained
                DocumentReference / extension
                  DocumentReference / modifierExtension
                    DocumentReference / masterIdentifier
                    DocumentReference / identifier
                      DocumentReference / status
                        DocumentReference / docStatus
                          DocumentReference / type
                          DocumentReference / category
                            DocumentReference / subject
                              DocumentReference / date
                                DocumentReference / author
                                  DocumentReference / authenticator
                                    DocumentReference / custodian
                                      DocumentReference / relatesTo
                                        DocumentReference / relatesTo / id
                                          DocumentReference / relatesTo / extension
                                            DocumentReference / relatesTo / modifierExtension
                                              DocumentReference / relatesTo / code
                                                DocumentReference / relatesTo / target
                                                  DocumentReference / description
                                                    DocumentReference / securityLabel
                                                      DocumentReference / content
                                                        DocumentReference / content / id
                                                          DocumentReference / content / extension
                                                            DocumentReference / content / modifierExtension
                                                              DocumentReference / content / attachment
                                                                DocumentReference / content / attachment / id
                                                                  DocumentReference / content / attachment / extension
                                                                    DocumentReference / content / attachment / contentType
                                                                      DocumentReference / content / attachment / language
                                                                        DocumentReference / content / attachment / data
                                                                          DocumentReference / content / attachment / url
                                                                            DocumentReference / content / attachment / size
                                                                              DocumentReference / content / attachment / hash
                                                                                DocumentReference / content / attachment / title
                                                                                  DocumentReference / content / attachment / creation
                                                                                  DocumentReference / content / format
                                                                                    DocumentReference / context
                                                                                      DocumentReference / context / id
                                                                                        DocumentReference / context / extension
                                                                                          DocumentReference / context / modifierExtension
                                                                                            DocumentReference / context / encounter
                                                                                              DocumentReference / context / event
                                                                                                DocumentReference / context / period
                                                                                                  DocumentReference / context / facilityType
                                                                                                    DocumentReference / context / practiceSetting
                                                                                                      DocumentReference / context / sourcePatientInfo
                                                                                                        DocumentReference / context / related

                                                                                                          doco Documentation for this format

                                                                                                          Mappings to other Structures

                                                                                                          No Mappings Found

                                                                                                          Other Mappings

                                                                                                          NameWorkflow PatternFHIR CompositionRIM MappingCDA (R2)FiveWs Pattern MappingHL7 v2 MappingXDS metadata equivalentdoco
                                                                                                          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 / 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 / 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 / content
                                                                                                          Bundle(Composition+*)
                                                                                                          document.text
                                                                                                          DocumentReference / content / id
                                                                                                          n/a
                                                                                                          DocumentReference / content / extension
                                                                                                          n/a
                                                                                                          DocumentReference / content / modifierExtension
                                                                                                          N/A
                                                                                                          DocumentReference / content / 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 / content / attachment / id
                                                                                                          n/a
                                                                                                          DocumentReference / content / attachment / extension
                                                                                                          n/a
                                                                                                          DocumentReference / content / attachment / contentType
                                                                                                          • ./mediaType
                                                                                                          • ./charset
                                                                                                          ED.2+ED.3/RP.2+RP.3. Note conversion may be needed if old style values are being used
                                                                                                          DocumentReference / content / attachment / language
                                                                                                          ./language
                                                                                                          DocumentReference / content / attachment / data
                                                                                                          ./data
                                                                                                          ED.5
                                                                                                          DocumentReference / content / attachment / url
                                                                                                          ./reference/literal
                                                                                                          RP.1+RP.2 - if they refer to a URL (see v2.6)
                                                                                                          DocumentReference / content / attachment / size
                                                                                                          N/A (needs data type R3 proposal)
                                                                                                          DocumentReference / content / attachment / hash
                                                                                                          :ED/integrityCheckAlgorithm="SHA-1"]
                                                                                                          DocumentReference / content / attachment / title
                                                                                                          ./title/data
                                                                                                          DocumentReference / content / attachment / creation
                                                                                                          N/A (needs data type R3 proposal)
                                                                                                          DocumentReference / content / 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

                                                                                                          doco Documentation for this format