US Public Health Profiles Library, published by HL7 International / Public Health. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-us-ph-library/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/us/ph-library/StructureDefinition/us-ph-composition | Version: 2.0.0 | |||
| Standards status: Trial-use Active as of 2025-10-23 | Maturity Level: 3 | Computable Name: USPublicHealthComposition | ||
| Other Identifiers: OID:2.16.840.1.113883.4.642.40.58.42.7 | ||||
This Composition profile represents a public health composition.
| Use Case | Data Class | Data Element Name |
|---|---|---|
| Case Reporting | Reporting Data | Date of the Report |
Usages:
You can also check for usages in the FHIR IG Statistics
Description Differentials, Snapshots, and other representations.
| Name | Flags | Card. | Type | Description & Constraints Filter:   |
|---|---|---|---|---|
  Composition |
0..* | Composition(4.0.1) | US Public Health Composition | |
  implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
  Slices for extension |
1..* | Extension | Extension Slice: Unordered, Open by value:url Constraints: ext-1 | |
   extension:extensionVersionNumber |
S | 1..1 | string | Public Health Composition versionNumber URL: http://hl7.org/fhir/StructureDefinition/composition-clinicaldocument-versionNumber Constraints: ext-1 |
 extension:extensionInformationRecipient |
S | 0..* | Reference(US Core Practitioner Profile(6.1.0) | US Public Health PractitionerRole(2.0.0) | US Public Health Organization(2.0.0)) | Information Recipient URL: http://hl7.org/fhir/us/ph-library/StructureDefinition/us-ph-information-recipient-extension Constraints: ext-1 |
 modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored Constraints: ext-1 |
 identifier |
SΣ | 1..1 | Identifier | Public Health Composition identifier |
| status |
?!SΣ | 1..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required): The workflow/clinical status of the composition. |
| type |
SΣ | 1..1 | CodeableConcept | Type of this public health report Binding: FHIRDocumentTypeCodes (preferred): Type of a composition. |
 subject |
SΣ | 1..1 | Reference(US Public Health Patient(2.0.0) | US Core Patient Profile(6.1.0)) | Patient |
| encounter |
SΣ | 1..1 | Reference(US Public Health Encounter(2.0.0)) | Encounter related to the public health event |
| date |
SΣ | 1..1 | dateTime | (USCDI+) Date of the Report |
| author |
SΣ | 1..* | Reference(US Public Health PractitionerRole(2.0.0) | US Core Practitioner Profile(6.1.0) | US Public Health Organization(2.0.0) | Device) | The author(s) of the document |
| title |
SΣ | 1..1 | string | Human Readable name/title |
| custodian |
SΣ | 0..1 | Reference(US Public Health Organization(2.0.0)) | Custodian Organization Address, Custodian Organization Id, Custodian Organization Name, Custodian Organization Telecom (contained in referenced US Public Health Organization) |
  Slices for relatesTo |
S | 0..* | BackboneElement | Relationships to other compositions/documents Slice: Unordered, Open by value:code |
   relatesTo:All Slices |
Content/Rules for all slices | |||
 modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 |
| code |
1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. | |
  target[x] |
1..1 | Target of the relationship | ||
| targetIdentifier |
Identifier | |||
 targetReference |
Reference(Composition) | |||
| relatesTo:transformed |
S | 0..1 | BackboneElement | Document or Composition that this Composition is transformed from |
 modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 |
| code |
S | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. Fixed Value: transforms |
 target[x] |
S | 1..1 | Identifier | Identifier of the Document or Composition transformed |
| relatesTo:replaced |
S | 0..1 | BackboneElement | Document or Composition that this Composition replaces |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 |
| code |
S | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. Fixed Value: replaces |
 target[x] |
S | 1..1 | Identifier/Reference to the Document or Composition transformed | |
| targetIdentifier |
Identifier | |||
| targetReference |
Reference(Composition) | |||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.status | Base | required | CompositionStatus | 📍4.0.1 | FHIR Std. |
| Composition.type | Base | preferred | FHIR Document Type Codes | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo:transformed.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo:replaced.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Composition | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Composition | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Composition | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Composition | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Composition | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | Composition.implicitRules, Composition.extension, Composition.extension:extensionVersionNumber, Composition.extension:extensionInformationRecipient, Composition.modifierExtension, Composition.identifier, Composition.status, Composition.type, Composition.subject, Composition.encounter, Composition.date, Composition.author, Composition.title, Composition.custodian, Composition.relatesTo, Composition.relatesTo.modifierExtension, Composition.relatesTo.code, Composition.relatesTo.target[x], Composition.relatesTo:transformed, Composition.relatesTo:transformed.modifierExtension, Composition.relatesTo:transformed.code, Composition.relatesTo:transformed.target[x], Composition.relatesTo:replaced, Composition.relatesTo:replaced.modifierExtension, Composition.relatesTo:replaced.code, Composition.relatesTo:replaced.target[x] | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | Composition.extension, Composition.extension:extensionVersionNumber, Composition.extension:extensionInformationRecipient, Composition.modifierExtension, Composition.relatesTo.modifierExtension, Composition.relatesTo:transformed.modifierExtension, Composition.relatesTo:replaced.modifierExtension | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Composition |
0..* | Composition(4.0.1) | US Public Health Composition | |
| Slices for extension |
1..* | Extension | Extension Slice: Unordered, Open by value:url | |
| extension:extensionVersionNumber |
S | 1..1 | string | Public Health Composition versionNumber URL: http://hl7.org/fhir/StructureDefinition/composition-clinicaldocument-versionNumber |
| extension:extensionInformationRecipient |
S | 0..* | Reference(US Core Practitioner Profile(6.1.0) | US Public Health PractitionerRole(2.0.0) | US Public Health Organization(2.0.0)) | Information Recipient URL: http://hl7.org/fhir/us/ph-library/StructureDefinition/us-ph-information-recipient-extension |
| identifier |
S | 1..1 | Identifier | Public Health Composition identifier |
| status |
S | 1..1 | code | preliminary | final | amended | entered-in-error |
| type |
S | 1..1 | CodeableConcept | Type of this public health report |
| subject |
S | 1..1 | Reference(US Public Health Patient(2.0.0) | US Core Patient Profile(6.1.0)) | Patient |
| encounter |
S | 1..1 | Reference(US Public Health Encounter(2.0.0)) | Encounter related to the public health event |
| date |
S | 1..1 | dateTime | (USCDI+) Date of the Report |
| author |
S | 1..* | Reference(US Public Health PractitionerRole(2.0.0) | US Core Practitioner Profile(6.1.0) | US Public Health Organization(2.0.0) | Device) | The author(s) of the document |
| title |
S | 1..1 | string | Human Readable name/title |
| custodian |
S | 0..1 | Reference(US Public Health Organization(2.0.0)) | Custodian Organization Address, Custodian Organization Id, Custodian Organization Name, Custodian Organization Telecom (contained in referenced US Public Health Organization) |
| Slices for relatesTo |
S | 0..* | BackboneElement | Relationships to other compositions/documents Slice: Unordered, Open by value:code |
| relatesTo:transformed |
S | 0..1 | BackboneElement | Document or Composition that this Composition is transformed from |
| code |
S | 1..1 | code | replaces | transforms | signs | appends Fixed Value: transforms |
| target[x] |
S | 1..1 | Identifier | Identifier of the Document or Composition transformed |
| relatesTo:replaced |
S | 0..1 | BackboneElement | Document or Composition that this Composition replaces |
| code |
S | 1..1 | code | replaces | transforms | signs | appends Fixed Value: replaces |
| target[x] |
S | 1..1 | Identifier, Reference(Composition) | Identifier/Reference to the Document or Composition transformed |
| Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Composition |
0..* | Composition(4.0.1) | US Public Health Composition | |||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
| contained |
0..* | Resource | Contained, inline Resources | |||||
| Slices for extension |
1..* | Extension | Extension Slice: Unordered, Open by value:url Constraints: ext-1 | |||||
| extension:extensionVersionNumber |
S | 1..1 | string | Public Health Composition versionNumber URL: http://hl7.org/fhir/StructureDefinition/composition-clinicaldocument-versionNumber Constraints: ext-1 | ||||
| extension:extensionInformationRecipient |
S | 0..* | Reference(US Core Practitioner Profile(6.1.0) | US Public Health PractitionerRole(2.0.0) | US Public Health Organization(2.0.0)) | Information Recipient URL: http://hl7.org/fhir/us/ph-library/StructureDefinition/us-ph-information-recipient-extension Constraints: ext-1 | ||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored Constraints: ext-1 | ||||
| identifier |
SΣ | 1..1 | Identifier | Public Health Composition identifier | ||||
| status |
?!SΣ | 1..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required): The workflow/clinical status of the composition. | ||||
| type |
SΣ | 1..1 | CodeableConcept | Type of this public health report Binding: FHIRDocumentTypeCodes (preferred): Type of a composition. | ||||
| category |
Σ | 0..* | CodeableConcept | Categorization of Composition Binding: DocumentClassValueSet (example): High-level kind of a clinical document at a macro level. | ||||
| subject |
SΣ | 1..1 | Reference(US Public Health Patient(2.0.0) | US Core Patient Profile(6.1.0)) | Patient | ||||
| encounter |
SΣ | 1..1 | Reference(US Public Health Encounter(2.0.0)) | Encounter related to the public health event | ||||
| date |
SΣ | 1..1 | dateTime | (USCDI+) Date of the Report | ||||
| author |
SΣ | 1..* | Reference(US Public Health PractitionerRole(2.0.0) | US Core Practitioner Profile(6.1.0) | US Public Health Organization(2.0.0) | Device) | The author(s) of the document | ||||
| title |
SΣ | 1..1 | string | Human Readable name/title | ||||
| confidentiality |
Σ | 0..1 | code | As defined by affinity domain Binding: v3.ConfidentialityClassification (2014-03-26) (required): Codes specifying the level of confidentiality of the composition. | ||||
| attester |
0..* | BackboneElement | Attests to accuracy of composition | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| mode |
1..1 | code | personal | professional | legal | official Binding: CompositionAttestationMode (required): The way in which a person authenticated a composition. | |||||
| time |
0..1 | dateTime | When the composition was attested | |||||
| party |
0..1 | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization) | Who attested the composition | |||||
| custodian |
SΣ | 0..1 | Reference(US Public Health Organization(2.0.0)) | Custodian Organization Address, Custodian Organization Id, Custodian Organization Name, Custodian Organization Telecom (contained in referenced US Public Health Organization) | ||||
| Slices for relatesTo |
S | 0..* | BackboneElement | Relationships to other compositions/documents Slice: Unordered, Open by value:code | ||||
| relatesTo:All Slices |
Content/Rules for all slices | |||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| code |
1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. | |||||
| target[x] |
1..1 | Target of the relationship | ||||||
| targetIdentifier |
Identifier | |||||||
| targetReference |
Reference(Composition) | |||||||
| relatesTo:transformed |
S | 0..1 | BackboneElement | Document or Composition that this Composition is transformed from | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| code |
S | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. Fixed Value: transforms | ||||
| target[x] |
S | 1..1 | Identifier | Identifier of the Document or Composition transformed | ||||
| relatesTo:replaced |
S | 0..1 | BackboneElement | Document or Composition that this Composition replaces | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| code |
S | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. Fixed Value: replaces | ||||
| target[x] |
S | 1..1 | Identifier/Reference to the Document or Composition transformed | |||||
| targetIdentifier |
Identifier | |||||||
| targetReference |
Reference(Composition) | |||||||
| event |
Σ | 0..* | BackboneElement | The clinical service(s) being documented | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| code |
Σ | 0..* | CodeableConcept | Code(s) that apply to the event being documented Binding: ActCode (3.0.0) (example): This list of codes represents the main clinical acts being documented. | ||||
| period |
Σ | 0..1 | Period | The period covered by the documentation | ||||
| detail |
Σ | 0..* | Reference(Resource) | The event(s) being documented | ||||
| section |
C | 0..* | BackboneElement | Composition is broken into sections Constraints: cmp-1, cmp-2 | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| title |
0..1 | string | Label for section (e.g. for ToC) | |||||
| code |
0..1 | CodeableConcept | Classification of section (recommended) Binding: DocumentSectionCodes (example): Classification of a section of a composition/document. | |||||
| author |
0..* | Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization) | Who and/or what authored the section | |||||
| focus |
0..1 | Reference(Resource) | Who/what the section is about, when it is not about the subject of composition | |||||
| text |
C | 0..1 | Narrative | Text summary of the section, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | ||||
| mode |
0..1 | code | working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this section. | |||||
| orderedBy |
0..1 | CodeableConcept | Order of section entries Binding: ListOrderCodes (preferred): What order applies to the items in the entry. | |||||
| entry |
C | 0..* | Reference(Resource) | A reference to data that supports this section | ||||
| emptyReason |
C | 0..1 | CodeableConcept | Why the section is empty Binding: ListEmptyReasons (preferred): If a section is empty, why it is empty. | ||||
| section |
C | 0..* | See section (Composition) | Nested Section | ||||
| Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Composition.status | Base | required | CompositionStatus | 📍4.0.1 | FHIR Std. |
| Composition.type | Base | preferred | FHIR Document Type Codes | 📍4.0.1 | FHIR Std. |
| Composition.category | Base | example | Document Class Value Set | 📍4.0.1 | FHIR Std. |
| Composition.confidentiality | Base | required | V3 Value SetConfidentialityClassification | 📍2014-03-26 | FHIR Std. |
| Composition.attester.mode | Base | required | CompositionAttestationMode | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo:transformed.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo:replaced.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.event.code | Base | example | v3 Code System ActCode | 📍3.0.0 | THO v6.5 |
| Composition.section.code | Base | example | Document Section Codes | 📍4.0.1 | FHIR Std. |
| Composition.section.mode | Base | required | ListMode | 📍4.0.1 | FHIR Std. |
| Composition.section.orderedBy | Base | preferred | List Order Codes | 📍4.0.1 | FHIR Std. |
| Composition.section.emptyReason | Base | preferred | List Empty Reasons | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| cmp-1 | error | Composition.section | A section must contain at least one of text, entries, or sub-sections |
text.exists() or entry.exists() or section.exists()
|
| cmp-2 | error | Composition.section | A section can only have an emptyReason if it is empty |
emptyReason.empty() or entry.empty()
|
| dom-2 | error | Composition | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Composition | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Composition | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Composition | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Composition | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | Composition.meta, Composition.implicitRules, Composition.language, Composition.text, Composition.extension, Composition.extension:extensionVersionNumber, Composition.extension:extensionInformationRecipient, Composition.modifierExtension, Composition.identifier, Composition.status, Composition.type, Composition.category, Composition.subject, Composition.encounter, Composition.date, Composition.author, Composition.title, Composition.confidentiality, Composition.attester, Composition.attester.extension, Composition.attester.modifierExtension, Composition.attester.mode, Composition.attester.time, Composition.attester.party, Composition.custodian, Composition.relatesTo, Composition.relatesTo.extension, Composition.relatesTo.modifierExtension, Composition.relatesTo.code, Composition.relatesTo.target[x], Composition.relatesTo:transformed, Composition.relatesTo:transformed.extension, Composition.relatesTo:transformed.modifierExtension, Composition.relatesTo:transformed.code, Composition.relatesTo:transformed.target[x], Composition.relatesTo:replaced, Composition.relatesTo:replaced.extension, Composition.relatesTo:replaced.modifierExtension, Composition.relatesTo:replaced.code, Composition.relatesTo:replaced.target[x], Composition.event, Composition.event.extension, Composition.event.modifierExtension, Composition.event.code, Composition.event.period, Composition.event.detail, Composition.section, Composition.section.extension, Composition.section.modifierExtension, Composition.section.title, Composition.section.code, Composition.section.author, Composition.section.focus, Composition.section.text, Composition.section.mode, Composition.section.orderedBy, Composition.section.entry, Composition.section.emptyReason, Composition.section.section | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | Composition.extension, Composition.extension:extensionVersionNumber, Composition.extension:extensionInformationRecipient, Composition.modifierExtension, Composition.attester.extension, Composition.attester.modifierExtension, Composition.relatesTo.extension, Composition.relatesTo.modifierExtension, Composition.relatesTo:transformed.extension, Composition.relatesTo:transformed.modifierExtension, Composition.relatesTo:replaced.extension, Composition.relatesTo:replaced.modifierExtension, Composition.event.extension, Composition.event.modifierExtension, Composition.section.extension, Composition.section.modifierExtension | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Summary
Mandatory: 5 elements
Must-Support: 18 elements
Fixed: 2 elements
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Maturity: 3
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Composition |
0..* | Composition(4.0.1) | US Public Health Composition | |
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
| Slices for extension |
1..* | Extension | Extension Slice: Unordered, Open by value:url Constraints: ext-1 | |
| extension:extensionVersionNumber |
S | 1..1 | string | Public Health Composition versionNumber URL: http://hl7.org/fhir/StructureDefinition/composition-clinicaldocument-versionNumber Constraints: ext-1 |
| extension:extensionInformationRecipient |
S | 0..* | Reference(US Core Practitioner Profile(6.1.0) | US Public Health PractitionerRole(2.0.0) | US Public Health Organization(2.0.0)) | Information Recipient URL: http://hl7.org/fhir/us/ph-library/StructureDefinition/us-ph-information-recipient-extension Constraints: ext-1 |
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored Constraints: ext-1 |
| identifier |
SΣ | 1..1 | Identifier | Public Health Composition identifier |
| status |
?!SΣ | 1..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required): The workflow/clinical status of the composition. |
| type |
SΣ | 1..1 | CodeableConcept | Type of this public health report Binding: FHIRDocumentTypeCodes (preferred): Type of a composition. |
| subject |
SΣ | 1..1 | Reference(US Public Health Patient(2.0.0) | US Core Patient Profile(6.1.0)) | Patient |
| encounter |
SΣ | 1..1 | Reference(US Public Health Encounter(2.0.0)) | Encounter related to the public health event |
| date |
SΣ | 1..1 | dateTime | (USCDI+) Date of the Report |
| author |
SΣ | 1..* | Reference(US Public Health PractitionerRole(2.0.0) | US Core Practitioner Profile(6.1.0) | US Public Health Organization(2.0.0) | Device) | The author(s) of the document |
| title |
SΣ | 1..1 | string | Human Readable name/title |
| custodian |
SΣ | 0..1 | Reference(US Public Health Organization(2.0.0)) | Custodian Organization Address, Custodian Organization Id, Custodian Organization Name, Custodian Organization Telecom (contained in referenced US Public Health Organization) |
| Slices for relatesTo |
S | 0..* | BackboneElement | Relationships to other compositions/documents Slice: Unordered, Open by value:code |
| relatesTo:All Slices |
Content/Rules for all slices | |||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 |
| code |
1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. | |
| target[x] |
1..1 | Target of the relationship | ||
| targetIdentifier |
Identifier | |||
| targetReference |
Reference(Composition) | |||
| relatesTo:transformed |
S | 0..1 | BackboneElement | Document or Composition that this Composition is transformed from |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 |
| code |
S | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. Fixed Value: transforms |
| target[x] |
S | 1..1 | Identifier | Identifier of the Document or Composition transformed |
| relatesTo:replaced |
S | 0..1 | BackboneElement | Document or Composition that this Composition replaces |
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 |
| code |
S | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. Fixed Value: replaces |
| target[x] |
S | 1..1 | Identifier/Reference to the Document or Composition transformed | |
| targetIdentifier |
Identifier | |||
| targetReference |
Reference(Composition) | |||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.status | Base | required | CompositionStatus | 📍4.0.1 | FHIR Std. |
| Composition.type | Base | preferred | FHIR Document Type Codes | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo:transformed.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo:replaced.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Composition | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Composition | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Composition | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Composition | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Composition | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | Composition.implicitRules, Composition.extension, Composition.extension:extensionVersionNumber, Composition.extension:extensionInformationRecipient, Composition.modifierExtension, Composition.identifier, Composition.status, Composition.type, Composition.subject, Composition.encounter, Composition.date, Composition.author, Composition.title, Composition.custodian, Composition.relatesTo, Composition.relatesTo.modifierExtension, Composition.relatesTo.code, Composition.relatesTo.target[x], Composition.relatesTo:transformed, Composition.relatesTo:transformed.modifierExtension, Composition.relatesTo:transformed.code, Composition.relatesTo:transformed.target[x], Composition.relatesTo:replaced, Composition.relatesTo:replaced.modifierExtension, Composition.relatesTo:replaced.code, Composition.relatesTo:replaced.target[x] | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | Composition.extension, Composition.extension:extensionVersionNumber, Composition.extension:extensionInformationRecipient, Composition.modifierExtension, Composition.relatesTo.modifierExtension, Composition.relatesTo:transformed.modifierExtension, Composition.relatesTo:replaced.modifierExtension | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Differential View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Composition |
0..* | Composition(4.0.1) | US Public Health Composition | |
| Slices for extension |
1..* | Extension | Extension Slice: Unordered, Open by value:url | |
| extension:extensionVersionNumber |
S | 1..1 | string | Public Health Composition versionNumber URL: http://hl7.org/fhir/StructureDefinition/composition-clinicaldocument-versionNumber |
| extension:extensionInformationRecipient |
S | 0..* | Reference(US Core Practitioner Profile(6.1.0) | US Public Health PractitionerRole(2.0.0) | US Public Health Organization(2.0.0)) | Information Recipient URL: http://hl7.org/fhir/us/ph-library/StructureDefinition/us-ph-information-recipient-extension |
| identifier |
S | 1..1 | Identifier | Public Health Composition identifier |
| status |
S | 1..1 | code | preliminary | final | amended | entered-in-error |
| type |
S | 1..1 | CodeableConcept | Type of this public health report |
| subject |
S | 1..1 | Reference(US Public Health Patient(2.0.0) | US Core Patient Profile(6.1.0)) | Patient |
| encounter |
S | 1..1 | Reference(US Public Health Encounter(2.0.0)) | Encounter related to the public health event |
| date |
S | 1..1 | dateTime | (USCDI+) Date of the Report |
| author |
S | 1..* | Reference(US Public Health PractitionerRole(2.0.0) | US Core Practitioner Profile(6.1.0) | US Public Health Organization(2.0.0) | Device) | The author(s) of the document |
| title |
S | 1..1 | string | Human Readable name/title |
| custodian |
S | 0..1 | Reference(US Public Health Organization(2.0.0)) | Custodian Organization Address, Custodian Organization Id, Custodian Organization Name, Custodian Organization Telecom (contained in referenced US Public Health Organization) |
| Slices for relatesTo |
S | 0..* | BackboneElement | Relationships to other compositions/documents Slice: Unordered, Open by value:code |
| relatesTo:transformed |
S | 0..1 | BackboneElement | Document or Composition that this Composition is transformed from |
| code |
S | 1..1 | code | replaces | transforms | signs | appends Fixed Value: transforms |
| target[x] |
S | 1..1 | Identifier | Identifier of the Document or Composition transformed |
| relatesTo:replaced |
S | 0..1 | BackboneElement | Document or Composition that this Composition replaces |
| code |
S | 1..1 | code | replaces | transforms | signs | appends Fixed Value: replaces |
| target[x] |
S | 1..1 | Identifier, Reference(Composition) | Identifier/Reference to the Document or Composition transformed |
| Documentation for this format | ||||
Snapshot ViewView
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Composition |
0..* | Composition(4.0.1) | US Public Health Composition | |||||
| id |
Σ | 0..1 | id | Logical id of this artifact | ||||
| meta |
Σ | 0..1 | Meta | Metadata about the resource | ||||
| implicitRules |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
| text |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
| contained |
0..* | Resource | Contained, inline Resources | |||||
| Slices for extension |
1..* | Extension | Extension Slice: Unordered, Open by value:url Constraints: ext-1 | |||||
| extension:extensionVersionNumber |
S | 1..1 | string | Public Health Composition versionNumber URL: http://hl7.org/fhir/StructureDefinition/composition-clinicaldocument-versionNumber Constraints: ext-1 | ||||
| extension:extensionInformationRecipient |
S | 0..* | Reference(US Core Practitioner Profile(6.1.0) | US Public Health PractitionerRole(2.0.0) | US Public Health Organization(2.0.0)) | Information Recipient URL: http://hl7.org/fhir/us/ph-library/StructureDefinition/us-ph-information-recipient-extension Constraints: ext-1 | ||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored Constraints: ext-1 | ||||
| identifier |
SΣ | 1..1 | Identifier | Public Health Composition identifier | ||||
| status |
?!SΣ | 1..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required): The workflow/clinical status of the composition. | ||||
| type |
SΣ | 1..1 | CodeableConcept | Type of this public health report Binding: FHIRDocumentTypeCodes (preferred): Type of a composition. | ||||
| category |
Σ | 0..* | CodeableConcept | Categorization of Composition Binding: DocumentClassValueSet (example): High-level kind of a clinical document at a macro level. | ||||
| subject |
SΣ | 1..1 | Reference(US Public Health Patient(2.0.0) | US Core Patient Profile(6.1.0)) | Patient | ||||
| encounter |
SΣ | 1..1 | Reference(US Public Health Encounter(2.0.0)) | Encounter related to the public health event | ||||
| date |
SΣ | 1..1 | dateTime | (USCDI+) Date of the Report | ||||
| author |
SΣ | 1..* | Reference(US Public Health PractitionerRole(2.0.0) | US Core Practitioner Profile(6.1.0) | US Public Health Organization(2.0.0) | Device) | The author(s) of the document | ||||
| title |
SΣ | 1..1 | string | Human Readable name/title | ||||
| confidentiality |
Σ | 0..1 | code | As defined by affinity domain Binding: v3.ConfidentialityClassification (2014-03-26) (required): Codes specifying the level of confidentiality of the composition. | ||||
| attester |
0..* | BackboneElement | Attests to accuracy of composition | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| mode |
1..1 | code | personal | professional | legal | official Binding: CompositionAttestationMode (required): The way in which a person authenticated a composition. | |||||
| time |
0..1 | dateTime | When the composition was attested | |||||
| party |
0..1 | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization) | Who attested the composition | |||||
| custodian |
SΣ | 0..1 | Reference(US Public Health Organization(2.0.0)) | Custodian Organization Address, Custodian Organization Id, Custodian Organization Name, Custodian Organization Telecom (contained in referenced US Public Health Organization) | ||||
| Slices for relatesTo |
S | 0..* | BackboneElement | Relationships to other compositions/documents Slice: Unordered, Open by value:code | ||||
| relatesTo:All Slices |
Content/Rules for all slices | |||||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| code |
1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. | |||||
| target[x] |
1..1 | Target of the relationship | ||||||
| targetIdentifier |
Identifier | |||||||
| targetReference |
Reference(Composition) | |||||||
| relatesTo:transformed |
S | 0..1 | BackboneElement | Document or Composition that this Composition is transformed from | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| code |
S | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. Fixed Value: transforms | ||||
| target[x] |
S | 1..1 | Identifier | Identifier of the Document or Composition transformed | ||||
| relatesTo:replaced |
S | 0..1 | BackboneElement | Document or Composition that this Composition replaces | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| code |
S | 1..1 | code | replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): The type of relationship between documents. Fixed Value: replaces | ||||
| target[x] |
S | 1..1 | Identifier/Reference to the Document or Composition transformed | |||||
| targetIdentifier |
Identifier | |||||||
| targetReference |
Reference(Composition) | |||||||
| event |
Σ | 0..* | BackboneElement | The clinical service(s) being documented | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| code |
Σ | 0..* | CodeableConcept | Code(s) that apply to the event being documented Binding: ActCode (3.0.0) (example): This list of codes represents the main clinical acts being documented. | ||||
| period |
Σ | 0..1 | Period | The period covered by the documentation | ||||
| detail |
Σ | 0..* | Reference(Resource) | The event(s) being documented | ||||
| section |
C | 0..* | BackboneElement | Composition is broken into sections Constraints: cmp-1, cmp-2 | ||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | ||||
| title |
0..1 | string | Label for section (e.g. for ToC) | |||||
| code |
0..1 | CodeableConcept | Classification of section (recommended) Binding: DocumentSectionCodes (example): Classification of a section of a composition/document. | |||||
| author |
0..* | Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization) | Who and/or what authored the section | |||||
| focus |
0..1 | Reference(Resource) | Who/what the section is about, when it is not about the subject of composition | |||||
| text |
C | 0..1 | Narrative | Text summary of the section, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | ||||
| mode |
0..1 | code | working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this section. | |||||
| orderedBy |
0..1 | CodeableConcept | Order of section entries Binding: ListOrderCodes (preferred): What order applies to the items in the entry. | |||||
| entry |
C | 0..* | Reference(Resource) | A reference to data that supports this section | ||||
| emptyReason |
C | 0..1 | CodeableConcept | Why the section is empty Binding: ListEmptyReasons (preferred): If a section is empty, why it is empty. | ||||
| section |
C | 0..* | See section (Composition) | Nested Section | ||||
| Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| Composition.status | Base | required | CompositionStatus | 📍4.0.1 | FHIR Std. |
| Composition.type | Base | preferred | FHIR Document Type Codes | 📍4.0.1 | FHIR Std. |
| Composition.category | Base | example | Document Class Value Set | 📍4.0.1 | FHIR Std. |
| Composition.confidentiality | Base | required | V3 Value SetConfidentialityClassification | 📍2014-03-26 | FHIR Std. |
| Composition.attester.mode | Base | required | CompositionAttestationMode | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo:transformed.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.relatesTo:replaced.code | Base | required | DocumentRelationshipType | 📍4.0.1 | FHIR Std. |
| Composition.event.code | Base | example | v3 Code System ActCode | 📍3.0.0 | THO v6.5 |
| Composition.section.code | Base | example | Document Section Codes | 📍4.0.1 | FHIR Std. |
| Composition.section.mode | Base | required | ListMode | 📍4.0.1 | FHIR Std. |
| Composition.section.orderedBy | Base | preferred | List Order Codes | 📍4.0.1 | FHIR Std. |
| Composition.section.emptyReason | Base | preferred | List Empty Reasons | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| cmp-1 | error | Composition.section | A section must contain at least one of text, entries, or sub-sections |
text.exists() or entry.exists() or section.exists()
|
| cmp-2 | error | Composition.section | A section can only have an emptyReason if it is empty |
emptyReason.empty() or entry.empty()
|
| dom-2 | error | Composition | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Composition | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Composition | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | Composition | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Composition | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | Composition.meta, Composition.implicitRules, Composition.language, Composition.text, Composition.extension, Composition.extension:extensionVersionNumber, Composition.extension:extensionInformationRecipient, Composition.modifierExtension, Composition.identifier, Composition.status, Composition.type, Composition.category, Composition.subject, Composition.encounter, Composition.date, Composition.author, Composition.title, Composition.confidentiality, Composition.attester, Composition.attester.extension, Composition.attester.modifierExtension, Composition.attester.mode, Composition.attester.time, Composition.attester.party, Composition.custodian, Composition.relatesTo, Composition.relatesTo.extension, Composition.relatesTo.modifierExtension, Composition.relatesTo.code, Composition.relatesTo.target[x], Composition.relatesTo:transformed, Composition.relatesTo:transformed.extension, Composition.relatesTo:transformed.modifierExtension, Composition.relatesTo:transformed.code, Composition.relatesTo:transformed.target[x], Composition.relatesTo:replaced, Composition.relatesTo:replaced.extension, Composition.relatesTo:replaced.modifierExtension, Composition.relatesTo:replaced.code, Composition.relatesTo:replaced.target[x], Composition.event, Composition.event.extension, Composition.event.modifierExtension, Composition.event.code, Composition.event.period, Composition.event.detail, Composition.section, Composition.section.extension, Composition.section.modifierExtension, Composition.section.title, Composition.section.code, Composition.section.author, Composition.section.focus, Composition.section.text, Composition.section.mode, Composition.section.orderedBy, Composition.section.entry, Composition.section.emptyReason, Composition.section.section | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | Composition.extension, Composition.extension:extensionVersionNumber, Composition.extension:extensionInformationRecipient, Composition.modifierExtension, Composition.attester.extension, Composition.attester.modifierExtension, Composition.relatesTo.extension, Composition.relatesTo.modifierExtension, Composition.relatesTo:transformed.extension, Composition.relatesTo:transformed.modifierExtension, Composition.relatesTo:replaced.extension, Composition.relatesTo:replaced.modifierExtension, Composition.event.extension, Composition.event.modifierExtension, Composition.section.extension, Composition.section.modifierExtension | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Summary
Mandatory: 5 elements
Must-Support: 18 elements
Fixed: 2 elements
Structures
This structure refers to these other structures:
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
Maturity: 3
Other representations of profile: CSV, Excel, Schematron
IG © 2025+ HL7 International / Public Health.
Package hl7.fhir.us.ph-library#2.0.0 based on FHIR 4.0.1.
Generated 2025-10-23
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change
