This page is part of the FHIR Specification (v0.0.82: DSTU 1). 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

6.8 Resource Composition - Content

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.

6.8.1 Scope and Usage

A Composition is also 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 uses the term "Composition" to refer to a single commit to an EHR system, and offers some common examples: a consultation note, a progress note, a report or a letter, an investigation report, a prescription form and a set of bedside nursing observations. These logical examples are all valid uses of a Composition resource, but it is not required that all the resources are updated in a single commit.

6.8.2 Background and Context

6.8.2.1 Composition Status Codes

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

Code Definition
preliminary This is a preliminary composition (also known as initial or interim). The content may be incomplete or unverified.
final The composition is complete and verified by an appropriate person and no further work is planned
appended The composition has been modified subsequent to being marked and/or released as "final" and is complete and verified by an authorized person. The modifications added new information to the composition, but did not revise existing content
amended The composition content or the referenced resources have been modified subsequent to being released as "final" and the composition is complete and verified by an authorized person
retracted The composition was originally created/issued in error and this is an amendment that marks that the entire composition and any past versions or copies should not be considered as valid

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

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 "retracted" 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 retracted. Note that systems that handle compositions or derived documents and don't support the retracted 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.

Note: for RIM-centric readers, see the v3 mapping for the codes and the RIM mapping for the element .

6.8.3 Resource Content

Composition ( Resource ) Logical Identifier for the composition, assigned when created. This identifier stays constant as the composition is changed over time identifier : Identifier 0..1 The composition editing time, when the composition was last logically changed by the author date : dateTime 1..1 Specifies the particular kind of composition (e.g. History and Physical, Discharge Summary, Progress Note). This usually equates to the purpose of making the composition type : CodeableConcept 1..1 << Type of a composition DocumentType >> A categorization for the type of the composition. This may be implied by or derived from the code specified in the Composition Type class : CodeableConcept 0..1 << SubType of a clinical document DocumentClass >> Official human-readable label for the composition title : 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 << The workflow/clinical status of the composition CompositionStatus >> The code specifying the level of confidentiality of the Composition (this element modifies the meaning of other elements) confidentiality : Coding 1..1 << Codes specifying the level of confidentiality of the composition DocumentConfidentiality >> Who or what the composition is about. The composition can be about a person, (patient or healthcare practitioner), a device (I.e. 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 : Resource ( Patient | Practitioner | Group | Device | Location ) 1..1 Identifies who is responsible for the information in the composition. (Not necessarily who typed it in.) author : Resource ( Practitioner | Device | Patient | RelatedPerson ) 1..* Identifies the organization or group who is responsible for ongoing maintenance of and access to the composition/document information custodian : Resource ( Organization ) 0..1 Describes the clinical encounter or type of care this documentation is associated with encounter : Resource ( Encounter ) 0..1 Attester The type of attestation the authenticator offers mode : code 1..* << The way in which a person authenticated a composition CompositionAttestationMode >> When composition was attested by the party time : dateTime 0..1 Who attested the composition in the specified way party : Resource ( Patient | Practitioner | Organization ) 0..1 Event This list of codes 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 the procedure being documented is necessarily a "History and Physical" act code : CodeableConcept 0..* << This list of codes represents the main clinical acts being documented DocumentEventType >> The 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 time period : Period 0..1 Full details for the event(s) the composition/documentation consents detail : Resource ( Any ) 0..* Section The heading for this particular section. This will be part of the rendered content for the document title : string 0..1 A code identifying the kind of content contained within the section code : CodeableConcept 0..1 << Classification of a composition / document CompositionSectionType >> Identifies the primary subject of the section (this element modifies the meaning of other elements) subject : Resource ( Patient | Group | Device ) 0..1 Identifies the discrete data that provides the content for the section content : Resource ( Any ) 0..1 A participant who has attested to the accuracy of the composition/document attester 0..* The main event/act/item, such as a colonoscopy or an appendectomy, being documented event 0..1 A nested sub-section within this section section 0..* The root of the sections that make up the composition section 0..*
<Composition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: extension, modifierExtension, language, text, and contained -->
 <identifier><!-- 0..1 Identifier 
     Logical identifier of composition (version-independent) § --></identifier>
 <date value="[dateTime]"/><!-- 1..1 Composition editing time § -->
 <type><!-- 1..1 CodeableConcept Kind of composition (LOINC if possible) § --></type>
 <class><!-- 0..1 CodeableConcept Categorization of Composition § --></class>
 <title value="[string]"/><!-- 0..1 Human Readable name/title § -->
 <status value="[code]"/><!-- 1..1 preliminary | final | appended | amended | entered in error § -->
 <confidentiality><!-- 1..1 Coding As defined by affinity domain § --></confidentiality>
 <subject><!-- 1..1 Resource(Patient|Practitioner|Group|Device|Location) 
     Who and/or what the composition is about § --></subject>
 <author><!-- 1..* Resource(Practitioner|Device|Patient|RelatedPerson) 
     Who and/or what authored the composition § --></author>
 <attester>  <!-- 0..* Attests to accuracy of composition § -->
  <mode value="[code]"/><!-- 1..* personal | professional | legal | official § -->
  <time value="[dateTime]"/><!-- 0..1 When composition attested § -->
  <party><!-- 0..1 Resource(Patient|Practitioner|Organization) Who attested the composition § --></party>
 </attester>
 <custodian><!-- 0..1 Resource(Organization) Org which maintains the composition § --></custodian>
 <event>  <!-- 0..1 The clinical event/act/item being documented § -->
  <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..* Resource(Any) Full details for the event(s) the composition consents § --></detail>
 </event>
 <encounter><!-- 0..1 Resource(Encounter) Context of the conposition § --></encounter>
 <section>  <!-- 0..* Composition is broken into sections -->
  <title value="[string]"/><!-- 0..1 Label for section -->
  <code><!-- 0..1 CodeableConcept Classification of section (recommended) --></code>
  <subject><!-- 0..1 Resource(Patient|Group|Device) If section different to composition --></subject>
  <content><!-- ?? 0..1 Resource(Any) The actual data for the section --></content>
  <section><!-- ?? 0..* Content as for Composition.section Nested Section --></section>
 </section>
</Composition>

Alternate definitions: Schema / Schematron , Resource Profile

6.8.3.1 Terminology Bindings

Path Definition Type Reference
Composition.type Type of a composition Incomplete http://hl7.org/fhir/vs/doc-codes
Composition.class SubType of a clinical document Example http://hl7.org/fhir/vs/xds-typecodes
Composition.status The workflow/clinical status of the composition Fixed http://hl7.org/fhir/composition-status
Composition.confidentiality Codes specifying the level of confidentiality of the composition Incomplete http://hl7.org/fhir/v3/vs/Confidentiality
Composition.attester.mode The way in which a person authenticated a composition Fixed http://hl7.org/fhir/composition-attestation-mode
Composition.event.code This list of codes represents the main clinical acts being documented Incomplete http://hl7.org/fhir/v3/vs/ActCode
Composition.section.code Classification of a composition / document Incomplete http://hl7.org/fhir/vs/doc-section-codes

6.8.3.2 Constraints

6.8.4 Notes:

6.8.5 Search Parameters

Search parameters for this resource. The standard parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Paths
_id token The logical resource id associated with the resource (must be supported by all servers)
_language token The language of the resource
attester reference Who attested the composition Composition.attester.party
( Organization , Patient , Practitioner )
author reference Who and/or what authored the composition Composition.author
( Device , Patient , Practitioner , RelatedPerson )
class token Categorization of Composition Composition.class
context token Code(s) that apply to the event being documented Composition.event.code
date date Composition editing time Composition.date
identifier token Logical identifier of composition (version-independent) Composition.identifier
section-content reference The actual data for the section Composition.section.content
(Any)
section-type token Classification of section (recommended) Composition.section.code
subject reference Who and/or what the composition is about Composition.subject
( Device , Location , Patient , Practitioner , Group )
type token Kind of composition (LOINC if possible) Composition.type

comments powered by Disqus