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/Agent.Appointment.Part | Version: 0.1.0 | |||
| Draft as of 2026-02-01 | Computable Name: Agent_Appointment_Part | |||
This entry part includes the info about who was apointed a healthcare agent and their ordinal role.
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
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
1..1 | Observation | XML Namespace: urn:hl7-org:v3 Base for all types and resources Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) | |
![]() ![]() |
||||
![]() ![]() ![]() |
0..1 | cs | Binding: Healthcare Agent or Proxy Choices (required) | |
![]() ![]() |
0..1 | ED | links to the rendering of a participating Healthcare Agent | |
![]() ![]() |
1..1 | Participant2 | ||
![]() ![]() ![]() |
1..1 | cs | Use NOT for person to be notified | |
![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() |
0..1 | cs | Required Pattern: AGNT | |
![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
0..1 | cs | Binding: Personal And Legal Relationship Role Type (extensible) | |
![]() ![]() ![]() ![]() |
S | 0..* | AD | |
![]() ![]() ![]() ![]() |
S | 0..* | TEL | |
![]() ![]() ![]() ![]() |
1..1 | PlayingEntity | ||
![]() ![]() ![]() ![]() ![]() |
S | 0..1 | CE | |
![]() ![]() ![]() ![]() ![]() ![]() |
0..1 | cs | Binding: Healthcare Agent Ordinality (required) | |
![]() ![]() ![]() ![]() ![]() |
S | 0..* | PN | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
📦20221029 | VSAC v0.23 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
📦20240606 | VSAC v0.23 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
📦20201204 | VSAC v0.23 |
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.classCode | Base | required | CDAActClassObservation | 📦2.0.1-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 v6.5 |
| Observation.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
📦20221029 | VSAC v0.23 |
| Observation.statusCode | Base | required | ActStatus | 📍3.0.0 | THO v6.5 |
| Observation.priorityCode | Base | example | ActPriority | 📍3.0.0 | THO v6.5 |
| Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
| Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.methodCode | Base | example | ObservationMethod | 📍3.0.0 | THO v6.5 |
| Observation.participant.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeCode | Base | required | CDAParticipationType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.contextControlCode | Base | required | CDAContextControl | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.classCode | Base | required | CDARoleClassRoot | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code | Base | example | CDARoleCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
📦20240606 | VSAC v0.23 |
| Observation.participant.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📍3.0.0 | THO v6.5 |
| Observation.participant.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📍3.0.0 | THO v6.5 |
| Observation.participant.participantRole.playingEntity.code | Base | example | CDAEntityCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
📦20201204 | VSAC v0.23 |
| Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📦2.0.1-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.1-sd | Clinical Document Architecture v2.0 |
| Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.classCode | Base | required | CDAActClassObservation | 📦2.0.1-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 v6.5 |
| Observation.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
📦20221029 | VSAC v0.23 |
| Observation.statusCode | Base | required | ActStatus | 📍3.0.0 | THO v6.5 |
| Observation.priorityCode | Base | example | ActPriority | 📍3.0.0 | THO v6.5 |
| Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
| Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.methodCode | Base | example | ObservationMethod | 📍3.0.0 | THO v6.5 |
| Observation.participant.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeCode | Base | required | CDAParticipationType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.contextControlCode | Base | required | CDAContextControl | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.classCode | Base | required | CDARoleClassRoot | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code | Base | example | CDARoleCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
📦20240606 | VSAC v0.23 |
| Observation.participant.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📍3.0.0 | THO v6.5 |
| Observation.participant.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📍3.0.0 | THO v6.5 |
| Observation.participant.participantRole.playingEntity.code | Base | example | CDAEntityCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
📦20201204 | VSAC v0.23 |
| Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📦2.0.1-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
Differential View
This structure is derived from Observation
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
1..1 | Observation | XML Namespace: urn:hl7-org:v3 Base for all types and resources Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) | |
![]() ![]() |
||||
![]() ![]() ![]() |
0..1 | cs | Binding: Healthcare Agent or Proxy Choices (required) | |
![]() ![]() |
0..1 | ED | links to the rendering of a participating Healthcare Agent | |
![]() ![]() |
1..1 | Participant2 | ||
![]() ![]() ![]() |
1..1 | cs | Use NOT for person to be notified | |
![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() |
0..1 | cs | Required Pattern: AGNT | |
![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
0..1 | cs | Binding: Personal And Legal Relationship Role Type (extensible) | |
![]() ![]() ![]() ![]() |
S | 0..* | AD | |
![]() ![]() ![]() ![]() |
S | 0..* | TEL | |
![]() ![]() ![]() ![]() |
1..1 | PlayingEntity | ||
![]() ![]() ![]() ![]() ![]() |
S | 0..1 | CE | |
![]() ![]() ![]() ![]() ![]() ![]() |
0..1 | cs | Binding: Healthcare Agent Ordinality (required) | |
![]() ![]() ![]() ![]() ![]() |
S | 0..* | PN | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
📦20221029 | VSAC v0.23 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
📦20240606 | VSAC v0.23 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
📦20201204 | VSAC v0.23 |
Key Elements View
| Path | Status | Usage | ValueSet | Version | Source |
| Observation.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.classCode | Base | required | CDAActClassObservation | 📦2.0.1-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 v6.5 |
| Observation.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
📦20221029 | VSAC v0.23 |
| Observation.statusCode | Base | required | ActStatus | 📍3.0.0 | THO v6.5 |
| Observation.priorityCode | Base | example | ActPriority | 📍3.0.0 | THO v6.5 |
| Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
| Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.methodCode | Base | example | ObservationMethod | 📍3.0.0 | THO v6.5 |
| Observation.participant.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeCode | Base | required | CDAParticipationType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.contextControlCode | Base | required | CDAContextControl | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.classCode | Base | required | CDARoleClassRoot | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code | Base | example | CDARoleCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
📦20240606 | VSAC v0.23 |
| Observation.participant.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📍3.0.0 | THO v6.5 |
| Observation.participant.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📍3.0.0 | THO v6.5 |
| Observation.participant.participantRole.playingEntity.code | Base | example | CDAEntityCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
📦20201204 | VSAC v0.23 |
| Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📦2.0.1-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.1-sd | Clinical Document Architecture v2.0 |
| Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.classCode | Base | required | CDAActClassObservation | 📦2.0.1-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 v6.5 |
| Observation.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.code.code | Base | required |
Healthcare Agent or Proxy Choices
|
📦20221029 | VSAC v0.23 |
| Observation.statusCode | Base | required | ActStatus | 📍3.0.0 | THO v6.5 |
| Observation.priorityCode | Base | example | ActPriority | 📍3.0.0 | THO v6.5 |
| Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
| Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.methodCode | Base | example | ObservationMethod | 📍3.0.0 | THO v6.5 |
| Observation.participant.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.typeCode | Base | required | CDAParticipationType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.contextControlCode | Base | required | CDAContextControl | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.classCode | Base | required | CDARoleClassRoot | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code | Base | example | CDARoleCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.code.code | Base | extensible |
Personal And Legal Relationship Role Type
|
📦20240606 | VSAC v0.23 |
| Observation.participant.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📍3.0.0 | THO v6.5 |
| Observation.participant.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📍3.0.0 | THO v6.5 |
| Observation.participant.participantRole.playingEntity.code | Base | example | CDAEntityCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.participant.participantRole.playingEntity.code.code | Base | required |
Healthcare Agent Ordinality
|
📦20201204 | VSAC v0.23 |
| Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
| Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📦2.0.1-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