Advance Healthcare Directive Interoperability (cda-adi)
0.1.0 - ci-build

Advance Healthcare Directive Interoperability (cda-adi), published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cda-adi/ and changes regularly. See the Directory of published versions

Logical Model: ADI External Entry Reference Entry

Official URL: http://hl7.org/cda/us/adi/StructureDefinition/External.Entry.Reference.Entry Version: 0.1.0
Draft as of 2026-06-19 Computable Name: External_Entry_Reference_Entry
Other Identifiers: urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#urn:hl7ii:2.16.840.1.113883.4.823.1.4.2.5:2026-08-28

This entry represents the act of referencing another an external entry not include in this CDA document instance.

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Template Content

Description of Template, Differentials, Snapshots and how the different presentations work.

This structure is derived from EntryReference

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Act C 1..1 EntryReference XML Namespace: urn:hl7-org:v3
Base for all types and resources
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
Constraints: should-text-ref-value
... Slices for templateId 2..* II Slice: Unordered, Open by value:root, value:extension
.... templateId:external-entry-reference 1..1 II
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.4.823.1.4.2.5
..... @extension 1..1 st(2.0.3-sd) Required Pattern: 2026-08-28
... id 1..* II When using a FHIR Collection Bundle for the entries, use the Resource name/Resource id as the id value. For example, if the entry is a FHIR Patient resource with id 123, then the id value would be 'Condition/123'.
... text 0..1 ED links to the rendering of the entry information contained in the externally referenced Resource.
.... reference C 0..1 TEL Constraints: value-starts-octothorpe
.... @typeCode 1..1 cs(2.0.3-sd) Fixed Value: REFR
.... externalAct 0..1 ExternalAct
.... externalObservation 0..1 ExternalObservation
.... externalProcedure 0..1 ExternalProcedure
.... externalDocument 0..1 ExternalDocument

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
should-text-ref-value warning Act SHOULD contain text/reference/@value text.reference.value.exists()
value-starts-octothorpe error Act.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Act C 1..1 EntryReference XML Namespace: urn:hl7-org:v3
Base for all types and resources
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
Constraints: should-text-ref-value
... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
... realmCode 0..* CS
... typeId C 0..1 II Constraints: II-1
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @assigningAuthorityName 0..1 st(2.0.3-sd)
.... @displayable 0..1 bl(2.0.3-sd)
.... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Fixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1 st(2.0.3-sd)
.... templateId:entry-reference 1..1 II
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.10.20.22.4.122
.... templateId:external-entry-reference 1..1 II
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.4.823.1.4.2.5
..... @extension 1..1 st(2.0.3-sd) Required Pattern: 2026-08-28
... @classCode 1..1 cs(2.0.3-sd) Binding: XActClassDocumentEntryAct (2.0.0) (required)
Fixed Value: ACT
... @moodCode 1..1 cs(2.0.3-sd) Binding: XDocumentActMood (2.0.0) (required)
Fixed Value: EVN
... @negationInd 0..1 bl(2.0.3-sd)
... id 1..* II When using a FHIR Collection Bundle for the entries, use the Resource name/Resource id as the id value. For example, if the entry is a FHIR Patient resource with id 123, then the id value would be 'Condition/123'.
.... @assigningAuthorityName 0..1 st(2.0.3-sd)
.... @displayable 0..1 bl(2.0.3-sd)
.... @root 0..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd)
.... @extension 0..1 st(2.0.3-sd)
... code 1..1 CD Binding: ActCode (3.0.0) (example)
.... @nullFlavor 1..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
Fixed Value: NP
.... @code 0..1 cs(2.0.3-sd)
.... @codeSystem 0..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd)
.... @codeSystemName 0..1 st(2.0.3-sd)
.... @codeSystemVersion 0..1 st(2.0.3-sd)
.... @displayName 0..1 st(2.0.3-sd)
.... @sdtcValueSet 0..1 oid(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1 st(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
.... originalText 0..1 ED
.... qualifier 0..* CR
.... translation 0..* CD
... text C 0..1 ED links to the rendering of the entry information contained in the externally referenced Resource.
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @compression 0..1 cs(2.0.3-sd) Binding: CDACompressionAlgorithm (2.0.3-sd) (required)
.... @integrityCheck 0..1 bin(2.0.3-sd)
.... @integrityCheckAlgorithm 0..1 cs(2.0.3-sd) Binding: IntegrityCheckAlgorithm (2.0.0) (required)
.... @language 0..1 cs(2.0.3-sd)
.... @mediaType 0..1 cs(2.0.3-sd) Binding: MediaType (3.0.0) (example)
.... @representation 0..1 cs(2.0.3-sd) Binding: BinaryDataEncoding (2.0.3-sd) (required)
.... xmlText 0..1 st(2.0.3-sd) Allows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
.... reference C 0..1 TEL Constraints: value-starts-octothorpe
.... thumbnail C 0..1 ED Constraints: ED-1
... statusCode 1..1 CS Binding: ActStatus (3.0.0) (required)
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @code 0..1 cs(2.0.3-sd) MAY be set to "completed"
.... @sdtcValueSet 0..1 oid(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1 st(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
... effectiveTime 0..1 IVL_TS
... priorityCode 0..1 CE Binding: ActPriority (3.0.0) (example)
... languageCode 0..1 CS Binding: AllLanguages (required)
... subject 0..1 Subject
... specimen 0..* Specimen
... performer 0..* Performer2
... author 0..* Author
... informant 0..* Informant
... participant 0..* Participant2
... entryRelationship 0..* EntryRelationship
... reference 1..1 Reference
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st(2.0.3-sd)
.... templateId 0..* II
.... @typeCode 1..1 cs(2.0.3-sd) Binding: XActRelationshipExternalReference (3.0.0) (required)
Fixed Value: REFR
.... seperatableInd 0..1 BL
.... externalAct 0..1 ExternalAct
.... externalObservation 0..1 ExternalObservation
.... externalProcedure 0..1 ExternalProcedure
.... externalDocument 0..1 ExternalDocument
... precondition 0..* Precondition
... sdtcPrecondition2 0..* Precondition2 XML Namespace: urn:hl7-org:sdtc
XML: precondition2 (urn:hl7-org:sdtc)
... sdtcInFulfillmentOf1 0..* InFulfillmentOf1 XML Namespace: urn:hl7-org:sdtc
XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Act.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.typeId.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.templateId:entry-reference.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.templateId:external-entry-reference.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.classCode Base required x_ActClassDocumentEntryAct 📍2.0.0 THO v5.2
Act.moodCode Base required x_DocumentActMood 📍2.0.0 THO v5.2
Act.code Base example v3 Code System ActCode 📍3.0.0 THO v7.1
Act.code.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.compression Base required CDACompressionAlgorithm 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.integrityCheckAlgorithm Base required IntegrityCheckAlgorithm 📍2.0.0 THO v5.2
Act.text.mediaType Base example MediaType 📍3.0.0 THO v7.1
Act.text.representation Base required CDABinaryDataEncoding 📍2.0.3-sd Clinical Document Architecture v2.0
Act.statusCode Base required ActStatus 📍3.0.0 THO v7.1
Act.statusCode.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.priorityCode Base example ActPriority 📍3.0.0 THO v7.1
Act.languageCode Base required All Languages 📦5.0.0 FHIR Std.
Act.reference.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.reference.typeId.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.reference.typeCode Base required x_ActRelationshipExternalReference 📍3.0.0 THO v7.1

Constraints

Id Grade Path(s) Description Expression
ED-1 error Act.text.thumbnail Thumbnails cannot contain their own thumbnails thumbnail.empty()
II-1 error Act.typeId, Act.reference.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
should-text-ref-value warning Act SHOULD contain text/reference/@value text.reference.value.exists()
value-starts-octothorpe error Act.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Act C 1..1 EntryReference XML Namespace: urn:hl7-org:v3
Base for all types and resources
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
Constraints: should-text-ref-value
... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
... realmCode 0..* CS
... typeId C 0..1 II Constraints: II-1
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @assigningAuthorityName 0..1 st(2.0.3-sd)
.... @displayable 0..1 bl(2.0.3-sd)
.... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Fixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1 st(2.0.3-sd)
.... templateId:entry-reference 1..1 II
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.10.20.22.4.122
.... templateId:external-entry-reference 1..1 II
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.4.823.1.4.2.5
..... @extension 1..1 st(2.0.3-sd) Required Pattern: 2026-08-28
... @classCode 1..1 cs(2.0.3-sd) Binding: XActClassDocumentEntryAct (2.0.0) (required)
Fixed Value: ACT
... @moodCode 1..1 cs(2.0.3-sd) Binding: XDocumentActMood (2.0.0) (required)
Fixed Value: EVN
... @negationInd 0..1 bl(2.0.3-sd)
... id 1..* II When using a FHIR Collection Bundle for the entries, use the Resource name/Resource id as the id value. For example, if the entry is a FHIR Patient resource with id 123, then the id value would be 'Condition/123'.
.... @assigningAuthorityName 0..1 st(2.0.3-sd)
.... @displayable 0..1 bl(2.0.3-sd)
.... @root 0..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd)
.... @extension 0..1 st(2.0.3-sd)
... code 1..1 CD Binding: ActCode (3.0.0) (example)
.... @nullFlavor 1..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
Fixed Value: NP
.... @code 0..1 cs(2.0.3-sd)
.... @codeSystem 0..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd)
.... @codeSystemName 0..1 st(2.0.3-sd)
.... @codeSystemVersion 0..1 st(2.0.3-sd)
.... @displayName 0..1 st(2.0.3-sd)
.... @sdtcValueSet 0..1 oid(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1 st(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
.... originalText 0..1 ED
.... qualifier 0..* CR
.... translation 0..* CD
... text C 0..1 ED links to the rendering of the entry information contained in the externally referenced Resource.
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @compression 0..1 cs(2.0.3-sd) Binding: CDACompressionAlgorithm (2.0.3-sd) (required)
.... @integrityCheck 0..1 bin(2.0.3-sd)
.... @integrityCheckAlgorithm 0..1 cs(2.0.3-sd) Binding: IntegrityCheckAlgorithm (2.0.0) (required)
.... @language 0..1 cs(2.0.3-sd)
.... @mediaType 0..1 cs(2.0.3-sd) Binding: MediaType (3.0.0) (example)
.... @representation 0..1 cs(2.0.3-sd) Binding: BinaryDataEncoding (2.0.3-sd) (required)
.... xmlText 0..1 st(2.0.3-sd) Allows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
.... reference C 0..1 TEL Constraints: value-starts-octothorpe
.... thumbnail C 0..1 ED Constraints: ED-1
... statusCode 1..1 CS Binding: ActStatus (3.0.0) (required)
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @code 0..1 cs(2.0.3-sd) MAY be set to "completed"
.... @sdtcValueSet 0..1 oid(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1 st(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
... effectiveTime 0..1 IVL_TS
... priorityCode 0..1 CE Binding: ActPriority (3.0.0) (example)
... languageCode 0..1 CS Binding: AllLanguages (required)
... subject 0..1 Subject
... specimen 0..* Specimen
... performer 0..* Performer2
... author 0..* Author
... informant 0..* Informant
... participant 0..* Participant2
... entryRelationship 0..* EntryRelationship
... reference 1..1 Reference
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st(2.0.3-sd)
.... templateId 0..* II
.... @typeCode 1..1 cs(2.0.3-sd) Binding: XActRelationshipExternalReference (3.0.0) (required)
Fixed Value: REFR
.... seperatableInd 0..1 BL
.... externalAct 0..1 ExternalAct
.... externalObservation 0..1 ExternalObservation
.... externalProcedure 0..1 ExternalProcedure
.... externalDocument 0..1 ExternalDocument
... precondition 0..* Precondition
... sdtcPrecondition2 0..* Precondition2 XML Namespace: urn:hl7-org:sdtc
XML: precondition2 (urn:hl7-org:sdtc)
... sdtcInFulfillmentOf1 0..* InFulfillmentOf1 XML Namespace: urn:hl7-org:sdtc
XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Act.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.typeId.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.templateId:entry-reference.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.templateId:external-entry-reference.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.classCode Base required x_ActClassDocumentEntryAct 📍2.0.0 THO v5.2
Act.moodCode Base required x_DocumentActMood 📍2.0.0 THO v5.2
Act.code Base example v3 Code System ActCode 📍3.0.0 THO v7.1
Act.code.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.compression Base required CDACompressionAlgorithm 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.integrityCheckAlgorithm Base required IntegrityCheckAlgorithm 📍2.0.0 THO v5.2
Act.text.mediaType Base example MediaType 📍3.0.0 THO v7.1
Act.text.representation Base required CDABinaryDataEncoding 📍2.0.3-sd Clinical Document Architecture v2.0
Act.statusCode Base required ActStatus 📍3.0.0 THO v7.1
Act.statusCode.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.priorityCode Base example ActPriority 📍3.0.0 THO v7.1
Act.languageCode Base required All Languages 📦5.0.0 FHIR Std.
Act.reference.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.reference.typeId.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.reference.typeCode Base required x_ActRelationshipExternalReference 📍3.0.0 THO v7.1

Constraints

Id Grade Path(s) Description Expression
ED-1 error Act.text.thumbnail Thumbnails cannot contain their own thumbnails thumbnail.empty()
II-1 error Act.typeId, Act.reference.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
should-text-ref-value warning Act SHOULD contain text/reference/@value text.reference.value.exists()
value-starts-octothorpe error Act.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')

This structure is derived from EntryReference

Summary

Mandatory: 4 elements
Fixed: 1 element

Slices

This structure defines the following Slices:

  • The element 2 is sliced based on the values of Act.templateId

Differential View

This structure is derived from EntryReference

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Act C 1..1 EntryReference XML Namespace: urn:hl7-org:v3
Base for all types and resources
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
Constraints: should-text-ref-value
... Slices for templateId 2..* II Slice: Unordered, Open by value:root, value:extension
.... templateId:external-entry-reference 1..1 II
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.4.823.1.4.2.5
..... @extension 1..1 st(2.0.3-sd) Required Pattern: 2026-08-28
... id 1..* II When using a FHIR Collection Bundle for the entries, use the Resource name/Resource id as the id value. For example, if the entry is a FHIR Patient resource with id 123, then the id value would be 'Condition/123'.
... text 0..1 ED links to the rendering of the entry information contained in the externally referenced Resource.
.... reference C 0..1 TEL Constraints: value-starts-octothorpe
.... @typeCode 1..1 cs(2.0.3-sd) Fixed Value: REFR
.... externalAct 0..1 ExternalAct
.... externalObservation 0..1 ExternalObservation
.... externalProcedure 0..1 ExternalProcedure
.... externalDocument 0..1 ExternalDocument

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
should-text-ref-value warning Act SHOULD contain text/reference/@value text.reference.value.exists()
value-starts-octothorpe error Act.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Act C 1..1 EntryReference XML Namespace: urn:hl7-org:v3
Base for all types and resources
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
Constraints: should-text-ref-value
... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
... realmCode 0..* CS
... typeId C 0..1 II Constraints: II-1
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @assigningAuthorityName 0..1 st(2.0.3-sd)
.... @displayable 0..1 bl(2.0.3-sd)
.... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Fixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1 st(2.0.3-sd)
.... templateId:entry-reference 1..1 II
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.10.20.22.4.122
.... templateId:external-entry-reference 1..1 II
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.4.823.1.4.2.5
..... @extension 1..1 st(2.0.3-sd) Required Pattern: 2026-08-28
... @classCode 1..1 cs(2.0.3-sd) Binding: XActClassDocumentEntryAct (2.0.0) (required)
Fixed Value: ACT
... @moodCode 1..1 cs(2.0.3-sd) Binding: XDocumentActMood (2.0.0) (required)
Fixed Value: EVN
... @negationInd 0..1 bl(2.0.3-sd)
... id 1..* II When using a FHIR Collection Bundle for the entries, use the Resource name/Resource id as the id value. For example, if the entry is a FHIR Patient resource with id 123, then the id value would be 'Condition/123'.
.... @assigningAuthorityName 0..1 st(2.0.3-sd)
.... @displayable 0..1 bl(2.0.3-sd)
.... @root 0..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd)
.... @extension 0..1 st(2.0.3-sd)
... code 1..1 CD Binding: ActCode (3.0.0) (example)
.... @nullFlavor 1..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
Fixed Value: NP
.... @code 0..1 cs(2.0.3-sd)
.... @codeSystem 0..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd)
.... @codeSystemName 0..1 st(2.0.3-sd)
.... @codeSystemVersion 0..1 st(2.0.3-sd)
.... @displayName 0..1 st(2.0.3-sd)
.... @sdtcValueSet 0..1 oid(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1 st(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
.... originalText 0..1 ED
.... qualifier 0..* CR
.... translation 0..* CD
... text C 0..1 ED links to the rendering of the entry information contained in the externally referenced Resource.
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @compression 0..1 cs(2.0.3-sd) Binding: CDACompressionAlgorithm (2.0.3-sd) (required)
.... @integrityCheck 0..1 bin(2.0.3-sd)
.... @integrityCheckAlgorithm 0..1 cs(2.0.3-sd) Binding: IntegrityCheckAlgorithm (2.0.0) (required)
.... @language 0..1 cs(2.0.3-sd)
.... @mediaType 0..1 cs(2.0.3-sd) Binding: MediaType (3.0.0) (example)
.... @representation 0..1 cs(2.0.3-sd) Binding: BinaryDataEncoding (2.0.3-sd) (required)
.... xmlText 0..1 st(2.0.3-sd) Allows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
.... reference C 0..1 TEL Constraints: value-starts-octothorpe
.... thumbnail C 0..1 ED Constraints: ED-1
... statusCode 1..1 CS Binding: ActStatus (3.0.0) (required)
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @code 0..1 cs(2.0.3-sd) MAY be set to "completed"
.... @sdtcValueSet 0..1 oid(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1 st(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
... effectiveTime 0..1 IVL_TS
... priorityCode 0..1 CE Binding: ActPriority (3.0.0) (example)
... languageCode 0..1 CS Binding: AllLanguages (required)
... subject 0..1 Subject
... specimen 0..* Specimen
... performer 0..* Performer2
... author 0..* Author
... informant 0..* Informant
... participant 0..* Participant2
... entryRelationship 0..* EntryRelationship
... reference 1..1 Reference
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st(2.0.3-sd)
.... templateId 0..* II
.... @typeCode 1..1 cs(2.0.3-sd) Binding: XActRelationshipExternalReference (3.0.0) (required)
Fixed Value: REFR
.... seperatableInd 0..1 BL
.... externalAct 0..1 ExternalAct
.... externalObservation 0..1 ExternalObservation
.... externalProcedure 0..1 ExternalProcedure
.... externalDocument 0..1 ExternalDocument
... precondition 0..* Precondition
... sdtcPrecondition2 0..* Precondition2 XML Namespace: urn:hl7-org:sdtc
XML: precondition2 (urn:hl7-org:sdtc)
... sdtcInFulfillmentOf1 0..* InFulfillmentOf1 XML Namespace: urn:hl7-org:sdtc
XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Act.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.typeId.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.templateId:entry-reference.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.templateId:external-entry-reference.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.classCode Base required x_ActClassDocumentEntryAct 📍2.0.0 THO v5.2
Act.moodCode Base required x_DocumentActMood 📍2.0.0 THO v5.2
Act.code Base example v3 Code System ActCode 📍3.0.0 THO v7.1
Act.code.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.compression Base required CDACompressionAlgorithm 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.integrityCheckAlgorithm Base required IntegrityCheckAlgorithm 📍2.0.0 THO v5.2
Act.text.mediaType Base example MediaType 📍3.0.0 THO v7.1
Act.text.representation Base required CDABinaryDataEncoding 📍2.0.3-sd Clinical Document Architecture v2.0
Act.statusCode Base required ActStatus 📍3.0.0 THO v7.1
Act.statusCode.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.priorityCode Base example ActPriority 📍3.0.0 THO v7.1
Act.languageCode Base required All Languages 📦5.0.0 FHIR Std.
Act.reference.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.reference.typeId.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.reference.typeCode Base required x_ActRelationshipExternalReference 📍3.0.0 THO v7.1

Constraints

Id Grade Path(s) Description Expression
ED-1 error Act.text.thumbnail Thumbnails cannot contain their own thumbnails thumbnail.empty()
II-1 error Act.typeId, Act.reference.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
should-text-ref-value warning Act SHOULD contain text/reference/@value text.reference.value.exists()
value-starts-octothorpe error Act.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Act C 1..1 EntryReference XML Namespace: urn:hl7-org:v3
Base for all types and resources
Instance of this type are validated by templateId
Logical Container: ClinicalDocument (CDA Class)
Constraints: should-text-ref-value
... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
... realmCode 0..* CS
... typeId C 0..1 II Constraints: II-1
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @assigningAuthorityName 0..1 st(2.0.3-sd)
.... @displayable 0..1 bl(2.0.3-sd)
.... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Fixed Value: 2.16.840.1.113883.1.3
.... @extension 1..1 st(2.0.3-sd)
.... templateId:entry-reference 1..1 II
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.10.20.22.4.122
.... templateId:external-entry-reference 1..1 II
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Required Pattern: 2.16.840.1.113883.4.823.1.4.2.5
..... @extension 1..1 st(2.0.3-sd) Required Pattern: 2026-08-28
... @classCode 1..1 cs(2.0.3-sd) Binding: XActClassDocumentEntryAct (2.0.0) (required)
Fixed Value: ACT
... @moodCode 1..1 cs(2.0.3-sd) Binding: XDocumentActMood (2.0.0) (required)
Fixed Value: EVN
... @negationInd 0..1 bl(2.0.3-sd)
... id 1..* II When using a FHIR Collection Bundle for the entries, use the Resource name/Resource id as the id value. For example, if the entry is a FHIR Patient resource with id 123, then the id value would be 'Condition/123'.
.... @assigningAuthorityName 0..1 st(2.0.3-sd)
.... @displayable 0..1 bl(2.0.3-sd)
.... @root 0..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd)
.... @extension 0..1 st(2.0.3-sd)
... code 1..1 CD Binding: ActCode (3.0.0) (example)
.... @nullFlavor 1..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
Fixed Value: NP
.... @code 0..1 cs(2.0.3-sd)
.... @codeSystem 0..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd)
.... @codeSystemName 0..1 st(2.0.3-sd)
.... @codeSystemVersion 0..1 st(2.0.3-sd)
.... @displayName 0..1 st(2.0.3-sd)
.... @sdtcValueSet 0..1 oid(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1 st(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
.... originalText 0..1 ED
.... qualifier 0..* CR
.... translation 0..* CD
... text C 0..1 ED links to the rendering of the entry information contained in the externally referenced Resource.
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @compression 0..1 cs(2.0.3-sd) Binding: CDACompressionAlgorithm (2.0.3-sd) (required)
.... @integrityCheck 0..1 bin(2.0.3-sd)
.... @integrityCheckAlgorithm 0..1 cs(2.0.3-sd) Binding: IntegrityCheckAlgorithm (2.0.0) (required)
.... @language 0..1 cs(2.0.3-sd)
.... @mediaType 0..1 cs(2.0.3-sd) Binding: MediaType (3.0.0) (example)
.... @representation 0..1 cs(2.0.3-sd) Binding: BinaryDataEncoding (2.0.3-sd) (required)
.... xmlText 0..1 st(2.0.3-sd) Allows for mixed text content. If @representation='B64', this SHALL be a base64binary string.
.... reference C 0..1 TEL Constraints: value-starts-octothorpe
.... thumbnail C 0..1 ED Constraints: ED-1
... statusCode 1..1 CS Binding: ActStatus (3.0.0) (required)
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... @code 0..1 cs(2.0.3-sd) MAY be set to "completed"
.... @sdtcValueSet 0..1 oid(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSet (urn:hl7-org:sdtc)
.... @sdtcValueSetVersion 0..1 st(2.0.3-sd) XML Namespace: urn:hl7-org:sdtc
XML: valueSetVersion (urn:hl7-org:sdtc)
... effectiveTime 0..1 IVL_TS
... priorityCode 0..1 CE Binding: ActPriority (3.0.0) (example)
... languageCode 0..1 CS Binding: AllLanguages (required)
... subject 0..1 Subject
... specimen 0..* Specimen
... performer 0..* Performer2
... author 0..* Author
... informant 0..* Informant
... participant 0..* Participant2
... entryRelationship 0..* EntryRelationship
... reference 1..1 Reference
.... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
.... realmCode 0..* CS
.... typeId C 0..1 II Constraints: II-1
..... @nullFlavor 0..1 cs(2.0.3-sd) Binding: CDANullFlavor (2.0.3-sd) (required)
..... @assigningAuthorityName 0..1 st(2.0.3-sd)
..... @displayable 0..1 bl(2.0.3-sd)
..... @root 1..1 oid(2.0.3-sd), uuid(2.0.3-sd), ruid(2.0.3-sd) Fixed Value: 2.16.840.1.113883.1.3
..... @extension 1..1 st(2.0.3-sd)
.... templateId 0..* II
.... @typeCode 1..1 cs(2.0.3-sd) Binding: XActRelationshipExternalReference (3.0.0) (required)
Fixed Value: REFR
.... seperatableInd 0..1 BL
.... externalAct 0..1 ExternalAct
.... externalObservation 0..1 ExternalObservation
.... externalProcedure 0..1 ExternalProcedure
.... externalDocument 0..1 ExternalDocument
... precondition 0..* Precondition
... sdtcPrecondition2 0..* Precondition2 XML Namespace: urn:hl7-org:sdtc
XML: precondition2 (urn:hl7-org:sdtc)
... sdtcInFulfillmentOf1 0..* InFulfillmentOf1 XML Namespace: urn:hl7-org:sdtc
XML: inFulfillmentOf1 (urn:hl7-org:sdtc)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Act.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.typeId.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.templateId:entry-reference.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.templateId:external-entry-reference.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.classCode Base required x_ActClassDocumentEntryAct 📍2.0.0 THO v5.2
Act.moodCode Base required x_DocumentActMood 📍2.0.0 THO v5.2
Act.code Base example v3 Code System ActCode 📍3.0.0 THO v7.1
Act.code.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.compression Base required CDACompressionAlgorithm 📍2.0.3-sd Clinical Document Architecture v2.0
Act.text.integrityCheckAlgorithm Base required IntegrityCheckAlgorithm 📍2.0.0 THO v5.2
Act.text.mediaType Base example MediaType 📍3.0.0 THO v7.1
Act.text.representation Base required CDABinaryDataEncoding 📍2.0.3-sd Clinical Document Architecture v2.0
Act.statusCode Base required ActStatus 📍3.0.0 THO v7.1
Act.statusCode.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.priorityCode Base example ActPriority 📍3.0.0 THO v7.1
Act.languageCode Base required All Languages 📦5.0.0 FHIR Std.
Act.reference.nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.reference.typeId.​nullFlavor Base required CDANullFlavor 📍2.0.3-sd Clinical Document Architecture v2.0
Act.reference.typeCode Base required x_ActRelationshipExternalReference 📍3.0.0 THO v7.1

Constraints

Id Grade Path(s) Description Expression
ED-1 error Act.text.thumbnail Thumbnails cannot contain their own thumbnails thumbnail.empty()
II-1 error Act.typeId, Act.reference.typeId An II instance must have either a root or an nullFlavor. root.exists() or nullFlavor.exists()
should-text-ref-value warning Act SHOULD contain text/reference/@value text.reference.value.exists()
value-starts-octothorpe error Act.text.reference If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative value.exists() implies value.startsWith('#')

This structure is derived from EntryReference

Summary

Mandatory: 4 elements
Fixed: 1 element

Slices

This structure defines the following Slices:

  • The element 2 is sliced based on the values of Act.templateId

 

Other representations of profile: CSV, Excel