PACIO Advance Directive Interoperability Implementation Guide, published by HL7 Patient Empowerment Working Group. This is not an authorized publication; it is the continuous build for version 0.1.0). This version is based on the current content of https://github.com/HL7/pacio-adi/ and changes regularly. See the Directory of published versions
This section defines additional requirements and guidance relevant to this guide as a whole. The conformance verbs - SHALL, SHOULD, MAY - used in this guide are defined in FHIR Conformance Rules.
To claim conformance to a profile in this guide, servers SHALL:
The following rules apply to all PACIO ADI Profile elements marked as Must Support. Must Support on any profile data element SHALL be interpreted as follows:
Profiles used by this guide, but defined in other implementation guides inherit the definition of Must Support from their respective guides.
The area of advance directive interoperability is relatively new and codes capturing the concepts related to advance directives are not well established or well known. This implementation guide provides several codes for expressing this information but specifies extensible bindings to use other code systems where necessary. These code systems may also not be well-known. Additionally, there are not widely accepted universal or national for standards for capturing this information. Different scopes of use and jurisdictions capture and organize this information in different ways. As such, it is important for data sources to capture this information as it is presented and for data consumer systems to be able to present it the same way to users.
To that end, several CodeableConcept
text
data elements are marked as Must Support.
Per the FHIR Standard for Using Text in CodeableConcept:
The
text
is the representation of the concept as entered or chosen by the user, and which most closely represents the intended meaning of the user or concept. Very often thetext
is the same as adisplay
of one of the codings. One or more of the codings may be flagged as the user selected code - the code or concept that the user selected directly.
In some cases a code may not exist for a particular concept, in such cases, it is possible to provide a free text only representation of the concept in the CodeableConcept
text
element without any ‘coding’ elements present.
For example, using text only, the Goal.category
element would be:
"valueCodeableConcept": {
"text": "Free text concept description"
}
Because advance directive interoperability is relatively new and there are not any widely accepted universal or national for standards for capturing this information, advance directives may be represented in many different ways. It is important that this information be communicated as it is meant and that it is received and viewable in that same manner.
To address this need, most of the profiles in this implementation guide require the resource instance’s text
element (cardinality 1..1
).
The text
element of a resource is a Narrative data type. The status
element of this data type indicates whether the text is generated by a system based on the structured data in the resource or if it contains additional information. The status
element is required.
For the purposes of this implementation guide, it is expected that most implementations will have resource instances that have additional data in the text
than is captured in the structured data. When that is the case, the narrative text.status
SHALL be additional
.
This guide requires the interoperability of Advance Directive Information through the use of wholly contained documents as part of its use case. While it is required that this data be made interoperable as a collection of Advance Directive Information in document Bundles, systems may decide to make use of the constituent resources as separate resources for additional uses and purposes, such as use in support of Clinical Decision Support
DocumentReference, Binary, Bundle