Advance Healthcare Directive Interoperability (cda-adi), published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cda-adi/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/cda/us/adi/StructureDefinition/AgentAppointmentPart | Version: 0.1.0 | |||
| Draft as of 2026-06-19 | Computable Name: Agent_Appointment_Part | |||
| Other Identifiers: urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#urn:hl7ii:2.16.840.1.113883.4.823.1.4.2.1:2026-08-28 | ||||
Sub-part of the ADI Healthcare Agent Consent Entry. This entry part includes the info about who was apointed a healthcare agent and their ordinal role. This entry is not intended to be used as a complete clinical statement entry on its own.
Usages:
You can also check for usages in the FHIR IG Statistics
Description of Template, Differentials, Snapshots and how the different presentations work.
This structure is derived from Observation
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
⏿20221029 | tx.fhir.org |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
⏿20251204 | tx.fhir.org |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
⏿20201204 | tx.fhir.org |
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.templateId:agent-appointment-part.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.classCode | Base | required | CDAActClassObservation | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.moodCode | Base | required | x_ActMoodDocumentObservation | 📍2.0.0 | THO v5.2 |
| Observation.code | Base | example | ObservationType | 📍3.0.0 | THO v7.1 |
| Observation.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
⏿20221029 | tx.fhir.org |
| Observation.statusCode | Base | required | ActStatus | 📍3.0.0 | THO v7.1 |
| Observation.priorityCode | Base | example | ActPriority | 📍3.0.0 | THO v7.1 |
| Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
| Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.methodCode | Base | example | ObservationMethod | 📍3.0.0 | THO v7.1 |
| Observation.participant.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeCode | Base | required | CDAParticipationType | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.contextControlCode | Base | required | CDAContextControl | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.classCode | Base | required | CDARoleClassRoot | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code | Base | example | CDARoleCode | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
⏿20251204 | tx.fhir.org |
| Observation.participant.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📍3.0.0 | THO v7.1 |
| Observation.participant.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📍3.0.0 | THO v7.1 |
| Observation.participant.participantRole.playingEntity.code | Base | example | CDAEntityCode | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
⏿20201204 | tx.fhir.org |
| Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Id | Grade | Path(s) | Description | Expression |
| II-1 | error | Observation.typeId, Observation.participant.typeId, Observation.participant.participantRole.typeId, Observation.participant.participantRole.playingEntity.typeId, Observation.referenceRange.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.templateId:agent-appointment-part.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.classCode | Base | required | CDAActClassObservation | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.moodCode | Base | required | x_ActMoodDocumentObservation | 📍2.0.0 | THO v5.2 |
| Observation.code | Base | example | ObservationType | 📍3.0.0 | THO v7.1 |
| Observation.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
⏿20221029 | tx.fhir.org |
| Observation.statusCode | Base | required | ActStatus | 📍3.0.0 | THO v7.1 |
| Observation.priorityCode | Base | example | ActPriority | 📍3.0.0 | THO v7.1 |
| Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
| Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.methodCode | Base | example | ObservationMethod | 📍3.0.0 | THO v7.1 |
| Observation.participant.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeCode | Base | required | CDAParticipationType | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.contextControlCode | Base | required | CDAContextControl | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.classCode | Base | required | CDARoleClassRoot | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code | Base | example | CDARoleCode | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
⏿20251204 | tx.fhir.org |
| Observation.participant.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📍3.0.0 | THO v7.1 |
| Observation.participant.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📍3.0.0 | THO v7.1 |
| Observation.participant.participantRole.playingEntity.code | Base | example | CDAEntityCode | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
⏿20201204 | tx.fhir.org |
| Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Id | Grade | Path(s) | Description | Expression |
| II-1 | error | Observation.typeId, Observation.participant.typeId, Observation.participant.participantRole.typeId, Observation.participant.participantRole.playingEntity.typeId, Observation.referenceRange.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
This structure is derived from Observation
Summary
Mandatory: 6 elements
Must-Support: 4 elements
Slices
This structure defines the following Slices:
Differential View
This structure is derived from Observation
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
⏿20221029 | tx.fhir.org |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
⏿20251204 | tx.fhir.org |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
⏿20201204 | tx.fhir.org |
Key Elements View
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.templateId:agent-appointment-part.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.classCode | Base | required | CDAActClassObservation | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.moodCode | Base | required | x_ActMoodDocumentObservation | 📍2.0.0 | THO v5.2 |
| Observation.code | Base | example | ObservationType | 📍3.0.0 | THO v7.1 |
| Observation.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
⏿20221029 | tx.fhir.org |
| Observation.statusCode | Base | required | ActStatus | 📍3.0.0 | THO v7.1 |
| Observation.priorityCode | Base | example | ActPriority | 📍3.0.0 | THO v7.1 |
| Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
| Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.methodCode | Base | example | ObservationMethod | 📍3.0.0 | THO v7.1 |
| Observation.participant.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeCode | Base | required | CDAParticipationType | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.contextControlCode | Base | required | CDAContextControl | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.classCode | Base | required | CDARoleClassRoot | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code | Base | example | CDARoleCode | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
⏿20251204 | tx.fhir.org |
| Observation.participant.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📍3.0.0 | THO v7.1 |
| Observation.participant.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📍3.0.0 | THO v7.1 |
| Observation.participant.participantRole.playingEntity.code | Base | example | CDAEntityCode | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
⏿20201204 | tx.fhir.org |
| Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Id | Grade | Path(s) | Description | Expression |
| II-1 | error | Observation.typeId, Observation.participant.typeId, Observation.participant.participantRole.typeId, Observation.participant.participantRole.playingEntity.typeId, Observation.referenceRange.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
Snapshot View
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.templateId:agent-appointment-part.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.classCode | Base | required | CDAActClassObservation | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.moodCode | Base | required | x_ActMoodDocumentObservation | 📍2.0.0 | THO v5.2 |
| Observation.code | Base | example | ObservationType | 📍3.0.0 | THO v7.1 |
| Observation.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
⏿20221029 | tx.fhir.org |
| Observation.statusCode | Base | required | ActStatus | 📍3.0.0 | THO v7.1 |
| Observation.priorityCode | Base | example | ActPriority | 📍3.0.0 | THO v7.1 |
| Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
| Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.methodCode | Base | example | ObservationMethod | 📍3.0.0 | THO v7.1 |
| Observation.participant.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeCode | Base | required | CDAParticipationType | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.contextControlCode | Base | required | CDAContextControl | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.classCode | Base | required | CDARoleClassRoot | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code | Base | example | CDARoleCode | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
⏿20251204 | tx.fhir.org |
| Observation.participant.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📍3.0.0 | THO v7.1 |
| Observation.participant.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📍3.0.0 | THO v7.1 |
| Observation.participant.participantRole.playingEntity.code | Base | example | CDAEntityCode | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
⏿20201204 | tx.fhir.org |
| Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📍2.0.3-sd | Clinical Document Architecture v2.0 |
| Id | Grade | Path(s) | Description | Expression |
| II-1 | error | Observation.typeId, Observation.participant.typeId, Observation.participant.participantRole.typeId, Observation.participant.participantRole.playingEntity.typeId, Observation.referenceRange.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
This structure is derived from Observation
Summary
Mandatory: 6 elements
Must-Support: 4 elements
Slices
This structure defines the following Slices: