Consolidated CDA Release 2.1 StructureDefinition Publication
2.1 - CI Build United States of America flag

Consolidated CDA Release 2.1 StructureDefinition Publication, published by Health Level Seven. This is not an authorized publication; it is the continuous build for version 2.1). This version is based on the current content of https://github.com/HL7/CDA-ccda-2.1-sd/ and changes regularly. See the Directory of published versions

Logical Model: ExternalDocumentReference - Detailed Descriptions

Draft as of 2023-09-29

Definitions for the ExternalDocumentReference logical model.

Guidance on how to interpret the contents of this table can be found here

0. ExternalDocument
XML FormatIn the XML format, this property has the namespace urn:hl7-org:v3.
2. ExternalDocument.classCode
Comments

SHALL contain exactly one [1..1] @classCode="DOCCLIN" Clinical Document (CodeSystem: HL7ActClass urn:oid:2.16.840.1.113883.5.6) (CONF:1098-31931).

Fixed ValueDOCCLIN
4. ExternalDocument.moodCode
Comments

SHALL contain exactly one [1..1] @moodCode="EVN" Event (CodeSystem: HL7ActMood urn:oid:2.16.840.1.113883.5.1001) (CONF:1098-31932).

Control1..?
6. ExternalDocument.templateId
Control1..?
SlicingThis element introduces a set of slices on ExternalDocument.templateId. The slices are unordered and Open, and can be differentiated using the following discriminators: , and can be differentiated using the following discriminators:
  • value @ root
  • value @ extension
8. ExternalDocument.templateId:primary
Slice Nameprimary
Comments

SHALL contain exactly one [1..1] templateId (CONF:1098-32748) such that it

Control1..1
10. ExternalDocument.templateId:primary.root
Comments

SHALL contain exactly one [1..1] @root="2.16.840.1.113883.10.20.22.4.115" (CONF:1098-32750).

Control1..?
Pattern Value2.16.840.1.113883.10.20.22.4.115
12. ExternalDocument.templateId:primary.extension
Comments

SHALL contain exactly one [1..1] @extension="2014-06-09" (CONF:1098-32749).

Control1..?
Pattern Value2014-06-09
14. ExternalDocument.id
Comments

SHALL contain exactly one [1..1] id (CONF:1098-32751).

Control1..1
16. ExternalDocument.code
Comments

SHALL contain exactly one [1..1] code (CONF:1098-31933).

Control1..?
18. ExternalDocument.setId
Comments

SHOULD contain zero or one [0..1] setId (CONF:1098-32752).

20. ExternalDocument.versionNumber
Comments

SHOULD contain zero or one [0..1] versionNumber (CONF:1098-32753).

Guidance on how to interpret the contents of this table can be found here

0. ExternalDocument
Definition

Base definition for all types defined in FHIR type system.

ShortBase for all types and resources
Control10..1*
Is Modifierfalse
XML FormatIn the XML format, this property has the namespace urn:hl7-org:v3.
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
2. ExternalDocument.classCode
Comments

SHALL contain exactly one [1..1] @classCode="DOCCLIN" Clinical Document (CodeSystem: HL7ActClass urn:oid:2.16.840.1.113883.5.6) (CONF:1098-31931).

Control1..1
BindingThe codes SHALL be taken from ActClassDocument
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Default ValueDOC
Fixed ValueDOCCLIN
4. ExternalDocument.moodCode
Comments

SHALL contain exactly one [1..1] @moodCode="EVN" Event (CodeSystem: HL7ActMood urn:oid:2.16.840.1.113883.5.1001) (CONF:1098-31932).

Control1..1
BindingThe codes SHALL be taken from ActMood
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Fixed ValueEVN
6. ExternalDocument.templateId
Definition

When valued in an instance, this attribute signals the imposition of a set of template-defined constraints. The value of this attribute provides a unique identifier for the templates in question

Control1..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
SlicingThis element introduces a set of slices on ExternalDocument.templateId. The slices are unordered and Open, and can be differentiated using the following discriminators: , and can be differentiated using the following discriminators:
  • value @ root
  • value @ extension
8. ExternalDocument.templateId:primary
Slice Nameprimary
Definition

When valued in an instance, this attribute signals the imposition of a set of template-defined constraints. The value of this attribute provides a unique identifier for the templates in question

Comments

SHALL contain exactly one [1..1] templateId (CONF:1098-32748) such that it

Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
10. ExternalDocument.templateId:primary.root
Definition

A unique identifier that guarantees the global uniqueness of the instance identifier. The root alone may be the entire instance identifier.

Comments

SHALL contain exactly one [1..1] @root="2.16.840.1.113883.10.20.22.4.115" (CONF:1098-32750).

Control1..1
Typestring(oid: ISO Object Identifier, uuid: DCE Universal Unique Identifier, ruid: HL7 Reserved Identifier Scheme)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
LabelRoot
Pattern Value2.16.840.1.113883.10.20.22.4.115
12. ExternalDocument.templateId:primary.extension
Definition

A character string as a unique identifier within the scope of the identifier root.

Comments

SHALL contain exactly one [1..1] @extension="2014-06-09" (CONF:1098-32749).

Control1..1
Typestring(st: Character String)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
LabelExtension
Pattern Value2014-06-09
14. ExternalDocument.id
Comments

SHALL contain exactly one [1..1] id (CONF:1098-32751).

Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
16. ExternalDocument.code
Comments

SHALL contain exactly one [1..1] code (CONF:1098-31933).

Control1..1
BindingUnless not suitable, these codes SHALL be taken from FHIRDocumentTypeCodes
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CD
18. ExternalDocument.setId
Comments

SHOULD contain zero or one [0..1] setId (CONF:1098-32752).

Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
20. ExternalDocument.versionNumber
Comments

SHOULD contain zero or one [0..1] versionNumber (CONF:1098-32753).

Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/INT

Guidance on how to interpret the contents of this table can be found here

0. ExternalDocument
Definition

Base definition for all types defined in FHIR type system.

ShortBase for all types and resources
Control1..1
Is Modifierfalse
XML FormatIn the XML format, this property has the namespace urn:hl7-org:v3.
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
2. ExternalDocument.classCode
Comments

SHALL contain exactly one [1..1] @classCode="DOCCLIN" Clinical Document (CodeSystem: HL7ActClass urn:oid:2.16.840.1.113883.5.6) (CONF:1098-31931).

Control1..1
BindingThe codes SHALL be taken from ActClassDocument
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Default ValueDOC
Fixed ValueDOCCLIN
4. ExternalDocument.moodCode
Comments

SHALL contain exactly one [1..1] @moodCode="EVN" Event (CodeSystem: HL7ActMood urn:oid:2.16.840.1.113883.5.1001) (CONF:1098-31932).

Control1..1
BindingThe codes SHALL be taken from ActMood
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
Fixed ValueEVN
6. ExternalDocument.templateId
Definition

When valued in an instance, this attribute signals the imposition of a set of template-defined constraints. The value of this attribute provides a unique identifier for the templates in question

Control1..*
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
SlicingThis element introduces a set of slices on ExternalDocument.templateId. The slices are unordered and Open, and can be differentiated using the following discriminators: , and can be differentiated using the following discriminators:
  • value @ root
  • value @ extension
8. ExternalDocument.templateId:primary
Slice Nameprimary
Definition

When valued in an instance, this attribute signals the imposition of a set of template-defined constraints. The value of this attribute provides a unique identifier for the templates in question

Comments

SHALL contain exactly one [1..1] templateId (CONF:1098-32748) such that it

Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
10. ExternalDocument.templateId:primary.nullFlavor
Definition

If a value is an exceptional value (NULL-value), this specifies in what way and why proper information is missing.

Control0..1
BindingThe codes SHALL be taken from NullFlavor
Typecode(cs: Coded Simple Value)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
LabelExceptional Value Detail
12. ExternalDocument.templateId:primary.assigningAuthorityName
Definition

A human readable name or mnemonic for the assigning authority. The Assigning Authority Name has no computational value. The purpose of a Assigning Authority Name is to assist an unaided human interpreter of an II value to interpret the authority. Note: no automated processing must depend on the assigning authority name to be present in any form.

Control0..1
Typestring(st: Character String)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
LabelAssigning Authority Name
14. ExternalDocument.templateId:primary.displayable
Definition

Specifies if the identifier is intended for human display and data entry (displayable = true) as opposed to pure machine interoperation (displayable = false).

Control0..1
Typeboolean(bl: Boolean)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
LabelDisplayable
16. ExternalDocument.templateId:primary.root
Definition

A unique identifier that guarantees the global uniqueness of the instance identifier. The root alone may be the entire instance identifier.

Comments

SHALL contain exactly one [1..1] @root="2.16.840.1.113883.10.20.22.4.115" (CONF:1098-32750).

Control1..1
Typestring(oid: ISO Object Identifier, uuid: DCE Universal Unique Identifier, ruid: HL7 Reserved Identifier Scheme)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
LabelRoot
Pattern Value2.16.840.1.113883.10.20.22.4.115
18. ExternalDocument.templateId:primary.extension
Definition

A character string as a unique identifier within the scope of the identifier root.

Comments

SHALL contain exactly one [1..1] @extension="2014-06-09" (CONF:1098-32749).

Control1..1
Typestring(st: Character String)
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
XML FormatIn the XML format, this property is represented as an attribute.
LabelExtension
Pattern Value2014-06-09
20. ExternalDocument.id
Comments

SHALL contain exactly one [1..1] id (CONF:1098-32751).

Control1..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
22. ExternalDocument.code
Comments

SHALL contain exactly one [1..1] code (CONF:1098-31933).

Control1..1
BindingUnless not suitable, these codes SHALL be taken from FHIRDocumentTypeCodes
Typehttp://hl7.org/cda/stds/core/StructureDefinition/CD
24. ExternalDocument.text
Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/ED
26. ExternalDocument.setId
Comments

SHOULD contain zero or one [0..1] setId (CONF:1098-32752).

Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/II
28. ExternalDocument.versionNumber
Comments

SHOULD contain zero or one [0..1] versionNumber (CONF:1098-32753).

Control0..1
Typehttp://hl7.org/cda/stds/core/StructureDefinition/INT