Release 4

This page is part of the FHIR Specification (v4.0.1: R4 - Mixed Normative and STU) in it's permanent home (it will always be available at this URL). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Structured Documents Work Group Maturity Level: 1Trial Use Use Context: Any

The official URL for this profile is:

http://hl7.org/fhir/StructureDefinition/clinicaldocument

The Clinical Document profile constrains Composition to specify a clinical document (matching CDA). The base Composition is a general resource for compositions or documents about any kind of subject that might be encountered in healthcare including such things as guidelines, medicines, etc. A clinical document is focused on documents related to the provision of care process, where the subject is a patient, a group of patients, or a closely related concept. A clinical document has additional requirements around confidentiality that do not apply in the same way to other kinds of documents.

This profile was published on Tue, Mar 17, 2015 00:00+1100 as a draft by Health Level Seven, Inc. - Structured Documents WG.

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Composition.

Summary

Extensions

This structure refers to these extensions:

NameFlagsCard.TypeDescription & Constraintsdoco
.. Composition I0..*A set of resources composed into a single coherent clinical statement with clinical attestation
... id Σ0..1stringLogical id of this artifact
... meta ΣI0..1MetaMetadata about the resource
... implicitRules ?!ΣI0..1uriA set of rules under which this content was created
... language I0..1codeLanguage of the resource content
Binding: Common Languages (preferred)
Max Binding: All Languages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
... composition-clinicaldocument-versionNumber I0..*stringVersion-specific identifier for composition
URL: http://hl7.org/fhir/StructureDefinition/composition-clinicaldocument-versionNumber
... modifierExtension ?!I0..*ExtensionExtensions that cannot be ignored
... identifier ΣI0..1IdentifierVersion-independent identifier for the Composition
... status ?!ΣI1..1codepreliminary | final | amended | entered-in-error
Binding: CompositionStatus (required)
... type ΣI1..1CodeableConceptKind of composition (LOINC if possible)
Binding: FHIR Document Type Codes (preferred)
... category ΣI0..*CodeableConceptCategorization of Composition
Binding: Document Class Value Set (example)
... subject ΣI0..1Reference(Patient | Practitioner | Group | Device | Location)Who and/or what the composition is about
... encounter ΣI0..1Reference(Encounter)Context of the Composition
... date ΣI1..1dateTimeComposition editing time
... author ΣI1..*Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization)Who and/or what authored the composition
... title ΣI1..1stringHuman Readable name/title
... confidentiality ΣI0..1codeAs defined by affinity domain
Binding: ConfidentialityClassification (required)
... attester I0..*BackboneElementAttests to accuracy of composition
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... mode I1..1codepersonal | professional | legal | official
Binding: CompositionAttestationMode (required)
.... time I0..1dateTimeWhen the composition was attested
.... party I0..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization)Who attested the composition
... custodian ΣI0..1Reference(Organization)Organization which maintains the composition
... relatesTo I0..*BackboneElementRelationships to other compositions/documents
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code I1..1codereplaces | transforms | signs | appends
Binding: DocumentRelationshipType (required)
.... target[x] I1..1Target of the relationship
..... targetIdentifierIdentifier
..... targetReferenceReference(composition.html)
... event ΣI0..*BackboneElementThe clinical service(s) being documented
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code ΣI0..*CodeableConceptCode(s) that apply to the event being documented
Binding: ActCode (example)
.... period ΣI0..1PeriodThe period covered by the documentation
.... detail ΣI0..*Reference(Resource)The event(s) being documented
... section I0..*BackboneElementComposition is broken into sections
cmp-1: A section must contain at least one of text, entries, or sub-sections
cmp-2: A section can only have an emptyReason if it is empty
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... title I0..1stringLabel for section (e.g. for ToC)
.... code I0..1CodeableConceptClassification of section (recommended)
Binding: Document Section Codes (example)
.... author I0..*Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization)Who and/or what authored the section
.... focus I0..1Reference(Resource)Who/what the section is about, when it is not about the subject of composition
.... text I0..1NarrativeText summary of the section, for human interpretation
.... mode I0..1codeworking | snapshot | changes
Binding: ListMode (required)
.... orderedBy I0..1CodeableConceptOrder of section entries
Binding: List Order Codes (preferred)
.... entry I0..*Reference(Resource)A reference to data that supports this section
.... emptyReason I0..1CodeableConceptWhy the section is empty
Binding: List Empty Reasons (preferred)
.... section I0..*Unknown reference to #Composition.section
Nested Section

doco Documentation for this format
<!-- Clinical Document -->doco

<Composition xmlns="http://hl7.org/fhir"
>
  <!-- from Element: extension -->
 <id><!-- 0..1 string Logical id of this artifact --></id>
 <meta><!-- ?? 0..1 Meta Metadata about the resource --></meta>
 <implicitRules value="[uri]"/><!-- ?? 0..1 A set of rules under which this content was created -->
 <language value="[code]"/><!-- ?? 0..1 Language of the resource content   -->
 <text><!-- ?? 0..1 Narrative 
     Text summary of the resource, for human interpretation --></text>
 <contained><!-- 0..* Resource Contained, inline Resources --></contained>
 <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored  --></modifierExtension>
 <identifier><!-- ?? 0..1 Identifier 
     Version-independent identifier for the Composition --></identifier>
 <status value="[code]"/><!-- ?? 1..1 preliminary | final | amended | entered-in-error   -->
 <type><!-- ?? 1..1 CodeableConcept Kind of composition (LOINC if possible)   --></type>
 <category><!-- ?? 0..* CodeableConcept Categorization of Composition   --></category>
 <subject><!-- ?? 0..1 Reference(Patient) 
     Who and/or what the composition is about --></subject>
 <encounter><!-- ?? 0..1 Reference(Encounter) Context of the Composition --></encounter>
 <date value="[dateTime]"/><!-- ?? 1..1 Composition editing time -->
 <author><!-- ?? 1..* Reference(Practitioner) 
     Who and/or what authored the composition --></author>
 <title value="[string]"/><!-- ?? 1..1 Human Readable name/title -->
 <confidentiality value="[code]"/><!-- ?? 0..1 As defined by affinity domain    -->
 <attester> ?? 0..* BackboneElement  <!-- ?? 0..* Attests to accuracy of composition -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <mode value="[code]"/><!-- ?? 1..1 personal | professional | legal | official   -->
  <time value="[dateTime]"/><!-- ?? 0..1 When the composition was attested -->
  <party><!-- ?? 0..1 Reference(Patient) 
      Who attested the composition --></party>
 </attester>
 <custodian><!-- ?? 0..1 Reference(Organization) 
     Organization which maintains the composition --></custodian>
 <relatesTo> ?? 0..* BackboneElement  <!-- ?? 0..* Relationships to other compositions/documents -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <code value="[code]"/><!-- ?? 1..1 replaces | transforms | signs | appends   -->
  <target[x]><!-- ?? 1..1 Identifier|Reference(Composition) 
      Target of the relationship --></target[x]>
 </relatesTo>
 <event> ?? 0..* BackboneElement  <!-- ?? 0..* The clinical service(s) being documented -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <code><!-- ?? 0..* CodeableConcept Code(s) that apply to the event being documented   --></code>
  <period><!-- ?? 0..1 Period 
      The period covered by the documentation --></period>
  <detail><!-- ?? 0..* Reference(Resource) 
      The event(s) being documented --></detail>
 </event>
 <section> ?? 0..* BackboneElement  <!-- ?? 0..* Composition is broken into sections -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <title value="[string]"/><!-- ?? 0..1 Label for section (e.g. for ToC) -->
  <code><!-- ?? 0..1 CodeableConcept Classification of section (recommended)   --></code>
  <author><!-- ?? 0..* Reference(Practitioner) 
      Who and/or what authored the section --></author>
  <focus><!-- ?? 0..1 Reference(Resource) 
      Who/what the section is about, when it is not about the subject of composition --></focus>
  <text><!-- ?? 0..1 Narrative 
      Text summary of the section, for human interpretation --></text>
  <mode value="[code]"/><!-- ?? 0..1 working | snapshot | changes   -->
  <orderedBy><!-- ?? 0..1 CodeableConcept Order of section entries   --></orderedBy>
  <entry><!-- ?? 0..* Reference(Resource) 
      A reference to data that supports this section --></entry>
  <emptyReason><!-- ?? 0..1 CodeableConcept Why the section is empty   --></emptyReason>
  <section><!-- See #Composition.section  Nested Section --></section>
 </section>
</Composition>
{ // Clinical Document
  // from Element: extension
    "meta" : { Meta }, // C?Metadata about the resource
    "implicitRules" : "<uri>", // C?A set of rules under which this content was created
    "language" : "<code>", // C?Language of the resource content
    "text" : { Narrative }, // C?Text summary of the resource, for human interpretation
    "contained" : [{ Resource }], //Contained, inline Resources
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // Version-specific identifier for composition // C?
        // from Element: extension
      }
    ],
    "modifierExtension" : [{ Extension }], // C?Extensions that cannot be ignored
    "identifier" : { Identifier }, // C?Version-independent identifier for the Composition
    "status" : "<code>", // C? R! preliminary | final | amended | entered-in-error
    "type" : { CodeableConcept }, // C? R! Kind of composition (LOINC if possible)
    "category" : [{ CodeableConcept }], // C?Categorization of Composition
    "subject" : { Reference(Patient) }, // C?Who and/or what the composition is about
    "encounter" : { Reference(Encounter) }, // C?Context of the Composition
    "date" : "<dateTime>", // C? R! Composition editing time
    "author" : [{ Reference(Practitioner) }], // C? R! Who and/or what authored the composition
    "title" : "<string>", // C? R! Human Readable name/title
    "confidentiality" : "<code>", // C?As defined by affinity domain 
    "attester" : [{ BackboneElement }], // C?Attests to accuracy of composition
    "custodian" : { Reference(Organization) }, // C?Organization which maintains the composition
    "relatesTo" : [{ BackboneElement }], // C?Relationships to other compositions/documents
    "event" : [{ BackboneElement }], // C?The clinical service(s) being documented
    "section" : [{ BackboneElement }], // C?Composition is broken into sections
  }

This structure is derived from Composition.

Summary

Extensions

This structure refers to these extensions:

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Composition I0..*A set of resources composed into a single coherent clinical statement with clinical attestation
... id Σ0..1stringLogical id of this artifact
... meta ΣI0..1MetaMetadata about the resource
... implicitRules ?!ΣI0..1uriA set of rules under which this content was created
... language I0..1codeLanguage of the resource content
Binding: Common Languages (preferred)
Max Binding: All Languages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
... composition-clinicaldocument-versionNumber I0..*stringVersion-specific identifier for composition
URL: http://hl7.org/fhir/StructureDefinition/composition-clinicaldocument-versionNumber
... modifierExtension ?!I0..*ExtensionExtensions that cannot be ignored
... identifier ΣI0..1IdentifierVersion-independent identifier for the Composition
... status ?!ΣI1..1codepreliminary | final | amended | entered-in-error
Binding: CompositionStatus (required)
... type ΣI1..1CodeableConceptKind of composition (LOINC if possible)
Binding: FHIR Document Type Codes (preferred)
... category ΣI0..*CodeableConceptCategorization of Composition
Binding: Document Class Value Set (example)
... subject ΣI0..1Reference(Patient | Practitioner | Group | Device | Location)Who and/or what the composition is about
... encounter ΣI0..1Reference(Encounter)Context of the Composition
... date ΣI1..1dateTimeComposition editing time
... author ΣI1..*Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization)Who and/or what authored the composition
... title ΣI1..1stringHuman Readable name/title
... confidentiality ΣI0..1codeAs defined by affinity domain
Binding: ConfidentialityClassification (required)
... attester I0..*BackboneElementAttests to accuracy of composition
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... mode I1..1codepersonal | professional | legal | official
Binding: CompositionAttestationMode (required)
.... time I0..1dateTimeWhen the composition was attested
.... party I0..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization)Who attested the composition
... custodian ΣI0..1Reference(Organization)Organization which maintains the composition
... relatesTo I0..*BackboneElementRelationships to other compositions/documents
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code I1..1codereplaces | transforms | signs | appends
Binding: DocumentRelationshipType (required)
.... target[x] I1..1Target of the relationship
..... targetIdentifierIdentifier
..... targetReferenceReference(composition.html)
... event ΣI0..*BackboneElementThe clinical service(s) being documented
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code ΣI0..*CodeableConceptCode(s) that apply to the event being documented
Binding: ActCode (example)
.... period ΣI0..1PeriodThe period covered by the documentation
.... detail ΣI0..*Reference(Resource)The event(s) being documented
... section I0..*BackboneElementComposition is broken into sections
cmp-1: A section must contain at least one of text, entries, or sub-sections
cmp-2: A section can only have an emptyReason if it is empty
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... title I0..1stringLabel for section (e.g. for ToC)
.... code I0..1CodeableConceptClassification of section (recommended)
Binding: Document Section Codes (example)
.... author I0..*Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization)Who and/or what authored the section
.... focus I0..1Reference(Resource)Who/what the section is about, when it is not about the subject of composition
.... text I0..1NarrativeText summary of the section, for human interpretation
.... mode I0..1codeworking | snapshot | changes
Binding: ListMode (required)
.... orderedBy I0..1CodeableConceptOrder of section entries
Binding: List Order Codes (preferred)
.... entry I0..*Reference(Resource)A reference to data that supports this section
.... emptyReason I0..1CodeableConceptWhy the section is empty
Binding: List Empty Reasons (preferred)
.... section I0..*Unknown reference to #Composition.section
Nested Section

doco Documentation for this format

XML Template

<!-- Clinical Document -->doco

<Composition xmlns="http://hl7.org/fhir"
>
  <!-- from Element: extension -->
 <id><!-- 0..1 string Logical id of this artifact --></id>
 <meta><!-- ?? 0..1 Meta Metadata about the resource --></meta>
 <implicitRules value="[uri]"/><!-- ?? 0..1 A set of rules under which this content was created -->
 <language value="[code]"/><!-- ?? 0..1 Language of the resource content   -->
 <text><!-- ?? 0..1 Narrative 
     Text summary of the resource, for human interpretation --></text>
 <contained><!-- 0..* Resource Contained, inline Resources --></contained>
 <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored  --></modifierExtension>
 <identifier><!-- ?? 0..1 Identifier 
     Version-independent identifier for the Composition --></identifier>
 <status value="[code]"/><!-- ?? 1..1 preliminary | final | amended | entered-in-error   -->
 <type><!-- ?? 1..1 CodeableConcept Kind of composition (LOINC if possible)   --></type>
 <category><!-- ?? 0..* CodeableConcept Categorization of Composition   --></category>
 <subject><!-- ?? 0..1 Reference(Patient) 
     Who and/or what the composition is about --></subject>
 <encounter><!-- ?? 0..1 Reference(Encounter) Context of the Composition --></encounter>
 <date value="[dateTime]"/><!-- ?? 1..1 Composition editing time -->
 <author><!-- ?? 1..* Reference(Practitioner) 
     Who and/or what authored the composition --></author>
 <title value="[string]"/><!-- ?? 1..1 Human Readable name/title -->
 <confidentiality value="[code]"/><!-- ?? 0..1 As defined by affinity domain    -->
 <attester> ?? 0..* BackboneElement  <!-- ?? 0..* Attests to accuracy of composition -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <mode value="[code]"/><!-- ?? 1..1 personal | professional | legal | official   -->
  <time value="[dateTime]"/><!-- ?? 0..1 When the composition was attested -->
  <party><!-- ?? 0..1 Reference(Patient) 
      Who attested the composition --></party>
 </attester>
 <custodian><!-- ?? 0..1 Reference(Organization) 
     Organization which maintains the composition --></custodian>
 <relatesTo> ?? 0..* BackboneElement  <!-- ?? 0..* Relationships to other compositions/documents -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <code value="[code]"/><!-- ?? 1..1 replaces | transforms | signs | appends   -->
  <target[x]><!-- ?? 1..1 Identifier|Reference(Composition) 
      Target of the relationship --></target[x]>
 </relatesTo>
 <event> ?? 0..* BackboneElement  <!-- ?? 0..* The clinical service(s) being documented -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <code><!-- ?? 0..* CodeableConcept Code(s) that apply to the event being documented   --></code>
  <period><!-- ?? 0..1 Period 
      The period covered by the documentation --></period>
  <detail><!-- ?? 0..* Reference(Resource) 
      The event(s) being documented --></detail>
 </event>
 <section> ?? 0..* BackboneElement  <!-- ?? 0..* Composition is broken into sections -->
  <modifierExtension><!-- ?? 0..* Extension  Extensions that cannot be ignored even if unrecognized  --></modifierExtension>
  <title value="[string]"/><!-- ?? 0..1 Label for section (e.g. for ToC) -->
  <code><!-- ?? 0..1 CodeableConcept Classification of section (recommended)   --></code>
  <author><!-- ?? 0..* Reference(Practitioner) 
      Who and/or what authored the section --></author>
  <focus><!-- ?? 0..1 Reference(Resource) 
      Who/what the section is about, when it is not about the subject of composition --></focus>
  <text><!-- ?? 0..1 Narrative 
      Text summary of the section, for human interpretation --></text>
  <mode value="[code]"/><!-- ?? 0..1 working | snapshot | changes   -->
  <orderedBy><!-- ?? 0..1 CodeableConcept Order of section entries   --></orderedBy>
  <entry><!-- ?? 0..* Reference(Resource) 
      A reference to data that supports this section --></entry>
  <emptyReason><!-- ?? 0..1 CodeableConcept Why the section is empty   --></emptyReason>
  <section><!-- See #Composition.section  Nested Section --></section>
 </section>
</Composition>

JSON Template

{ // Clinical Document
  // from Element: extension
    "meta" : { Meta }, // C?Metadata about the resource
    "implicitRules" : "<uri>", // C?A set of rules under which this content was created
    "language" : "<code>", // C?Language of the resource content
    "text" : { Narrative }, // C?Text summary of the resource, for human interpretation
    "contained" : [{ Resource }], //Contained, inline Resources
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // Version-specific identifier for composition // C?
        // from Element: extension
      }
    ],
    "modifierExtension" : [{ Extension }], // C?Extensions that cannot be ignored
    "identifier" : { Identifier }, // C?Version-independent identifier for the Composition
    "status" : "<code>", // C? R! preliminary | final | amended | entered-in-error
    "type" : { CodeableConcept }, // C? R! Kind of composition (LOINC if possible)
    "category" : [{ CodeableConcept }], // C?Categorization of Composition
    "subject" : { Reference(Patient) }, // C?Who and/or what the composition is about
    "encounter" : { Reference(Encounter) }, // C?Context of the Composition
    "date" : "<dateTime>", // C? R! Composition editing time
    "author" : [{ Reference(Practitioner) }], // C? R! Who and/or what authored the composition
    "title" : "<string>", // C? R! Human Readable name/title
    "confidentiality" : "<code>", // C?As defined by affinity domain 
    "attester" : [{ BackboneElement }], // C?Attests to accuracy of composition
    "custodian" : { Reference(Organization) }, // C?Organization which maintains the composition
    "relatesTo" : [{ BackboneElement }], // C?Relationships to other compositions/documents
    "event" : [{ BackboneElement }], // C?The clinical service(s) being documented
    "section" : [{ BackboneElement }], // C?Composition is broken into sections
  }

 

Alternate definitions: Master Definition (XML, JSON), Schematron

PathNameConformanceValueSet
Composition.languageCommon LanguagespreferredCommon Languages
Composition.statusCompositionStatusrequiredCompositionStatus
Composition.typeFHIR Document Type CodespreferredFHIR Document Type Codes
Composition.categoryDocument Class Value SetexampleDocument Class Value Set
Composition.confidentialityV3 Value SetConfidentialityClassificationrequiredV3 Value SetConfidentialityClassification
Composition.attester.modeCompositionAttestationModerequiredCompositionAttestationMode
Composition.relatesTo.codeDocumentRelationshipTyperequiredDocumentRelationshipType
Composition.event.codev3 Code System ActCodeexamplev3 Code System ActCode
Composition.section.codeDocument Section CodesexampleDocument Section Codes
Composition.section.modeListModerequiredListMode
Composition.section.orderedByList Order CodespreferredList Order Codes
Composition.section.emptyReasonList Empty ReasonspreferredList Empty Reasons
RuleRule
IdPathDetailsRequirements
cmp-1Composition.sectionA section must contain at least one of text, entries, or sub-sections
Expression : text.exists() or entry.exists() or section.exists()
cmp-2Composition.sectionA section can only have an emptyReason if it is empty
Expression : emptyReason.empty() or entry.empty()
.