{
"description": "Content of one version in a `VERSIONED_COMPOSITION`. A Composition is considered the unit of modification of the record, the unit of transmission in record Extracts, and the unit of attestation by authorising clinicians. In this latter sense, it may be considered equivalent to a signed document.\\n\\nNOTE: It is strongly recommended that the inherited attribute `_uid_` be populated in Compositions, using the UID copied from the `_object_id()_` of the `_uid_` field of the enclosing `VERSION` object. +\\nFor example, the `ORIGINAL_VERSION.uid` `87284370-2D4B-4e3d-A3F3-F303D2F4F34B::uk.nhs.ehr1::2` would be copied to the `_uid_` field of the Composition.",
"_filename": "StructureDefinition-COMPOSITION.json",
"package_name": "openehr.base",
"date": "2025-09-06T15:35:39+10:00",
"derivation": "specialization",
"publisher": "openEHR + HL7",
"fhirVersion": "5.0.0",
"jurisdiction": [ {
"coding": [ {
"code": "001",
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm"
} ]
} ],
"name": "COMPOSITION",
"mapping": [ {
"uri": "http://hl7.org/v3",
"name": "RIM Mapping",
"identity": "rim"
} ],
"abstract": false,
"type": "http://openehr.org/fhir/StructureDefinition/COMPOSITION",
"experimental": "false",
"resourceType": "StructureDefinition",
"title": "COMPOSITION",
"package_version": "0.1.0-snapshot",
"extension": [ {
"url": "http://hl7.org/fhir/tools/StructureDefinition/web-source",
"valueUrl": "https://specifications.openehr.org/releases/RM/development/ehr.html#_composition_class"
}, {
"url": "http://hl7.org/fhir/tools/StructureDefinition/type-operation",
"valueCanonical": "#is_persistent"
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode": "fhir"
}, {
"url": "http://hl7.org/fhir/tools/StructureDefinition/view-hint",
"valueCode": "element-view-replace-cardinality"
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
"valueInteger": 3,
"_valueInteger": {
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
"valueCanonical": "http://openehr.org/fhir/ImplementationGuide/openehr.base"
} ]
}
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "informative",
"_valueCode": {
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
"valueCanonical": "http://openehr.org/fhir/ImplementationGuide/openehr.base"
} ]
}
} ],
"contained": [ {
"description": "True if category is `431|persistent|`, False otherwise. Useful for finding Compositions in an EHR which are guaranteed to be of interest to most users. ",
"system": false,
"instance": true,
"name": "is_persistent",
"resourceType": "OperationDefinition",
"title": "is_persistent",
"status": "active",
"id": "is_persistent",
"kind": "operation",
"code": "is_persistent",
"parameter": [ {
"max": "1",
"min": 1,
"use": "out",
"name": "return",
"type": "boolean"
} ]
} ],
"snapshot": {
"element": [ {
"constraint": [ {
"key": "Links_valid",
"human": "Links valid must be present",
"source": "http://openehr.org/fhir/StructureDefinition/LOCATABLE",
"severity": "error",
"expression": "links.exists() implies links.empty().not()"
}, {
"key": "Archetyped_valid",
"human": "Archetyped valid must satisfy exclusive conditions",
"source": "http://openehr.org/fhir/StructureDefinition/LOCATABLE",
"severity": "error",
"expression": "is_archetype_root() xor archetype_details .empty()"
}, {
"key": "Archetype_node_id_valid",
"human": "Archetype node id valid must not be empty",
"source": "http://openehr.org/fhir/StructureDefinition/LOCATABLE",
"severity": "error",
"expression": "archetype_node_id.empty().not()"
}, {
"key": "Setting_valid",
"human": "Setting valid",
"severity": "error",
"expression": "null # TODO: manual translation needed"
}, {
"key": "unnamed2",
"human": "unnamed2",
"severity": "error",
"expression": "null # TODO: manual translation needed"
}, {
"key": "unnamed3",
"human": "unnamed3",
"severity": "error",
"expression": "null # TODO: manual translation needed"
}, {
"key": "Category_validity",
"human": "Category validity",
"severity": "error",
"expression": "null # TODO: manual translation needed"
}, {
"key": "Is_persistent_validity",
"human": "Is persistent validity must satisfy conditional constraints",
"severity": "error",
"expression": "is_persistent() implies context .empty()"
}, {
"key": "Content_valid",
"human": "Content valid must be present",
"severity": "error",
"expression": "content.exists() implies content.empty().not()"
}, {
"key": "Is_archetype_root",
"human": "Is archetype root",
"severity": "error",
"expression": "is_archetype_root()"
} ],
"path": "COMPOSITION",
"min": 0,
"definition": "Content of one version in a `VERSIONED_COMPOSITION`. A Composition is considered the unit of modification of the record, the unit of transmission in record Extracts, and the unit of attestation by authorising clinicians. In this latter sense, it may be considered equivalent to a signed document.\n\nNOTE: It is strongly recommended that the inherited attribute `_uid_` be populated in Compositions, using the UID copied from the `_object_id()_` of the `_uid_` field of the enclosing `VERSION` object. +\nFor example, the `ORIGINAL_VERSION.uid` `87284370-2D4B-4e3d-A3F3-F303D2F4F34B::uk.nhs.ehr1::2` would be copied to the `_uid_` field of the Composition.",
"isModifier": false,
"short": "Content of one version in a `VERSIONED_COMPOSITION`.",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"max": "*",
"id": "COMPOSITION",
"base": {
"max": "*",
"min": 0,
"path": "Base"
}
}, {
"path": "COMPOSITION.name",
"min": 1,
"definition": "Runtime name of this fragment, used to build runtime paths. This is the term provided via a clinical application or batch process to name this EHR construct: its retention in the EHR faithfully preserves the original label by which this entry was known to end users.",
"isModifier": false,
"short": "Runtime name of this fragment, used to build runtime paths.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/DV-TEXT"
} ],
"max": "1",
"id": "COMPOSITION.name",
"base": {
"max": "1",
"min": 1,
"path": "LOCATABLE.name"
}
}, {
"path": "COMPOSITION.archetype_node_id",
"min": 1,
"definition": "Design-time archetype identifier of this node taken from its generating archetype; used to build archetype paths. Always in the form of an at-code, e.g. `at0005`. This value enables a 'standardised' name for this node to be generated, by referring to the generating archetype local terminology. \n\nAt an archetype root point, the value of this attribute is always the stringified form of the `_archetype_id_` found in the `_archetype_details_` object.",
"isModifier": false,
"short": "Design-time archetype identifier of this node taken from its generating archetype; used to build archetype paths.",
"type": [ {
"code": "string"
} ],
"max": "1",
"id": "COMPOSITION.archetype-node-id",
"base": {
"max": "1",
"min": 1,
"path": "LOCATABLE.archetype_node_id"
}
}, {
"path": "COMPOSITION.uid",
"min": 0,
"definition": "Optional globally unique object identifier for root points of archetyped structures.",
"isModifier": false,
"short": "Optional globally unique object identifier for root points of archetyped structures.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/UID-BASED-ID"
} ],
"max": "1",
"id": "COMPOSITION.uid",
"base": {
"max": "1",
"min": 0,
"path": "LOCATABLE.uid"
}
}, {
"path": "COMPOSITION.links",
"min": 0,
"definition": "Links to other archetyped structures (data whose root object inherits from `ARCHETYPED`, such as `ENTRY`, `SECTION` and so on). Links may be to structures in other compositions.",
"isModifier": false,
"short": "Links to other archetyped structures (data whose root object inherits from `ARCHETYPED`, such as `ENTRY`, `SECTION` and so on).",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/LINK"
} ],
"max": "*",
"id": "COMPOSITION.links",
"base": {
"max": "*",
"min": 0,
"path": "LOCATABLE.links"
}
}, {
"path": "COMPOSITION.archetype_details",
"min": 0,
"definition": "Details of archetyping used on this node.",
"isModifier": false,
"short": "Details of archetyping used on this node.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/ARCHETYPED"
} ],
"max": "1",
"id": "COMPOSITION.archetype-details",
"base": {
"max": "1",
"min": 0,
"path": "LOCATABLE.archetype_details"
}
}, {
"path": "COMPOSITION.feeder_audit",
"min": 0,
"definition": "Audit trail from non-openEHR system of original commit of information forming the content of this node, or from a conversion gateway which has synthesised this node.",
"isModifier": false,
"short": "Audit trail from non-openEHR system of original commit of information forming the content of this node, or from a conversion gateway which has synthesised this node.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/FEEDER-AUDIT"
} ],
"max": "1",
"id": "COMPOSITION.feeder-audit",
"base": {
"max": "1",
"min": 0,
"path": "LOCATABLE.feeder_audit"
}
}, {
"path": "COMPOSITION.language",
"min": 1,
"definition": "Mandatory indicator of the localised language in which this Composition is written. Coded from openEHR Code Set `languages`. The language of an Entry if different from the Composition is indicated in `ENTRY._language_`.",
"isModifier": false,
"short": "Mandatory indicator of the localised language in which this Composition is written.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/CODE-PHRASE"
} ],
"max": "1",
"id": "COMPOSITION.language",
"base": {
"max": "1",
"min": 1,
"path": "COMPOSITION.language"
}
}, {
"path": "COMPOSITION.territory",
"min": 1,
"definition": "Name of territory in which this Composition was written. Coded from openEHR countries code set, which is an expression of the ISO 3166 standard.",
"isModifier": false,
"short": "Name of territory in which this Composition was written.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/CODE-PHRASE"
} ],
"max": "1",
"id": "COMPOSITION.territory",
"base": {
"max": "1",
"min": 1,
"path": "COMPOSITION.territory"
}
}, {
"path": "COMPOSITION.category",
"min": 1,
"definition": "Temporal category of this Composition, i.e. \n\n* `431|persistent|` - of potential life-time validity;\n* `451|episodic|` - valid over the life of a care episode;\n* `433|event|` - valid at the time of recording (long-term validity requires subsequent clinical assessment).\n\nor any other code defined in the openEHR terminology group 'category'.",
"isModifier": false,
"short": "Temporal category of this Composition, i.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/DV-CODED-TEXT"
} ],
"max": "1",
"id": "COMPOSITION.category",
"base": {
"max": "1",
"min": 1,
"path": "COMPOSITION.category"
}
}, {
"path": "COMPOSITION.context",
"min": 0,
"definition": "The clinical session context of this Composition, i.e. the contextual attributes of the clinical session.",
"isModifier": false,
"short": "The clinical session context of this Composition, i.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/EVENT-CONTEXT"
} ],
"max": "1",
"id": "COMPOSITION.context",
"base": {
"max": "1",
"min": 0,
"path": "COMPOSITION.context"
}
}, {
"path": "COMPOSITION.composer",
"min": 1,
"definition": "The person primarily responsible for the content of the Composition (but not necessarily its committal into the EHR system). This is the identifier which should appear on the screen. It may or may not be the person who entered the data. When it is the patient, the special self instance of `PARTY_PROXY` will be used.",
"isModifier": false,
"short": "The person primarily responsible for the content of the Composition (but not necessarily its committal into the EHR system).",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/PARTY-PROXY"
} ],
"max": "1",
"id": "COMPOSITION.composer",
"base": {
"max": "1",
"min": 1,
"path": "COMPOSITION.composer"
}
}, {
"path": "COMPOSITION.content",
"min": 0,
"definition": "The content of this Composition.",
"isModifier": false,
"short": "The content of this Composition.",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/CONTENT-ITEM"
} ],
"max": "*",
"id": "COMPOSITION.content",
"base": {
"max": "*",
"min": 0,
"path": "COMPOSITION.content"
}
} ],
"extension": [ {
"url": "http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version",
"valueString": "0.1.0-snapshot"
} ]
},
"status": "active",
"id": "e979eb39-41c2-4a96-a901-96f046c79d17",
"kind": "logical",
"url": "http://openehr.org/fhir/StructureDefinition/COMPOSITION",
"version": "0.1.0-snapshot",
"differential": {
"element": [ {
"constraint": [ {
"key": "Setting_valid",
"human": "Setting valid",
"severity": "error",
"expression": "null # TODO: manual translation needed"
}, {
"key": "unnamed2",
"human": "unnamed2",
"severity": "error",
"expression": "null # TODO: manual translation needed"
}, {
"key": "unnamed3",
"human": "unnamed3",
"severity": "error",
"expression": "null # TODO: manual translation needed"
}, {
"key": "Category_validity",
"human": "Category validity",
"severity": "error",
"expression": "null # TODO: manual translation needed"
}, {
"key": "Is_persistent_validity",
"human": "Is persistent validity must satisfy conditional constraints",
"severity": "error",
"expression": "is_persistent() implies context .empty()"
}, {
"key": "Content_valid",
"human": "Content valid must be present",
"severity": "error",
"expression": "content.exists() implies content.empty().not()"
}, {
"key": "Is_archetype_root",
"human": "Is archetype root",
"severity": "error",
"expression": "is_archetype_root()"
} ],
"path": "COMPOSITION",
"min": 0,
"definition": "Content of one version in a `VERSIONED_COMPOSITION`. A Composition is considered the unit of modification of the record, the unit of transmission in record Extracts, and the unit of attestation by authorising clinicians. In this latter sense, it may be considered equivalent to a signed document.\n\nNOTE: It is strongly recommended that the inherited attribute `_uid_` be populated in Compositions, using the UID copied from the `_object_id()_` of the `_uid_` field of the enclosing `VERSION` object. +\nFor example, the `ORIGINAL_VERSION.uid` `87284370-2D4B-4e3d-A3F3-F303D2F4F34B::uk.nhs.ehr1::2` would be copied to the `_uid_` field of the Composition.",
"isModifier": false,
"short": "Content of one version in a `VERSIONED_COMPOSITION`.",
"binding": {
"strength": "required",
"valueSet": "https://specifications.openehr.org/fhir/valueset-languages"
},
"max": "*",
"id": "COMPOSITION"
}, {
"id": "COMPOSITION.language",
"max": "1",
"min": 1,
"path": "COMPOSITION.language",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/CODE-PHRASE"
} ],
"short": "Mandatory indicator of the localised language in which this Composition is written.",
"definition": "Mandatory indicator of the localised language in which this Composition is written. Coded from openEHR Code Set `languages`. The language of an Entry if different from the Composition is indicated in `ENTRY._language_`. ",
"isModifier": false
}, {
"id": "COMPOSITION.territory",
"max": "1",
"min": 1,
"path": "COMPOSITION.territory",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/CODE-PHRASE"
} ],
"short": "Name of territory in which this Composition was written.",
"definition": "Name of territory in which this Composition was written. Coded from openEHR countries code set, which is an expression of the ISO 3166 standard.",
"isModifier": false
}, {
"id": "COMPOSITION.category",
"max": "1",
"min": 1,
"path": "COMPOSITION.category",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/DV-CODED-TEXT"
} ],
"short": "Temporal category of this Composition, i.",
"definition": "Temporal category of this Composition, i.e. \n\n* `431|persistent|` - of potential life-time validity;\n* `451|episodic|` - valid over the life of a care episode;\n* `433|event|` - valid at the time of recording (long-term validity requires subsequent clinical assessment).\n\nor any other code defined in the openEHR terminology group 'category'.\n",
"isModifier": false
}, {
"id": "COMPOSITION.context",
"max": "1",
"min": 0,
"path": "COMPOSITION.context",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/EVENT-CONTEXT"
} ],
"short": "The clinical session context of this Composition, i.",
"definition": "The clinical session context of this Composition, i.e. the contextual attributes of the clinical session. ",
"isModifier": false
}, {
"id": "COMPOSITION.composer",
"max": "1",
"min": 1,
"path": "COMPOSITION.composer",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/PARTY-PROXY"
} ],
"short": "The person primarily responsible for the content of the Composition (but not necessarily its committal into the EHR system).",
"definition": "The person primarily responsible for the content of the Composition (but not necessarily its committal into the EHR system). This is the identifier which should appear on the screen. It may or may not be the person who entered the data. When it is the patient, the special self instance of `PARTY_PROXY` will be used.",
"isModifier": false
}, {
"id": "COMPOSITION.content",
"max": "*",
"min": 0,
"path": "COMPOSITION.content",
"type": [ {
"code": "http://openehr.org/fhir/StructureDefinition/CONTENT-ITEM"
} ],
"short": "The content of this Composition.",
"definition": "The content of this Composition. ",
"isModifier": false
} ]
},
"contact": [ {
"telecom": [ {
"value": "http://www.openehr.org",
"system": "url"
} ]
} ],
"baseDefinition": "http://openehr.org/fhir/StructureDefinition/LOCATABLE"
}