DICOM PS3.3 2024e - Information Object Definitions

C.24.2 Encapsulated Document Module

Table C.24-2 defines the Attributes of the Encapsulated Document Module.

Table C.24-2. Encapsulated Document Module Attributes

Attribute Name

Tag

Type

Attribute Description

Instance Number

(0020,0013)

1

A number that identifies this SOP Instance. The value shall be unique within a Series.

Content Date

(0008,0023)

2

The date the document content creation was started.

Content Time

(0008,0033)

2

The time the document content creation was started.

Acquisition DateTime

(0008,002A)

2

The date and time that the original generation of the data in the document started.

Image Laterality

(0020,0062)

3

Laterality of the (possibly paired) body part that is the subject of the encapsulated document.

Enumerated Values:

R

right

L

left

U

unpaired

B

both left and right

If Modality (0008,0060) is M3D, then values for this Attribute shall refer to the intended placement of the created object regardless of how it was generated (see also Section C.35.1 “Manufacturing 3D Model Module”).

Burned In Annotation

(0028,0301)

1

Indicates whether or not the encapsulated document contains sufficient burned in annotation to identify the patient and date the data was acquired.

Enumerated Values:

YES

NO

Identification of patient and date as text in an encapsulated document (e.g., in an XML attribute or element) is equivalent to "burned in annotation". A de-identified document may use the value NO.

If Modality (0008,0060) is M3D, the presence of identifying information embossed or engraved on any part of the model shall be indicated by a value of YES.

Recognizable Visual Features

(0028,0302)

3

Indicates whether or not the Instance contains sufficiently recognizable visual features to allow the Instance or a reconstruction from a set of Instances to identify the patient.

Enumerated Values:

YES

NO

If this Attribute is absent, then the Instance may or may not contain recognizable visual features.

Source Instance Sequence

(0042,0013)

1C

A Sequence that identifies the set of Instances that were used to derive the encapsulated document.

One or more Items shall be included in this Sequence.

Required if derived from one or more DICOM Instances. May be present otherwise.

Note

Unlike other uses of Source Instance Sequence (0042,0013), such as in the General Reference Module, references to images are permitted in this Module. This Module does not include the Source Image Sequence (0008,2112). The Defined Context Group for Purpose of Reference Code Sequence (0040,A170) includes an appropriate concept.

>Include Table 10-11 “SOP Instance Reference Macro Attributes”

>Purpose of Reference Code Sequence

(0040,A170)

3

Describes the purpose for which the reference is made, that is what role the source Instances played in the derivation of this encapsulated document

Only a single Item single Item is permitted in this Sequence.

>>Include Table 8.8-1 “Code Sequence Macro Attributes”

DCID 7060 “Encapsulated Document Source Purpose of Reference”.

Referenced Image Sequence

(0008,1140)

3

The set of Image Instances referenced in the encapsulated document.

One or more Items are permitted in this Sequence.

>Include Table 10-3 “Image SOP Instance Reference Macro Attributes”

>Relative URI Reference Within Encapsulated Document

(0068,7005)

1C

The relative URI reference used in the encapsulated document to reference the Image Instance in this Item.

This may be used to maintain referential integrity between a set of related encapsulated documents.

Required if the Encapsulated Document (0042,0011) contains a reference to the Image Instance in this Item.

See Section C.24.2.4.

Referenced Instance Sequence

(0008,114A)

3

The set of non-image SOP Instances referenced in the encapsulated document.

One or more Items are permitted in this Sequence.

>Include Table 10-11 “SOP Instance Reference Macro Attributes”

>Relative URI Reference Within Encapsulated Document

(0068,7005)

1C

The relative URI reference used in the encapsulated document to reference the SOP Instance in this Item.

This may be used to maintain referential integrity between a set of related encapsulated documents.

Required if the Encapsulated Document (0042,0011) contains a reference to the SOP Instance in this Item.

See Section C.24.2.4.

Document Title

(0042,0010)

2

The title of the document.

Note

In the case of a PDF encapsulated document, this may be the value of the "Title" entry in the "Document Information Directory" as encoded in the PDF data.

Concept Name Code Sequence

(0040,A043)

2

A coded representation of the document title.

Note

  1. In the case of a PDF encapsulated document, the coded representation is not required to be identical to the Value of Document Title (0042,0010), e.g., when the "Title" entry in the "Document Information Directory"of the PDF data is used as the Value of Document Title (0042,0010).

  2. When the Content Sequence (0040,A730) is present and its structured content is used in a manner of a typical Structured Report, the coded representation in Concept Name Code Sequence (0040,A043) serves as the Document Title of this structured content. See Section C.24.2.2 for further explanation.

Zero or one Item shall be included in this Sequence.

>Include Table 8.8-1 “Code Sequence Macro Attributes”

For documents with Modality (0008,0060) equal to M3D, BCID 7061 “Model Document Title”.

For all other encapsulated documents, BCID 7020 “Document Title”.

Document Class Code Sequence

(0040,E008)

3

Additional classifications of the document, beyond the title represented in Concept Name Code Sequence (0040,A043). May be equivalent to HL7 v2.x TXA-2.

One or more Items are permitted in this Sequence.

>Include Table 8.8-1 “Code Sequence Macro Attributes”

No Baseline CID is defined.

Verification Flag

(0040,A493)

3

Indicates whether the encapsulated document is Verified.

Enumerated Values:

UNVERIFIED

Not attested by a legally accountable person.

VERIFIED

Attested to (signed) by a Verifying Observer or Legal Authenticator named in the document, who is accountable for its content.

HL7 Instance Identifier

(0040,E001)

1C

Instance Identifier of the encapsulated HL7 Structured Document, encoded as a UID (OID or UUID), concatenated with a caret ("^") and Extension value (if Extension is present in Instance Identifier).

Required if encapsulated document is a CDA document.

Predecessor Documents Sequence

(0040,A360)

3

References to SOP Instances whose content has been wholly or partially included in this document with or without modification.

One or more Items are permitted in this Sequence.

>Include Table C.17-3 “Hierarchical SOP Instance Reference Macro Attributes”

Purpose of Reference Code Sequence in the Hierarchical SOP Instance Reference Macro DCID 7062 “Purpose of Reference to Predecessor 3D Model” if Modality (0008,0060) is M3D; otherwise, DCID 7009 “Purpose of Reference to Predecessor Report”.

Identical Documents Sequence

(0040,A525)

3

Duplicates of this document, stored with different SOP Instance UIDs.

One or more Items are permitted in this Sequence.

See Section C.17.2.2 for further explanation.

>Include Table C.17-3 “Hierarchical SOP Instance Reference Macro Attributes”

MIME Type of Encapsulated Document

(0042,0012)

1

The type of the encapsulated document stream described using the MIME Media Type (see RFC 2046).

List of MIME Types

(0042,0014)

1C

MIME Types of subcomponents of the encapsulated document.

Required if the encapsulated document incorporates subcomponents with MIME types different than the primary MIME Type of the encapsulated document.

Note

An Encapsulated CDA that includes an embedded JPEG image and an embedded PDF would list "image/jpeg\application/pdf".

Encapsulated Document

(0042,0011)

1

Encapsulated Document stream, containing a document encoded according to the MIME Type.

Encapsulated Document Length

(0042,0015)

3

The length of the Encapsulated Document stream, not including any trailing padding added for encapsulation as a DICOM object.

If present, shall be equal to the Value Length if even, or one less than the Value Length if odd.

Note

In the absence of this Attribute, the value of Encapsulated Document (0042,0011) may have been padded to even length as required for all DICOM Data Element Values, so it would not be possible to extract the original unpadded document if it were of odd length.

Value Type

(0040,A040)

1C

The type of the value encoded in this Content Item.

Enumerated Values:

CONTAINER

Required if Content Sequence (0040,A730) is present.

Content Sequence

(0040,A730)

3

A potentially recursively nested Sequence of Items that conveys structured content.

One or more Items are permitted in this Sequence.

See Section C.17.3.2.4 and Section C.24.2.2 for further explanation.

>Relationship Type

(0040,A010)

1

The type of relationship between the (enclosing) Source Content Item and the Target Content Item.

IODs specify additional constraints on Relationships (including lists of Enumerated Values).

Enumerated Values:

CONTAINS

HAS OBS CONTEXT

HAS ACQ CONTEXT

HAS CONCEPT MOD

See Section C.17.3.2.4 for further explanation.

>Include Table C.17-6 “Document Relationship Macro Attributes”

>Include Table C.17-5 “Document Content Macro Attributes”

Continuity of Content

(0040,A050)

1C

This flag specifies for a CONTAINER whether or not its contained Content Items are logically linked in a continuous textual flow, or are separate Items.

Enumerated Values:

SEPARATE

CONTINUOUS

See Section C.18.8.1.1 for further explanation.

Required if Content Sequence (0040,A730) is present.

Content Template Sequence

(0040,A504)

1C

Template that describes the content of this Content Item and its subsidiary Content Items.

Only a single Item shall be included in this Sequence.

Required if Content Sequence (0040,A730) is present and if a Template defined and known to the implementation at the time of encoding was used to define the content of this Item, and the Template consists of a single CONTAINER with nested content, and it is the outermost invocation of a set of nested Templates that start with the same CONTAINER (see Section C.18.8.1.2).

>Mapping Resource

(0008,0105)

1

Mapping Resource that defines the Template. See Section 8.4.

Defined Terms:

DCMR

DICOM Content Mapping Resource

>Mapping Resource UID

(0008,0118)

3

Uniquely identifies the Mapping Resource that defines the Template.

Note

The Unique Identifier for the DICOM Content Mapping Resource "DCMR" is defined in PS3.6.

>Template Identifier

(0040,DB00)

1

Template identifier.


Note

  1. One could distinguish four stages in the creation of an Encapsulated Document SOP Instance, identified by the following Attributes:

    1. Measurement and/or data collection, identified by Acquisition DateTime (0008,002A) in the Encapsulated Document Module.

    2. Creation of the original documentation of the data collection, identified by Content Date (0008,0023) and Content Time (0008,0033).

    3. Rendering of the original documentation into the format that will be encapsulated, e.g., a PDF document. The rendering time is not captured by any DICOM Attribute, but may be encoded in the rendering.

    4. Encapsulation of the rendering into a DICOM Object, identified by Instance Creation Date (0008,0012) and Instance Creation Time (0008,0013) in the SOP Common Module.

  2. DICOM does not specify requirements for consistency between DICOM Attribute values and data in the encapsulated document. It is expected that applications will ensure consistency in a manner appropriate to the application. For example, the Patient ID in an encapsulated CDA document may be that of a different institution, which originated the document, and it may be appropriate for the DICOM Attribute value to be different.

C.24.2.1 Attribute Requirements for Encapsulated CDA Document

For an Encapsulated CDA Document, Document Title (0042,0010) shall have the value of the CDA Document Title, if one is present in the encapsulated document.

Concept Name Code Sequence (0040,A043) shall have the value of the CDA Document Type Code, with transcoding as necessary for converting the HL7 CE Data Type to the DICOM Code Sequence Item.

Enumerated Values for MIME Type of Encapsulated Document (0042,0012):

text/XML

DICOM PS3.3 2024e - Information Object Definitions