DRAFT Working draft of an upcoming version. Not the published standard. View the current published version
Skip to content

T.2 Document Terminology ​

These concise definitions establish the language used in Chapter 1 and Appendix A. The detailed explanations, examples, and code catalog are in Appendix A.

TermMeaning and use
Source FormThe human-readable representation of the source-authored document information preserved in an exchanged clinical document. It establishes the content and authorship boundaries of that representation.
Minimally Structured DocumentA standardized clinical document that preserves its human-readable Source Form and includes the dependable structure required by the applicable document and exchange specifications.
Progressive StructuringA methodology for progressively enriching a document’s computable representation while preserving its source information, attribution, and context.
Information Collection ScopeThe boundary that establishes which information belongs to a collection, such as an encounter, an established episode, or a point-in-time patient summary.
SpeciesThe Document Type dimension: the specific semantic kind of clinical information collection.
GenusThe Document Template/Profile dimension: the asserted structural and conformance model.
FamilyThe Document Category dimension: the broader semantic group or groups to which a document belongs.
Pregnancy HistoryThe guide’s label for LOINC 10162-6. Section use and broader document-classification use are distinct applications; Appendix A lists the use-case mappings.
Document TypeThe specific semantic kind of clinical document: what information collection it represents. This is the Species dimension. Use Document Type in conceptual prose and the exact standard field name in encoding requirements.
Document CategoryA broader semantic grouping of documents for discovery and workflow. This is the Family dimension; a document may belong to multiple categories. Its coded representation depends on the applicable standard and exchange policy.
Document Template/ProfileThe asserted structural and conformance requirements for a document, corresponding to the Genus dimension. It is distinct from Document Type and Document Category. A format code describes a declared format/profile convention; it is not the full template definition.
Document LifecycleThe progression and history of a document’s preparation, completion, amendment, correction, replacement, or invalidation. It is separate from the lifecycle of a Direct message or MAP transaction.
Document StatusThe asserted clinical or authoring state of a particular document version, interpreted under its source specification. It is distinct from metadata availability, transport disposition, and structured payload acceptance.
On-Demand DocumentAn on-demand document is assembled at the time it is requested/needed, but the effective time of the document is tied to the clinically relevant time of the document’s context, for example a specific encounter or episode of care.
Dynamically Generated DocumentIn this guide, a dynamically generated document takes the current context of available information to include in the document. Its clinical effective time is now.

Document Classification Field Crosswalk ​

Use the conceptual terms below in prose. Use exact field names when specifying population rules. These mappings identify semantic roles; they do not establish interchangeable bindings or cardinalities.

Standard representationDocument TypeDocument Category
IHE XD DocumentEntryDocumentEntry.typeCodeDocumentEntry.classCode carries the exchange-defined broad classification; align it with Document Category only where that mapping is declared.
CDAClinicalDocument/codeClinicalDocument/sdtc:category (urn:hl7-org:sdtc); not ClinicalDocument/@classCode, whose fixed DOCCLIN value identifies the RIM class.
FHIR R4 CompositionComposition.typeComposition.category
FHIR R4 DocumentReferenceDocumentReference.typeDocumentReference.category

Document-level CDA templateId and applicable FHIR meta.profile assertions identify Document Template/Profile. XD formatCode and DocumentReference.content.format identify an established format convention where defined; MIME type identifies serialization. SubmissionSet.contentTypeCode classifies the structured payload, not a document category. SubmissionSet.purpose and Task.code identify the requested Shared Activity.

For non-document information objects such as a Task or Provenance Bundle, use information-object type and classification rather than calling them clinical Document Types. Chapter 3 retains the binding and conformance requirements; Appendix C explains XD classification and Appendix D supplies packaging mappings.

Document Lifecycle Reference ​

Appendix E, Understanding Document Lifecycle and Status, supplies the document-status crosswalk and the applicable CDA, FHIR, and XD metadata mappings. Do not infer a document’s finality from successful transport or structured payload acceptance.