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 timeidentifier : Identifier 0..1The composition editing time, when the composition was last logically changed by the authordate : dateTime 1..1Specifies 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 <<Type of a compositionDocumentType>>A categorization for the type of the composition. This may be implied by or derived from the code specified in the Composition Typeclass : CodeableConcept 0..1 <<SubType of a clinical documentDocumentClass>>Official human-readable label for the compositiontitle : string 0..1The 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 compositionCompositionStatus>>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 compositionDocumentConfidentiality>>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..1Identifies 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 informationcustodian : Resource(Organization) 0..1Describes the clinical encounter or type of care this documentation is associated withencounter : Resource(Encounter) 0..1AttesterThe type of attestation the authenticator offersmode : code 1..* <<The way in which a person authenticated a compositionCompositionAttestationMode>>When composition was attested by the partytime : dateTime 0..1Who attested the composition in the specified wayparty : Resource(Patient|Practitioner| Organization) 0..1EventThis 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" actcode : CodeableConcept 0..* <<This list of codes represents the main clinical acts being documentedDocumentEventType>>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 timeperiod : Period 0..1Full details for the event(s) the composition/documentation consentsdetail : Resource(Any) 0..*SectionThe heading for this particular section. This will be part of the rendered content for the documenttitle : string 0..1A code identifying the kind of content contained within the sectioncode : CodeableConcept 0..1 <<Classification of a composition / documentCompositionSectionType>>Identifies the primary subject of the section (this element modifies the meaning of other elements)subject : Resource(Patient|Group|Device) 0..1Identifies the discrete data that provides the content for the sectioncontent : Resource(Any) 0..1A participant who has attested to the accuracy of the composition/documentattester0..*The main event/act/item, such as a colonoscopy or an appendectomy, being documentedevent0..1A nested sub-section within this sectionsection0..*The root of the sections that make up the compositionsection0..*
<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

PathDefinitionTypeReference
Composition.type Type of a compositionIncompletehttp://hl7.org/fhir/vs/doc-codes
Composition.class SubType of a clinical documentExamplehttp://hl7.org/fhir/vs/xds-typecodes
Composition.status The workflow/clinical status of the compositionFixedhttp://hl7.org/fhir/composition-status
Composition.confidentiality Codes specifying the level of confidentiality of the compositionIncompletehttp://hl7.org/fhir/v3/vs/Confidentiality
Composition.attester.mode The way in which a person authenticated a compositionFixedhttp://hl7.org/fhir/composition-attestation-mode
Composition.event.code This list of codes represents the main clinical acts being documentedIncompletehttp://hl7.org/fhir/v3/vs/ActCode
Composition.section.code Classification of a composition / documentIncompletehttp://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.

NameTypeDescriptionPaths
_idtokenThe logical resource id associated with the resource (must be supported by all servers)
_languagetokenThe language of the resource
attesterreferenceWho attested the compositionComposition.attester.party
(Organization, Patient, Practitioner)
authorreferenceWho and/or what authored the compositionComposition.author
(Device, Patient, Practitioner, RelatedPerson)
classtokenCategorization of CompositionComposition.class
contexttokenCode(s) that apply to the event being documentedComposition.event.code
datedateComposition editing timeComposition.date
identifiertokenLogical identifier of composition (version-independent)Composition.identifier
section-contentreferenceThe actual data for the sectionComposition.section.content
(Any)
section-typetokenClassification of section (recommended)Composition.section.code
subjectreferenceWho and/or what the composition is aboutComposition.subject
(Device, Location, Patient, Practitioner, Group)
typetokenKind of composition (LOINC if possible)Composition.type

comments powered by Disqus