{
"description": "Annotation Type: A text note which also contains information about who made the statement and when.",
"_filename": "StructureDefinition-Annotation.json",
"package_name": "hl7.fhir.r6.core",
"date": "2025-04-01T12:16:37+11:00",
"derivation": "specialization",
"meta": {
"lastUpdated": "2025-04-01T12:16:37.966+11:00"
},
"publisher": "HL7 International / FHIR Infrastructure",
"fhirVersion": "6.0.0-ballot3",
"jurisdiction": [ {
"coding": [ {
"code": "001",
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
"display": "World"
} ]
} ],
"name": "Annotation",
"mapping": [ {
"uri": "http://hl7.org/v2",
"name": "HL7 V2 Mapping",
"identity": "v2"
}, {
"uri": "http://hl7.org/v3",
"name": "RIM Mapping",
"identity": "rim"
} ],
"abstract": false,
"type": "Annotation",
"experimental": "false",
"resourceType": "StructureDefinition",
"title": null,
"package_version": "6.0.0-ballot3",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "normative"
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version",
"valueCode": "4.0.0"
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
"valueCode": "has-size"
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode": "fhir"
} ],
"snapshot": {
"element": [ {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
} ],
"path": "Annotation",
"min": 0,
"definition": "A text note which also contains information about who made the statement and when.",
"isModifier": false,
"short": "Text node with attribution",
"mapping": [ {
"map": "n/a,Act",
"identity": "rim"
}, {
"map": "N/A",
"identity": "v2"
} ],
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "normative"
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version",
"valueCode": "4.0.0"
} ],
"max": "*",
"id": "Annotation",
"comment": "For systems that do not have structured annotations, they can simply communicate a single annotation with no author or time. This element may need to be included in narrative because of the potential for modifying information. *Annotations SHOULD NOT* be used to communicate \"modifying\" information that could be computable. (This is a SHOULD because enforcing user behavior is nearly impossible).",
"base": {
"max": "*",
"min": 0,
"path": "Annotation"
}
}, {
"path": "Annotation.id",
"min": 0,
"definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
"isModifier": false,
"short": "Unique id for inter-element referencing",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"type": [ {
"code": "http://hl7.org/fhirpath/System.String",
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
"valueUrl": "id"
} ]
} ],
"representation": [ "xmlAttr" ],
"max": "1",
"id": "Annotation.id",
"condition": [ "ele-1" ],
"base": {
"max": "1",
"min": 0,
"path": "Element.id"
},
"isSummary": false
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
} ],
"path": "Annotation.extension",
"min": 0,
"definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
"isModifier": false,
"short": "Additional content defined by implementations",
"mapping": [ {
"map": "n/a",
"identity": "rim"
} ],
"slicing": {
"rules": "open",
"description": "Extensions are always sliced by (at least) url",
"discriminator": [ {
"path": "url",
"type": "value"
} ]
},
"type": [ {
"code": "Extension"
} ],
"alias": [ "extensions", "user content" ],
"max": "*",
"id": "Annotation.extension",
"comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
"base": {
"max": "*",
"min": 0,
"path": "Element.extension"
},
"isSummary": false
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
} ],
"path": "Annotation.author[x]",
"min": 0,
"definition": "The individual responsible for making the annotation.",
"isModifier": false,
"short": "Individual responsible for the annotation",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": "Act.participant[typeCode=AUT].role",
"identity": "rim"
} ],
"type": [ {
"code": "Reference",
"targetProfile": [ "http://hl7.org/fhir/StructureDefinition/Practitioner", "http://hl7.org/fhir/StructureDefinition/PractitionerRole", "http://hl7.org/fhir/StructureDefinition/Patient", "http://hl7.org/fhir/StructureDefinition/RelatedPerson", "http://hl7.org/fhir/StructureDefinition/Organization" ]
}, {
"code": "string"
} ],
"max": "1",
"id": "Annotation.author[x]",
"comment": "Organization is used when there's no need for specific attribution as to who made the comment.",
"base": {
"max": "1",
"min": 0,
"path": "Annotation.author[x]"
},
"isSummary": true
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
} ],
"path": "Annotation.time",
"min": 0,
"definition": "Indicates when this particular annotation was made.",
"isModifier": false,
"short": "When the annotation was made",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": "Act.effectiveTime",
"identity": "rim"
} ],
"type": [ {
"code": "dateTime"
} ],
"max": "1",
"id": "Annotation.time",
"base": {
"max": "1",
"min": 0,
"path": "Annotation.time"
},
"isSummary": true
}, {
"constraint": [ {
"key": "ele-1",
"human": "All FHIR elements must have a @value or children",
"source": "http://hl7.org/fhir/StructureDefinition/Element",
"severity": "error",
"expression": "hasValue() or (children().count() > id.count())"
} ],
"path": "Annotation.text",
"min": 1,
"definition": "The text of the annotation in markdown format.",
"isModifier": false,
"short": "The annotation - text content (as markdown)",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": "Act.text",
"identity": "rim"
} ],
"type": [ {
"code": "markdown"
} ],
"max": "1",
"id": "Annotation.text",
"base": {
"max": "1",
"min": 1,
"path": "Annotation.text"
},
"isSummary": true
} ]
},
"status": "active",
"id": "c09f4130-b4bb-432d-80f8-4b9b3b735fab",
"kind": "complex-type",
"url": "http://hl7.org/fhir/StructureDefinition/Annotation",
"version": "6.0.0-ballot3",
"differential": {
"element": [ {
"path": "Annotation",
"min": 0,
"definition": "A text note which also contains information about who made the statement and when.",
"short": "Text node with attribution",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": "Act",
"identity": "rim"
} ],
"extension": [ {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "normative"
}, {
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version",
"valueCode": "4.0.0"
} ],
"max": "*",
"id": "Annotation",
"comment": "For systems that do not have structured annotations, they can simply communicate a single annotation with no author or time. This element may need to be included in narrative because of the potential for modifying information. *Annotations SHOULD NOT* be used to communicate \"modifying\" information that could be computable. (This is a SHOULD because enforcing user behavior is nearly impossible)."
}, {
"path": "Annotation.author[x]",
"min": 0,
"definition": "The individual responsible for making the annotation.",
"short": "Individual responsible for the annotation",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": "Act.participant[typeCode=AUT].role",
"identity": "rim"
} ],
"type": [ {
"code": "Reference",
"targetProfile": [ "http://hl7.org/fhir/StructureDefinition/Practitioner", "http://hl7.org/fhir/StructureDefinition/PractitionerRole", "http://hl7.org/fhir/StructureDefinition/Patient", "http://hl7.org/fhir/StructureDefinition/RelatedPerson", "http://hl7.org/fhir/StructureDefinition/Organization" ]
}, {
"code": "string"
} ],
"max": "1",
"id": "Annotation.author[x]",
"comment": "Organization is used when there's no need for specific attribution as to who made the comment.",
"isSummary": true
}, {
"path": "Annotation.time",
"min": 0,
"definition": "Indicates when this particular annotation was made.",
"short": "When the annotation was made",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": "Act.effectiveTime",
"identity": "rim"
} ],
"type": [ {
"code": "dateTime"
} ],
"max": "1",
"id": "Annotation.time",
"isSummary": true
}, {
"path": "Annotation.text",
"min": 1,
"definition": "The text of the annotation in markdown format.",
"short": "The annotation - text content (as markdown)",
"mapping": [ {
"map": "N/A",
"identity": "v2"
}, {
"map": "Act.text",
"identity": "rim"
} ],
"type": [ {
"code": "markdown"
} ],
"max": "1",
"id": "Annotation.text",
"isSummary": true
} ]
},
"contact": [ {
"telecom": [ {
"value": "http://hl7.org/fhir",
"system": "url"
} ]
}, {
"telecom": [ {
"value": "http://www.hl7.org/Special/committees/fiwg",
"system": "url"
} ]
} ],
"baseDefinition": "http://hl7.org/fhir/StructureDefinition/DataType"
}