Release 5

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

2.8 Resource Composition - Content

Structured Documents icon Work GroupMaturity Level: 4 Trial UseSecurity Category: Not Classified Compartments: Device, Encounter, Patient, Practitioner, RelatedPerson

A set of healthcare-related information that is assembled together into a single logical package that provides a single coherent statement of meaning, establishes its own context and that has clinical attestation with regard to who is making the statement. A Composition defines the structure and narrative content necessary for a document. However, a Composition alone does not constitute a document. Rather, the Composition must be the first entry in a Bundle where Bundle.type=document, and any other resources referenced from Composition must be included as subsequent entries in the Bundle (for example Patient, Practitioner, Encounter, etc.).

2.8.1 Scope and Usage

A Composition is the basic structure from which FHIR Documents - immutable bundles with attested narrative - are built. A single logical composition may be associated with a series of derived documents, each of which is a frozen copy of the composition.

Note: EN 13606 icon uses the term "Composition" to refer to a single commit to an EHR system, and offers some common examples: a composition containing a consultation note, a progress note, a report or a letter, an investigation report, a prescription form or a set of bedside nursing observations. Using Composition for an attested EHR commit is a valid use of the Composition resource, but for FHIR purposes, it would be usual to make more granular updates with individual provenance statements.

The Clinical Document profile constrains Composition to specify a clinical document (matching CDA icon). See also the comparison with CDA.

2.8.2 Boundaries and Relationships

Composition is a structure for grouping information for purposes of persistence and attestability. The Composition resource defines a set of healthcare-related information that is assembled together into a single logical document that provides a single coherent statement of meaning, establishes its own context and that has clinical attestation with regard to who is making the statement. The Composition resource provides the basic structure of a FHIR document. The full content of the document is expressed using a Bundle containing the Composition and its entries.

There are several other grouping structures in FHIR with distinct purposes:

  • The List resource - enumerates a flat collection of resources and provides features for managing the collection. While a particular List instance may represent a "snapshot", from a business process perspective, the notion of "list" is dynamic – items are added and removed over time. The List resource references other resources. Lists may be curated and have specific business meaning.
  • The Group resource - defines a group of specific people, animals, devices, etc. by enumerating them, or by describing qualities that group members have. The Group resource refers to other resources, possibly implicitly. Groups are intended to be acted upon or observed as a whole (e.g., performing therapy on a group, calculating risk for a group, etc.). This resource will commonly be used for public health (e.g., describing an at-risk population), clinical trials (e.g., defining a test subject pool) and similar purposes.
  • The Bundle resource - is an infrastructure container for a group of resources. It does not have narrative and is used to group collections of resources for transmission, persistence or processing (e.g., messages, documents, transactions, query responses, etc.). The content of bundles is typically algorithmically determined for a particular exchange or persistence purpose.
  • The QuestionnaireResponse resource - is similar to Composition in that both organize collections of items and can have a hierarchical structure. Questionnaires are also intended to help guide 'human' presentation of data. However, Compositions organize resources, while Questionnaires/QuestionnaireResponses organize specific elements. Also, a Questionnaire represents data 'to be gathered' and is subject-independent, while Compositions represent collections of data that are complete and are about a particular subject. It is possible for StructureDefinitions or GraphDefinitions to act as 'templates' for FHIR documents that guide what data is collected for a particular purpose (e.g. a referral), but this differs from the gathering process that a Questionnaire provides where there are specific questions that must be asked and answered and rules that guide which questions are enabled in which circumstances.

The Composition resource organizes clinical and administrative content into sections, each of which contains a narrative, and references other resources for supporting data. The narrative content of the various sections in a Composition are supported by the resources referenced in the section entries. The complete set of content to make up a document includes the Composition resource together with various resources pointed to or indirectly connected to the Composition. See the FHIR Documents documentation for guidance on how a Composition is used when creating a document bundle.

2.8.3 Background and Context

2.8.3.1 Composition Status Codes

Every composition has a status element, which describes the status of the content of the composition, taken from this list of codes:

2.8.3.2 The workflow/clinical status of the composition.

registeredThe existence of the composition is registered, but there is nothing yet available.
partialThis is a partial (e.g. initial, interim or preliminary) composition: data in the composition may be incomplete or unverified.
preliminaryVerified early results are available, but not all results are final.
finalThis version of the composition is complete and verified by an appropriate person and no further work is planned. Any subsequent updates would be on a new version of the composition.
amendedThe composition content or the referenced resources have been modified (edited or added to) subsequent to being released as "final" and the composition is complete and verified by an authorized person.
correctedSubsequent to being final, the composition content has been modified to correct an error in the composition or referenced results.
appendedSubsequent to being final, the composition content has been modified by adding new content. The existing content is unchanged.
cancelledThe composition is unavailable because the measurement was not started or not completed (also sometimes called "aborted").
entered-in-errorThe composition or document was originally created/issued in error, and this is an amendment that marks that the entire series should not be considered as valid.
deprecatedThis composition has been withdrawn or superseded and should no longer be used.
unknownThe authoring/source system does not know which of the status values currently applies for this observation. Note: This concept is not to be used for "other" - one of the listed statuses is presumed to apply, but the authoring/source system does not know which.

Composition status generally only moves down through this list - it moves from registered or preliminary to final and then it may progress to amended. Note that in many workflows, only final compositions are made available and the preliminary status is not used.

Diagram showing typical transitions of clinical status for the Composition resource

A very few compositions are created entirely in error in the workflow - usually the composition concerns the wrong patient or is written by the wrong author, and the error is only detected after the composition has been used or documents have been derived from it. To support resolution of this case, the composition is updated to be marked as entered-in-error and a new derived document can be created. This means that the entire series of derived documents is now considered to be created in error and systems receiving derived documents based on retracted compositions SHOULD remove data taken from earlier documents from routine use and/or take other appropriate actions. Systems are not required to provide this workflow or support documents derived from retracted compositions, but they SHALL NOT ignore a status of entered-in-error. Note that systems that handle compositions or derived documents and don't support the error status need to define some other way of handling compositions that are created in error; while this is not a common occurrence, some clinical systems have no provision for removing erroneous information from a patient's record, and there is no way for a user to know that it is not fit for use - this is not safe.

2.8.3.3 Note for CDA aware readers

Many users of this specification are familiar with the Clinical Document Architecture icon (CDA) and related specifications. CDA is a primary design input to the Composition resource (other principal inputs are other HL7 document specifications and EN13606). There are three important structural differences between CDA and the Composition resource:

  • A composition is a logical construct - its identifier matches to the CDA ClinicalDocument.setId. Composition resources are wrapped into Document structures, for exchange of the whole package (the composition and its parts), and this wrapped, sealed entity is equivalent to a CDA document, where the where the Bundle.identifier is equivalent to ClinicalDocument.id and Bundle.meta.security is equivalent to ClinicalDocument.confidentialityCode.
  • The composition section defines a section (or sub-section) of the document, but unlike CDA, the section entries are actually references to other resources that hold the supporting data content for the section. This design means that the data can be reused in many other ways.
  • Unlike CDA, the context defined in the Composition (the subject, author, event, event period and encounter) apply to the composition and do not specifically apply to the resources referenced from the section.entry. There is no context flow model in FHIR, so each resource referenced from within a Composition expresses its own individual context. In this way, clinical content can safely be extracted from the composition.

In addition, note that both the code lists (e.g., Composition.status) and the Composition resource are mapped to HL7 v3 icon and/or CDA.

2.8.4 References to this Resource

2.8.5 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Composition TUDomainResourceA set of resources composed into a single coherent clinical statement with clinical attestation

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... url Σ0..1uriCanonical identifier for this Composition, represented as a URI (globally unique)
... identifier Σ0..*IdentifierVersion-independent identifier for the Composition

... version Σ0..1stringAn explicitly assigned identifer of a variation of the content in the Composition
... type Σ1..1CodeableConceptKind of composition (LOINC if possible)
Binding: FHIR Document Type Codes (Preferred)
... category Σ0..*CodeableConceptCategorization of Composition
Binding: Referenced Item Category Value Set (Example)

... subject Σ0..*Reference(Any)Who and/or what the composition is about

... encounter Σ0..1Reference(Encounter)Context of the Composition
... date Σ1..1dateTimeComposition editing time
... useContext Σ0..*UsageContextThe context that the content is intended to support

... author Σ1..*Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization)Who and/or what authored the composition

... name Σ0..1stringName for this Composition (computer friendly)
... title Σ1..1stringHuman Readable name/title
... note 0..*AnnotationFor any additional notes

... attester 0..*BackboneElementAttests to accuracy of composition

.... mode 1..1CodeableConceptpersonal | professional | legal | official
Binding: Composition Attestation Mode (Preferred)
.... time 0..1dateTimeWhen the composition was attested
.... party 0..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization)Who attested the composition
... custodian Σ0..1Reference(Organization)Organization which maintains the composition
... relatesTo 0..*RelatedArtifactRelationships to other compositions/documents

... event Σ0..*BackboneElementThe clinical service(s) being documented

.... period Σ0..1PeriodThe period covered by the documentation
.... detail Σ0..*CodeableReference(Any)The event(s) being documented, as code(s), reference(s), or both
Binding: v3 Code System ActCode icon (Example)

... section C0..*BackboneElementComposition is broken into sections
+ Rule: A section must contain at least one of text, entries, or sub-sections
+ Rule: A section can only have an emptyReason if it is empty

.... title 0..1stringLabel for section (e.g. for ToC)
.... code 0..1CodeableConceptClassification of section (recommended)
Binding: Document Section Codes (Example)
.... author 0..*Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization)Who and/or what authored the section

.... focus 0..1Reference(Any)Who/what the section is about, when it is not about the subject of composition
.... text C0..1NarrativeText summary of the section, for human interpretation
.... orderedBy 0..1CodeableConceptOrder of section entries
Binding: List Order Codes (Preferred)
.... entry C0..*Reference(Any)A reference to data that supports this section

.... emptyReason C0..1CodeableConceptWhy the section is empty
Binding: List Empty Reasons (Preferred)
.... section 0..*see sectionNested Section


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

Composition (DomainResource)An absolute URI that is used to identify this Composition when it is referenced in a specification, model, design or an instance; also called its canonical identifier. This SHOULD be globally unique and SHOULD be a literal address at which an authoritative instance of this Composition is (or will be) published. This URL can be the target of a canonical reference. It SHALL remain the same when the Composition is stored on different serversurl : uri [0..1]A version-independent identifier for the Composition. This identifier stays constant as the composition is changed over timeidentifier : Identifier [0..*]An explicitly assigned identifer of a variation of the content in the Compositionversion : string [0..1]The workflow/clinical status of this composition. The status is a marker for the clinical standing of the document (this element modifies the meaning of other elements)status : code [1..1] « null (Strength=Required)CompositionStatus! »Specifies the particular kind of composition (e.g. History and Physical, Discharge Summary, Progress Note). This usually equates to the purpose of making the compositiontype : CodeableConcept [1..1] « null (Strength=Preferred)FHIRDocumentTypeCodes? »A categorization for the type of the composition - helps for indexing and searching. This may be implied by or derived from the code specified in the Composition Typecategory : CodeableConcept [0..*] « null (Strength=Example)ReferencedItemCategoryValueSet?? »Who or what the composition is about. The composition can be about a person, (patient or healthcare practitioner), a device (e.g. a machine) or even a group of subjects (such as a document about a herd of livestock, or a set of patients that share a common exposure)subject : Reference [0..*] « Any »Describes the clinical encounter or type of care this documentation is associated withencounter : Reference [0..1] « Encounter »The composition editing time, when the composition was last logically changed by the authordate : dateTime [1..1]The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate Composition instancesuseContext : UsageContext [0..*]Identifies who is responsible for the information in the composition, not necessarily who typed it inauthor : Reference [1..*] « Practitioner|PractitionerRole|Device| Patient|RelatedPerson|Organization »A natural language name identifying the {{title}}. This name should be usable as an identifier for the module by machine processing applications such as code generationname : string [0..1]Official human-readable label for the compositiontitle : string [1..1]For any additional notesnote : Annotation [0..*]Identifies the organization or group who is responsible for ongoing maintenance of and access to the composition/document informationcustodian : Reference [0..1] « Organization »Relationships that this composition has with other compositions or documents that already existrelatesTo : RelatedArtifact [0..*]AttesterThe type of attestation the authenticator offersmode : CodeableConcept [1..1] « null (Strength=Preferred)CompositionAttestationMode? »When the composition was attested by the partytime : dateTime [0..1]Who attested the composition in the specified wayparty : Reference [0..1] « Patient|RelatedPerson|Practitioner| PractitionerRole|Organization »EventThe period of time covered by the documentation. There is no assertion that the documentation is a complete representation for this period, only that it documents events during this timeperiod : Period [0..1]Represents the main clinical acts, such as a colonoscopy or an appendectomy, being documented. In some cases, the event is inherent in the typeCode, such as a "History and Physical Report" in which case the procedure being documented is necessarily a "History and Physical" act. The events may be included as a code or as a reference to an other resourcedetail : CodeableReference [0..*] « Any; null (Strength=Example)ActCode?? »SectionThe label for this particular section. This will be part of the rendered content for the document, and is often used to build a table of contentstitle : string [0..1]A code identifying the kind of content contained within the section. This must be consistent with the section titlecode : CodeableConcept [0..1] « null (Strength=Example)DocumentSectionCodes?? »Identifies who is responsible for the information in this section, not necessarily who typed it inauthor : Reference [0..*] « Practitioner|PractitionerRole|Device| Patient|RelatedPerson|Organization »The actual focus of the section when it is not the subject of the composition, but instead represents something or someone associated with the subject such as (for a patient subject) a spouse, parent, fetus, or donor. If not focus is specified, the focus is assumed to be focus of the parent section, or, for a section in the Composition itself, the subject of the composition. Sections with a focus SHALL only include resources where the logical subject (patient, subject, focus, etc.) matches the section focus, or the resources have no logical subject (few resources)focus : Reference [0..1] « Any »A human-readable narrative that contains the attested content of the section, used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrativetext : Narrative [0..1] « This element has or is affected by some invariantsC »Specifies the order applied to the items in the section entriesorderedBy : CodeableConcept [0..1] « null (Strength=Preferred)ListOrderCodes? »A reference to the actual resource from which the narrative in the section is derivedentry : Reference [0..*] « Any » « This element has or is affected by some invariantsC »If the section is empty, why the list is empty. An empty section typically has some text explaining the empty reasonemptyReason : CodeableConcept [0..1] « null (Strength=Preferred)ListEmptyReasons? » « This element has or is affected by some invariantsC »A participant who has attested to the accuracy of the composition/documentattester[0..*]The clinical service, such as a colonoscopy or an appendectomy, being documentedevent[0..*]A nested sub-section within this sectionsection[0..*]The root of the sections that make up the compositionsection[0..*]

XML Template

<Composition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 0..1 Canonical identifier for this Composition, represented as a URI (globally unique) -->
 <identifier><!-- 0..* Identifier Version-independent identifier for the Composition --></identifier>
 <version value="[string]"/><!-- 0..1 An explicitly assigned identifer of a variation of the content in the Composition -->
 <status value="[code]"/><!-- 1..1 registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown -->
 <type><!-- 1..1 CodeableConcept Kind of composition (LOINC if possible) --></type>
 <category><!-- 0..* CodeableConcept Categorization of Composition --></category>
 <subject><!-- 0..* Reference(Any) 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 -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>
 <author><!-- 1..* Reference(Device|Organization|Patient|Practitioner|
   PractitionerRole|RelatedPerson) Who and/or what authored the composition --></author>
 <name value="[string]"/><!-- 0..1 Name for this Composition (computer friendly) -->
 <title value="[string]"/><!-- 1..1 Human Readable name/title -->
 <note><!-- 0..* Annotation For any additional notes --></note>
 <attester>  <!-- 0..* Attests to accuracy of composition -->
  <mode><!-- 1..1 CodeableConcept personal | professional | legal | official --></mode>
  <time value="[dateTime]"/><!-- 0..1 When the composition was attested -->
  <party><!-- 0..1 Reference(Organization|Patient|Practitioner|PractitionerRole|
    RelatedPerson) Who attested the composition --></party>
 </attester>
 <custodian><!-- 0..1 Reference(Organization) Organization which maintains the composition --></custodian>
 <relatesTo><!-- 0..* RelatedArtifact Relationships to other compositions/documents --></relatesTo>
 <event>  <!-- 0..* The clinical service(s) being documented -->
  <period><!-- 0..1 Period The period covered by the documentation --></period>
  <detail><!-- 0..* CodeableReference(Any) The event(s) being documented, as code(s), reference(s), or both icon --></detail>
 </event>
 <section>  <!-- 0..* Composition is broken into sections -->
  <title value="[string]"/><!-- 0..1 Label for section (e.g. for ToC) -->
  <code><!-- 0..1 CodeableConcept Classification of section (recommended) --></code>
  <author><!-- 0..* Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) Who and/or what authored the section --></author>
  <focus><!-- 0..1 Reference(Any) Who/what the section is about, when it is not about the subject of composition --></focus>
  <text><!-- I 0..1 Narrative Text summary of the section, for human interpretation --></text>
  <orderedBy><!-- 0..1 CodeableConcept Order of section entries --></orderedBy>
  <entry><!-- I 0..* Reference(Any) A reference to data that supports this section --></entry>
  <emptyReason><!-- I 0..1 CodeableConcept Why the section is empty --></emptyReason>
  <section><!-- 0..* Content as for Composition.section Nested Section --></section>
 </section>
</Composition>

JSON Template

{doco
  "resourceType" : "Composition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Canonical identifier for this Composition, represented as a URI (globally unique)
  "identifier" : [{ Identifier }], // Version-independent identifier for the Composition
  "version" : "<string>", // An explicitly assigned identifer of a variation of the content in the Composition
  "status" : "<code>", // R!  registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
  "type" : { CodeableConcept }, // R!  Kind of composition (LOINC if possible)
  "category" : [{ CodeableConcept }], // Categorization of Composition
  "subject" : [{ Reference(Any) }], // Who and/or what the composition is about
  "encounter" : { Reference(Encounter) }, // Context of the Composition
  "date" : "<dateTime>", // R!  Composition editing time
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "author" : [{ Reference(Device|Organization|Patient|Practitioner|
   PractitionerRole|RelatedPerson) }], // R!  Who and/or what authored the composition
  "name" : "<string>", // Name for this Composition (computer friendly)
  "title" : "<string>", // R!  Human Readable name/title
  "note" : [{ Annotation }], // For any additional notes
  "attester" : [{ // Attests to accuracy of composition
    "mode" : { CodeableConcept }, // R!  personal | professional | legal | official
    "time" : "<dateTime>", // When the composition was attested
    "party" : { Reference(Organization|Patient|Practitioner|PractitionerRole|
    RelatedPerson) } // Who attested the composition
  }],
  "custodian" : { Reference(Organization) }, // Organization which maintains the composition
  "relatesTo" : [{ RelatedArtifact }], // Relationships to other compositions/documents
  "event" : [{ // The clinical service(s) being documented
    "period" : { Period }, // The period covered by the documentation
    "detail" : [{ CodeableReference(Any) }] // The event(s) being documented, as code(s), reference(s), or both icon
  }],
  "section" : [{ // Composition is broken into sections
    "title" : "<string>", // Label for section (e.g. for ToC)
    "code" : { CodeableConcept }, // Classification of section (recommended)
    "author" : [{ Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) }], // Who and/or what authored the section
    "focus" : { Reference(Any) }, // Who/what the section is about, when it is not about the subject of composition
    "text" : { Narrative }, // I Text summary of the section, for human interpretation
    "orderedBy" : { CodeableConcept }, // Order of section entries
    "entry" : [{ Reference(Any) }], // I A reference to data that supports this section
    "emptyReason" : { CodeableConcept }, // I Why the section is empty
    "section" : [{ Content as for Composition.section }] // Nested Section
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:Composition;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:url [ uri ] ; # 0..1 Canonical identifier for this Composition, represented as a URI (globally unique)
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Version-independent identifier for the Composition
  fhir:version [ string ] ; # 0..1 An explicitly assigned identifer of a variation of the content in the Composition
  fhir:status [ code ] ; # 1..1 registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
  fhir:type [ CodeableConcept ] ; # 1..1 Kind of composition (LOINC if possible)
  fhir:category  ( [ CodeableConcept ] ... ) ; # 0..* Categorization of Composition
  fhir:subject  ( [ Reference(Any) ] ... ) ; # 0..* Who and/or what the composition is about
  fhir:encounter [ Reference(Encounter) ] ; # 0..1 Context of the Composition
  fhir:date [ dateTime ] ; # 1..1 Composition editing time
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support
  fhir:author  ( [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ... ) ; # 1..* Who and/or what authored the composition
  fhir:name [ string ] ; # 0..1 Name for this Composition (computer friendly)
  fhir:title [ string ] ; # 1..1 Human Readable name/title
  fhir:note  ( [ Annotation ] ... ) ; # 0..* For any additional notes
  fhir:attester ( [ # 0..* Attests to accuracy of composition
    fhir:mode [ CodeableConcept ] ; # 1..1 personal | professional | legal | official
    fhir:time [ dateTime ] ; # 0..1 When the composition was attested
    fhir:party [ Reference(Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who attested the composition
  ] ... ) ;
  fhir:custodian [ Reference(Organization) ] ; # 0..1 Organization which maintains the composition
  fhir:relatesTo  ( [ RelatedArtifact ] ... ) ; # 0..* Relationships to other compositions/documents
  fhir:event ( [ # 0..* The clinical service(s) being documented
    fhir:period [ Period ] ; # 0..1 The period covered by the documentation
    fhir:detail  ( [ CodeableReference(Any) ] ... ) ; # 0..* The event(s) being documented, as code(s), reference(s), or both
  ] ... ) ;
  fhir:section ( [ # 0..* Composition is broken into sections
    fhir:title [ string ] ; # 0..1 Label for section (e.g. for ToC)
    fhir:code [ CodeableConcept ] ; # 0..1 Classification of section (recommended)
    fhir:author  ( [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ... ) ; # 0..* Who and/or what authored the section
    fhir:focus [ Reference(Any) ] ; # 0..1 Who/what the section is about, when it is not about the subject of composition
    fhir:text [ Narrative ] ; # 0..1 I Text summary of the section, for human interpretation
    fhir:orderedBy [ CodeableConcept ] ; # 0..1 Order of section entries
    fhir:entry  ( [ Reference(Any) ] ... ) ; # 0..* I A reference to data that supports this section
    fhir:emptyReason [ CodeableConcept ] ; # 0..1 I Why the section is empty
    fhir:section  ( [ See Composition.section ] ... ) ; # 0..* Nested Section
  ] ... ) ;
]

Changes from both R4 and R4B

Composition
Composition.url
  • Added Element
Composition.identifier
  • Max Cardinality changed from 1 to *
Composition.version
  • Added Element
Composition.status
  • Add codes registered, partial, corrected, appended, cancelled, deprecated, unknown
Composition.subject
  • Max Cardinality changed from 1 to *
Composition.useContext
  • Added Element
Composition.name
  • Added Element
Composition.note
  • Added Element
Composition.attester.mode
  • Type changed from code to CodeableConcept
  • Remove Binding `http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.0.0` (required)
Composition.relatesTo
  • Type changed from BackboneElement to RelatedArtifact
Composition.event.detail
  • Type changed from Reference(Resource) to CodeableReference
Composition.confidentiality
  • Deleted
Composition.relatesTo.code
  • Deleted
Composition.relatesTo.target[x]
  • Deleted
Composition.event.code
  • Deleted
Composition.section.mode
  • Deleted

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

See R4 <--> R5 Conversion Maps (status = See Conversions Summary.)

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Composition TUDomainResourceA set of resources composed into a single coherent clinical statement with clinical attestation

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... url Σ0..1uriCanonical identifier for this Composition, represented as a URI (globally unique)
... identifier Σ0..*IdentifierVersion-independent identifier for the Composition

... version Σ0..1stringAn explicitly assigned identifer of a variation of the content in the Composition
... type Σ1..1CodeableConceptKind of composition (LOINC if possible)
Binding: FHIR Document Type Codes (Preferred)
... category Σ0..*CodeableConceptCategorization of Composition
Binding: Referenced Item Category Value Set (Example)

... subject Σ0..*Reference(Any)Who and/or what the composition is about

... encounter Σ0..1Reference(Encounter)Context of the Composition
... date Σ1..1dateTimeComposition editing time
... useContext Σ0..*UsageContextThe context that the content is intended to support

... author Σ1..*Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization)Who and/or what authored the composition

... name Σ0..1stringName for this Composition (computer friendly)
... title Σ1..1stringHuman Readable name/title
... note 0..*AnnotationFor any additional notes

... attester 0..*BackboneElementAttests to accuracy of composition

.... mode 1..1CodeableConceptpersonal | professional | legal | official
Binding: Composition Attestation Mode (Preferred)
.... time 0..1dateTimeWhen the composition was attested
.... party 0..1Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization)Who attested the composition
... custodian Σ0..1Reference(Organization)Organization which maintains the composition
... relatesTo 0..*RelatedArtifactRelationships to other compositions/documents

... event Σ0..*BackboneElementThe clinical service(s) being documented

.... period Σ0..1PeriodThe period covered by the documentation
.... detail Σ0..*CodeableReference(Any)The event(s) being documented, as code(s), reference(s), or both
Binding: v3 Code System ActCode icon (Example)

... section C0..*BackboneElementComposition is broken into sections
+ Rule: A section must contain at least one of text, entries, or sub-sections
+ Rule: A section can only have an emptyReason if it is empty

.... title 0..1stringLabel for section (e.g. for ToC)
.... code 0..1CodeableConceptClassification of section (recommended)
Binding: Document Section Codes (Example)
.... author 0..*Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization)Who and/or what authored the section

.... focus 0..1Reference(Any)Who/what the section is about, when it is not about the subject of composition
.... text C0..1NarrativeText summary of the section, for human interpretation
.... orderedBy 0..1CodeableConceptOrder of section entries
Binding: List Order Codes (Preferred)
.... entry C0..*Reference(Any)A reference to data that supports this section

.... emptyReason C0..1CodeableConceptWhy the section is empty
Binding: List Empty Reasons (Preferred)
.... section 0..*see sectionNested Section


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

Composition (DomainResource)An absolute URI that is used to identify this Composition when it is referenced in a specification, model, design or an instance; also called its canonical identifier. This SHOULD be globally unique and SHOULD be a literal address at which an authoritative instance of this Composition is (or will be) published. This URL can be the target of a canonical reference. It SHALL remain the same when the Composition is stored on different serversurl : uri [0..1]A version-independent identifier for the Composition. This identifier stays constant as the composition is changed over timeidentifier : Identifier [0..*]An explicitly assigned identifer of a variation of the content in the Compositionversion : string [0..1]The workflow/clinical status of this composition. The status is a marker for the clinical standing of the document (this element modifies the meaning of other elements)status : code [1..1] « null (Strength=Required)CompositionStatus! »Specifies the particular kind of composition (e.g. History and Physical, Discharge Summary, Progress Note). This usually equates to the purpose of making the compositiontype : CodeableConcept [1..1] « null (Strength=Preferred)FHIRDocumentTypeCodes? »A categorization for the type of the composition - helps for indexing and searching. This may be implied by or derived from the code specified in the Composition Typecategory : CodeableConcept [0..*] « null (Strength=Example)ReferencedItemCategoryValueSet?? »Who or what the composition is about. The composition can be about a person, (patient or healthcare practitioner), a device (e.g. a machine) or even a group of subjects (such as a document about a herd of livestock, or a set of patients that share a common exposure)subject : Reference [0..*] « Any »Describes the clinical encounter or type of care this documentation is associated withencounter : Reference [0..1] « Encounter »The composition editing time, when the composition was last logically changed by the authordate : dateTime [1..1]The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate Composition instancesuseContext : UsageContext [0..*]Identifies who is responsible for the information in the composition, not necessarily who typed it inauthor : Reference [1..*] « Practitioner|PractitionerRole|Device| Patient|RelatedPerson|Organization »A natural language name identifying the {{title}}. This name should be usable as an identifier for the module by machine processing applications such as code generationname : string [0..1]Official human-readable label for the compositiontitle : string [1..1]For any additional notesnote : Annotation [0..*]Identifies the organization or group who is responsible for ongoing maintenance of and access to the composition/document informationcustodian : Reference [0..1] « Organization »Relationships that this composition has with other compositions or documents that already existrelatesTo : RelatedArtifact [0..*]AttesterThe type of attestation the authenticator offersmode : CodeableConcept [1..1] « null (Strength=Preferred)CompositionAttestationMode? »When the composition was attested by the partytime : dateTime [0..1]Who attested the composition in the specified wayparty : Reference [0..1] « Patient|RelatedPerson|Practitioner| PractitionerRole|Organization »EventThe period of time covered by the documentation. There is no assertion that the documentation is a complete representation for this period, only that it documents events during this timeperiod : Period [0..1]Represents the main clinical acts, such as a colonoscopy or an appendectomy, being documented. In some cases, the event is inherent in the typeCode, such as a "History and Physical Report" in which case the procedure being documented is necessarily a "History and Physical" act. The events may be included as a code or as a reference to an other resourcedetail : CodeableReference [0..*] « Any; null (Strength=Example)ActCode?? »SectionThe label for this particular section. This will be part of the rendered content for the document, and is often used to build a table of contentstitle : string [0..1]A code identifying the kind of content contained within the section. This must be consistent with the section titlecode : CodeableConcept [0..1] « null (Strength=Example)DocumentSectionCodes?? »Identifies who is responsible for the information in this section, not necessarily who typed it inauthor : Reference [0..*] « Practitioner|PractitionerRole|Device| Patient|RelatedPerson|Organization »The actual focus of the section when it is not the subject of the composition, but instead represents something or someone associated with the subject such as (for a patient subject) a spouse, parent, fetus, or donor. If not focus is specified, the focus is assumed to be focus of the parent section, or, for a section in the Composition itself, the subject of the composition. Sections with a focus SHALL only include resources where the logical subject (patient, subject, focus, etc.) matches the section focus, or the resources have no logical subject (few resources)focus : Reference [0..1] « Any »A human-readable narrative that contains the attested content of the section, used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrativetext : Narrative [0..1] « This element has or is affected by some invariantsC »Specifies the order applied to the items in the section entriesorderedBy : CodeableConcept [0..1] « null (Strength=Preferred)ListOrderCodes? »A reference to the actual resource from which the narrative in the section is derivedentry : Reference [0..*] « Any » « This element has or is affected by some invariantsC »If the section is empty, why the list is empty. An empty section typically has some text explaining the empty reasonemptyReason : CodeableConcept [0..1] « null (Strength=Preferred)ListEmptyReasons? » « This element has or is affected by some invariantsC »A participant who has attested to the accuracy of the composition/documentattester[0..*]The clinical service, such as a colonoscopy or an appendectomy, being documentedevent[0..*]A nested sub-section within this sectionsection[0..*]The root of the sections that make up the compositionsection[0..*]

XML Template

<Composition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 0..1 Canonical identifier for this Composition, represented as a URI (globally unique) -->
 <identifier><!-- 0..* Identifier Version-independent identifier for the Composition --></identifier>
 <version value="[string]"/><!-- 0..1 An explicitly assigned identifer of a variation of the content in the Composition -->
 <status value="[code]"/><!-- 1..1 registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown -->
 <type><!-- 1..1 CodeableConcept Kind of composition (LOINC if possible) --></type>
 <category><!-- 0..* CodeableConcept Categorization of Composition --></category>
 <subject><!-- 0..* Reference(Any) 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 -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>
 <author><!-- 1..* Reference(Device|Organization|Patient|Practitioner|
   PractitionerRole|RelatedPerson) Who and/or what authored the composition --></author>
 <name value="[string]"/><!-- 0..1 Name for this Composition (computer friendly) -->
 <title value="[string]"/><!-- 1..1 Human Readable name/title -->
 <note><!-- 0..* Annotation For any additional notes --></note>
 <attester>  <!-- 0..* Attests to accuracy of composition -->
  <mode><!-- 1..1 CodeableConcept personal | professional | legal | official --></mode>
  <time value="[dateTime]"/><!-- 0..1 When the composition was attested -->
  <party><!-- 0..1 Reference(Organization|Patient|Practitioner|PractitionerRole|
    RelatedPerson) Who attested the composition --></party>
 </attester>
 <custodian><!-- 0..1 Reference(Organization) Organization which maintains the composition --></custodian>
 <relatesTo><!-- 0..* RelatedArtifact Relationships to other compositions/documents --></relatesTo>
 <event>  <!-- 0..* The clinical service(s) being documented -->
  <period><!-- 0..1 Period The period covered by the documentation --></period>
  <detail><!-- 0..* CodeableReference(Any) The event(s) being documented, as code(s), reference(s), or both icon --></detail>
 </event>
 <section>  <!-- 0..* Composition is broken into sections -->
  <title value="[string]"/><!-- 0..1 Label for section (e.g. for ToC) -->
  <code><!-- 0..1 CodeableConcept Classification of section (recommended) --></code>
  <author><!-- 0..* Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) Who and/or what authored the section --></author>
  <focus><!-- 0..1 Reference(Any) Who/what the section is about, when it is not about the subject of composition --></focus>
  <text><!-- I 0..1 Narrative Text summary of the section, for human interpretation --></text>
  <orderedBy><!-- 0..1 CodeableConcept Order of section entries --></orderedBy>
  <entry><!-- I 0..* Reference(Any) A reference to data that supports this section --></entry>
  <emptyReason><!-- I 0..1 CodeableConcept Why the section is empty --></emptyReason>
  <section><!-- 0..* Content as for Composition.section Nested Section --></section>
 </section>
</Composition>

JSON Template

{doco
  "resourceType" : "Composition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Canonical identifier for this Composition, represented as a URI (globally unique)
  "identifier" : [{ Identifier }], // Version-independent identifier for the Composition
  "version" : "<string>", // An explicitly assigned identifer of a variation of the content in the Composition
  "status" : "<code>", // R!  registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
  "type" : { CodeableConcept }, // R!  Kind of composition (LOINC if possible)
  "category" : [{ CodeableConcept }], // Categorization of Composition
  "subject" : [{ Reference(Any) }], // Who and/or what the composition is about
  "encounter" : { Reference(Encounter) }, // Context of the Composition
  "date" : "<dateTime>", // R!  Composition editing time
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "author" : [{ Reference(Device|Organization|Patient|Practitioner|
   PractitionerRole|RelatedPerson) }], // R!  Who and/or what authored the composition
  "name" : "<string>", // Name for this Composition (computer friendly)
  "title" : "<string>", // R!  Human Readable name/title
  "note" : [{ Annotation }], // For any additional notes
  "attester" : [{ // Attests to accuracy of composition
    "mode" : { CodeableConcept }, // R!  personal | professional | legal | official
    "time" : "<dateTime>", // When the composition was attested
    "party" : { Reference(Organization|Patient|Practitioner|PractitionerRole|
    RelatedPerson) } // Who attested the composition
  }],
  "custodian" : { Reference(Organization) }, // Organization which maintains the composition
  "relatesTo" : [{ RelatedArtifact }], // Relationships to other compositions/documents
  "event" : [{ // The clinical service(s) being documented
    "period" : { Period }, // The period covered by the documentation
    "detail" : [{ CodeableReference(Any) }] // The event(s) being documented, as code(s), reference(s), or both icon
  }],
  "section" : [{ // Composition is broken into sections
    "title" : "<string>", // Label for section (e.g. for ToC)
    "code" : { CodeableConcept }, // Classification of section (recommended)
    "author" : [{ Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) }], // Who and/or what authored the section
    "focus" : { Reference(Any) }, // Who/what the section is about, when it is not about the subject of composition
    "text" : { Narrative }, // I Text summary of the section, for human interpretation
    "orderedBy" : { CodeableConcept }, // Order of section entries
    "entry" : [{ Reference(Any) }], // I A reference to data that supports this section
    "emptyReason" : { CodeableConcept }, // I Why the section is empty
    "section" : [{ Content as for Composition.section }] // Nested Section
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:Composition;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:url [ uri ] ; # 0..1 Canonical identifier for this Composition, represented as a URI (globally unique)
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Version-independent identifier for the Composition
  fhir:version [ string ] ; # 0..1 An explicitly assigned identifer of a variation of the content in the Composition
  fhir:status [ code ] ; # 1..1 registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
  fhir:type [ CodeableConcept ] ; # 1..1 Kind of composition (LOINC if possible)
  fhir:category  ( [ CodeableConcept ] ... ) ; # 0..* Categorization of Composition
  fhir:subject  ( [ Reference(Any) ] ... ) ; # 0..* Who and/or what the composition is about
  fhir:encounter [ Reference(Encounter) ] ; # 0..1 Context of the Composition
  fhir:date [ dateTime ] ; # 1..1 Composition editing time
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support
  fhir:author  ( [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ... ) ; # 1..* Who and/or what authored the composition
  fhir:name [ string ] ; # 0..1 Name for this Composition (computer friendly)
  fhir:title [ string ] ; # 1..1 Human Readable name/title
  fhir:note  ( [ Annotation ] ... ) ; # 0..* For any additional notes
  fhir:attester ( [ # 0..* Attests to accuracy of composition
    fhir:mode [ CodeableConcept ] ; # 1..1 personal | professional | legal | official
    fhir:time [ dateTime ] ; # 0..1 When the composition was attested
    fhir:party [ Reference(Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who attested the composition
  ] ... ) ;
  fhir:custodian [ Reference(Organization) ] ; # 0..1 Organization which maintains the composition
  fhir:relatesTo  ( [ RelatedArtifact ] ... ) ; # 0..* Relationships to other compositions/documents
  fhir:event ( [ # 0..* The clinical service(s) being documented
    fhir:period [ Period ] ; # 0..1 The period covered by the documentation
    fhir:detail  ( [ CodeableReference(Any) ] ... ) ; # 0..* The event(s) being documented, as code(s), reference(s), or both
  ] ... ) ;
  fhir:section ( [ # 0..* Composition is broken into sections
    fhir:title [ string ] ; # 0..1 Label for section (e.g. for ToC)
    fhir:code [ CodeableConcept ] ; # 0..1 Classification of section (recommended)
    fhir:author  ( [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ... ) ; # 0..* Who and/or what authored the section
    fhir:focus [ Reference(Any) ] ; # 0..1 Who/what the section is about, when it is not about the subject of composition
    fhir:text [ Narrative ] ; # 0..1 I Text summary of the section, for human interpretation
    fhir:orderedBy [ CodeableConcept ] ; # 0..1 Order of section entries
    fhir:entry  ( [ Reference(Any) ] ... ) ; # 0..* I A reference to data that supports this section
    fhir:emptyReason [ CodeableConcept ] ; # 0..1 I Why the section is empty
    fhir:section  ( [ See Composition.section ] ... ) ; # 0..* Nested Section
  ] ... ) ;
]

Changes from both R4 and R4B

Composition
Composition.url
  • Added Element
Composition.identifier
  • Max Cardinality changed from 1 to *
Composition.version
  • Added Element
Composition.status
  • Add codes registered, partial, corrected, appended, cancelled, deprecated, unknown
Composition.subject
  • Max Cardinality changed from 1 to *
Composition.useContext
  • Added Element
Composition.name
  • Added Element
Composition.note
  • Added Element
Composition.attester.mode
  • Type changed from code to CodeableConcept
  • Remove Binding `http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.0.0` (required)
Composition.relatesTo
  • Type changed from BackboneElement to RelatedArtifact
Composition.event.detail
  • Type changed from Reference(Resource) to CodeableReference
Composition.confidentiality
  • Deleted
Composition.relatesTo.code
  • Deleted
Composition.relatesTo.target[x]
  • Deleted
Composition.event.code
  • Deleted
Composition.section.mode
  • Deleted

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

See R4 <--> R5 Conversion Maps (status = See Conversions Summary.)

 

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis

2.8.5.1 Terminology Bindings

PathValueSetTypeDocumentation
Composition.status CompositionStatus Required

The workflow/clinical status of the composition.
Composition.type FHIRDocumentTypeCodes Preferred

FHIR Document Codes - all LOINC codes where scale type = 'DOC'.
Composition.category ReferencedItemCategoryValueSet Example

This is the code specifying the high-level kind of document (e.g. Prescription, Discharge Summary, Report, etc.). Made up of a set of non-healthcare specific codes and all LOINC codes where scale type = 'DOC'.
Composition.attester.mode CompositionAttestationMode Preferred

The way in which a person authenticated a composition.
Composition.event.detail ActCode icon Example

A code specifying the particular kind of Act that the Act-instance represents within its class. Constraints: The kind of Act (e.g. physical examination, serum potassium, inpatient encounter, charge financial transaction, etc.) is specified with a code from one of several, typically external, coding systems. The coding system will depend on the class of Act, such as LOINC for observations, etc. Conceptually, the Act.code must be a specialization of the Act.classCode. This is why the structure of ActClass domain should be reflected in the superstructure of the ActCode domain and then individual codes or externally referenced vocabularies subordinated under these domains that reflect the ActClass structure. Act.classCode and Act.code are not modifiers of each other but the Act.code concept should really imply the Act.classCode concept. For a negative example, it is not appropriate to use an Act.code "potassium" together with and Act.classCode for "laboratory observation" to somehow mean "potassium laboratory observation" and then use the same Act.code for "potassium" together with Act.classCode for "medication" to mean "substitution of potassium". This mutually modifying use of Act.code and Act.classCode is not permitted.
Composition.section.code DocumentSectionCodes Example

Document section codes (LOINC codes used in CCDA sections).
Composition.section.orderedBy ListOrderCodes Preferred

Base values for the order of the items in a list resource.
Composition.section.emptyReason ListEmptyReasons Preferred

General reasons for a list to be empty. Reasons are either related to a summary list (i.e. problem or medication list) or to a workflow related list (i.e. consultation list).

2.8.5.2 Constraints

UniqueKeyLevelLocationDescriptionExpression
img cmp-1Rule Composition.sectionA section must contain at least one of text, entries, or sub-sectionstext.exists() or entry.exists() or section.exists()
img cmp-2Rule Composition.sectionA section can only have an emptyReason if it is emptyemptyReason.empty() or entry.empty()

2.8.6 Notes:

  • The author and the attester are often the same person, but this might not be the case in some clinical workflows.
  • The attester attests contents of the document resource, the subject resource and the resources referred to in the Composition.section.content references. Because documents are often derived Compositions and the attestation from the composition is held to apply to the document, the method for presenting a document should be used when/if attesters review the content of the composition.
  • The custodian is responsible for the maintenance of the composition and any documents derived from it. With regard to the documents, they are responsible for the policy regarding persistence of the documents. Although they need not actually retain a copy of the document, they SHOULD do so.
  • It is acceptable for a Composition to contain only narrative (Composition.section.text) and no entries (Composition.section.entry)

2.8.7 Compositions about multiple entities

Typically, a composition is made about the subject - e.g. a patient, or group of patients, location, or device - and the distinction between the subject and the composition describes the subject. Some kinds of documents contain data about other parties or entities that are relevant to the subject of the document. Some examples:

  • A neonatal discharge summary that contains information about the mother
  • A family history document that contains multiple sections for different family members
  • A social health evaluation document that contains information about the patient's family members
  • A procedure report that contains details about a device implanted in the patient

In all these cases, the subject of the document is a single patient, but some of the details are actually related to other persons or entities. When this happens, these other entities are detailed in the Composition.section.focus element. In the absence of a focus, it is assumed that the subject of the composition is the focus.

If a focus is specified, then the resources referred to from the section SHALL either:

  • specify that their subject (however named e.g. patient) or focus element (if present) is the focus indicated
  • not have a subject element

A few compositions genuinely cover multiple subjects - different sections are about different subjects. In such case, Composition.subject is omitted, and the extension section-subject is used on each section to indicate the subject.

Note to Implementers: Feedback is welcome on two issues related to Composition:

  • For many compositions, the title is the same as the text or a display name of Composition.type (e.g., a "consultation" or "progress note"). Note that CDA icon does not make title mandatory, but there are no known cases where it is useful for title to be omitted, so it is mandatory here during the trial use period.
  • A client can ask a server to generate a fully bundled document from a Composition resource using the $document operation. This operation definition does not resolve the question how document signatures are created. This is an open issue during the period of trial use, and feedback is requested regarding this question.

Feedback here icon.

2.8.8 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
attesterreferenceWho attested the compositionComposition.attester.party
(Practitioner, Organization, Patient, PractitionerRole, RelatedPerson)
authorreferenceWho and/or what authored the compositionComposition.author
(Practitioner, Organization, Device, Patient, PractitionerRole, RelatedPerson)
categorytokenCategorization of CompositionComposition.category
datedateComposition editing timeComposition.date27 Resources
encounterreferenceContext of the CompositionComposition.encounter
(Encounter)		29 Resources
entryreferenceA reference to data that supports this sectionComposition.section.entry
(Any)
event-codetokenMain clinical acts documented as codesComposition.event.detail.concept
event-referencereferenceMain clinical acts documented as referencesComposition.event.detail.reference
identifiertokenVersion-independent identifier for the CompositionComposition.identifier65 Resources
patientreferenceWho and/or what the composition is aboutComposition.subject.where(resolve() is Patient)
(Patient)		66 Resources
perioddateThe period covered by the documentationComposition.event.period
relatedreferenceTarget of the relationshipComposition.relatesTo.resourceReference
(Any)
sectiontokenClassification of section (recommended)Composition.section.code
section-code-textcompositeSearch on the section narrative of the resourceOn Composition.section:
  section: section.code
  section-text: section.text
section-textspecialSearch on the section narrative of the resourceComposition.section.text | Composition.section.section.text
statustokenpreliminary | final | amended | entered-in-errorComposition.status
subjectreferenceWho and/or what the composition is aboutComposition.subject
(Any)
titlestringHuman Readable name/titleComposition.title
typetokenKind of composition (LOINC if possible)Composition.type11 Resources
urluriThe uri that identifies the activity definitionComposition.url
versiontokenThe business version of the activity definitionComposition.version