PACIO Advance Healthcare Directive Interoperability Implementation Guide
2.0.0-ballot - STU 2 – Ballot

PACIO Advance Healthcare Directive Interoperability Implementation Guide, published by HL7 International / Patient Empowerment. This guide is not an authorized publication; it is the continuous build for version 2.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/pacio-adi/ and changes regularly. See the Directory of published versions

## Resource Profile: ADI Healthcare Agent Participant

Official URL: http://hl7.org/fhir/us/pacio-adi/StructureDefinition/ADI-HealthcareAgentParticipant | Version: 2.0.0-ballot
Standards status: Trial-use | Maturity Level: 2 | Computable Name: ADIHealthcareAgentParticipant

A person represented using the ADI Healthcare Agent Profile and referenced from the ADI Healthcare Agent Consent Permit profile is appointed by the patient as an Authorized Personal Representative permitted the typical or jurisdictionally recognized powers granted to the role of healthcare agent. The person’s specific healthcare agent role, i.e. healthcare agent, primary healthcare agent, secondary healthcare agent, tertiary healthcare agent are specific within the ADI Healthcare Agent Consent Permit profile, and may be constrained through a nested ADI Healthcare Agent Consent Deny profile.

Usages:

- Refer to this Profile: ADI Healthcare Agent Consent, ADI PtAuthored Composition and ADI PMO Composition
- Examples for this Profile: RelatedPerson/Example-Smith-Johnson-HealthcareAgent1, RelatedPerson/Example-Smith-Johnson-HealthcareAgent2, RelatedPerson/Example-Smith-Johnson-HealthcareAgent3, RelatedPerson/Example-Smith-Johnson-Notary1 and RelatedPerson/Example-Smith-Johnson-Notary2
- CapabilityStatements using this Profile: ADI CapabilityStatement

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson |  | 0..* | RelatedPerson | A person that is related to a patient, but who is not a direct target of care
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
text |  | 1..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
active | ?!S Σ | 0..1 | boolean | Whether this related person's record is in active use
patient | S Σ | 1..1 | Reference(US Core Patient Profile) | The patient this person is related to
relationship | S Σ | 0..* | CodeableConcept | The nature of the relationship Slice: Unordered, Open by pattern:$this Binding: PatientRelationshipType (extensible)
name | S Σ | 1..1 | HumanName | A name associated with the person
telecom | S Σ | 1..* | ContactPoint | A contact detail for the person
address | S Σ | 0..* | Address | Address where the related person can be contacted or visited
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
RelatedPerson.relationship | extensible | PatientRelationshipType `http://hl7.org/fhir/ValueSet/relatedperson-relationshiptype` From the FHIR Standard

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | RelatedPerson | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management : text.`div`.exists() |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |

This structure is derived from RelatedPerson

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson |  |  | RelatedPerson |
text |  | 1..1 | Narrative | Text summary of the resource, for human interpretation
active | S | 0..1 | boolean | Whether this related person's record is in active use
patient | S | 1..1 | Reference(US Core Patient Profile) | The patient this person is related to
relationship | S | 0..* | CodeableConcept | The nature of the relationship Slice: Unordered, Open by pattern:$this Binding: PatientRelationshipType (extensible)
name | S | 1..1 | HumanName | A name associated with the person
telecom | S | 1..* | ContactPoint | A contact detail for the person
address | S | 0..* | Address | Address where the related person can be contacted or visited
Documentation for this format

#### Terminology Bindings (Differential)

Path | Conformance | ValueSet | URI
RelatedPerson.relationship | extensible | PatientRelationshipType `http://hl7.org/fhir/ValueSet/relatedperson-relationshiptype` From the FHIR Standard

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson |  | 0..* | RelatedPerson | A person that is related to a patient, but who is not a direct target of care
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 1..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 0..* | Identifier | A human identifier for this person
active | ?!S Σ | 0..1 | boolean | Whether this related person's record is in active use
patient | S Σ | 1..1 | Reference(US Core Patient Profile) | The patient this person is related to
relationship | S Σ | 0..* | CodeableConcept | The nature of the relationship Slice: Unordered, Open by pattern:$this Binding: PatientRelationshipType (extensible)
name | S Σ | 1..1 | HumanName | A name associated with the person
telecom | S Σ | 1..* | ContactPoint | A contact detail for the person
gender | Σ | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
birthDate | Σ | 0..1 | date | The date on which the related person was born
address | S Σ | 0..* | Address | Address where the related person can be contacted or visited
photo |  | 0..* | Attachment | Image of the person
period |  | 0..1 | Period | Period of time that this relationship is considered valid
communication |  | 0..* | BackboneElement | A language which may be used to communicate with about the patient's health
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
language |  | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
preferred |  | 0..1 | boolean | Language preference indicator
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
RelatedPerson.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding
RelatedPerson.relationship | extensible | PatientRelationshipType `http://hl7.org/fhir/ValueSet/relatedperson-relationshiptype` From the FHIR Standard
RelatedPerson.gender | required | AdministrativeGender `http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1` From the FHIR Standard
RelatedPerson.communication.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | RelatedPerson | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management : text.`div`.exists() |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |

This structure is derived from RelatedPerson

Summary

Mandatory: 3 elements
Must-Support: 6 elements

Structures

This structure refers to these other structures:

- US Core Patient Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient)

Slices

This structure defines the following Slices:

- The element 1 is sliced based on the value of RelatedPerson.relationship

Maturity: 2

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson |  | 0..* | RelatedPerson | A person that is related to a patient, but who is not a direct target of care
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
text |  | 1..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
active | ?!S Σ | 0..1 | boolean | Whether this related person's record is in active use
patient | S Σ | 1..1 | Reference(US Core Patient Profile) | The patient this person is related to
relationship | S Σ | 0..* | CodeableConcept | The nature of the relationship Slice: Unordered, Open by pattern:$this Binding: PatientRelationshipType (extensible)
name | S Σ | 1..1 | HumanName | A name associated with the person
telecom | S Σ | 1..* | ContactPoint | A contact detail for the person
address | S Σ | 0..* | Address | Address where the related person can be contacted or visited
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
RelatedPerson.relationship | extensible | PatientRelationshipType `http://hl7.org/fhir/ValueSet/relatedperson-relationshiptype` From the FHIR Standard

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | RelatedPerson | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management : text.`div`.exists() |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |

Differential View

This structure is derived from RelatedPerson

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson |  |  | RelatedPerson |
text |  | 1..1 | Narrative | Text summary of the resource, for human interpretation
active | S | 0..1 | boolean | Whether this related person's record is in active use
patient | S | 1..1 | Reference(US Core Patient Profile) | The patient this person is related to
relationship | S | 0..* | CodeableConcept | The nature of the relationship Slice: Unordered, Open by pattern:$this Binding: PatientRelationshipType (extensible)
name | S | 1..1 | HumanName | A name associated with the person
telecom | S | 1..* | ContactPoint | A contact detail for the person
address | S | 0..* | Address | Address where the related person can be contacted or visited
Documentation for this format

#### Terminology Bindings (Differential)

Path | Conformance | ValueSet | URI
RelatedPerson.relationship | extensible | PatientRelationshipType `http://hl7.org/fhir/ValueSet/relatedperson-relationshiptype` From the FHIR Standard

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
RelatedPerson |  | 0..* | RelatedPerson | A person that is related to a patient, but who is not a direct target of care
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 1..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 0..* | Identifier | A human identifier for this person
active | ?!S Σ | 0..1 | boolean | Whether this related person's record is in active use
patient | S Σ | 1..1 | Reference(US Core Patient Profile) | The patient this person is related to
relationship | S Σ | 0..* | CodeableConcept | The nature of the relationship Slice: Unordered, Open by pattern:$this Binding: PatientRelationshipType (extensible)
name | S Σ | 1..1 | HumanName | A name associated with the person
telecom | S Σ | 1..* | ContactPoint | A contact detail for the person
gender | Σ | 0..1 | code | male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
birthDate | Σ | 0..1 | date | The date on which the related person was born
address | S Σ | 0..* | Address | Address where the related person can be contacted or visited
photo |  | 0..* | Attachment | Image of the person
period |  | 0..1 | Period | Period of time that this relationship is considered valid
communication |  | 0..* | BackboneElement | A language which may be used to communicate with about the patient's health
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
language |  | 1..1 | CodeableConcept | The language which can be used to communicate with the patient about his or her health Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
preferred |  | 0..1 | boolean | Language preference indicator
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
RelatedPerson.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding
RelatedPerson.relationship | extensible | PatientRelationshipType `http://hl7.org/fhir/ValueSet/relatedperson-relationshiptype` From the FHIR Standard
RelatedPerson.gender | required | AdministrativeGender `http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1` From the FHIR Standard
RelatedPerson.communication.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | RelatedPerson | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | RelatedPerson | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | RelatedPerson | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | RelatedPerson | A resource should have narrative for robust management : text.`div`.exists() |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |

This structure is derived from RelatedPerson

Summary

Mandatory: 3 elements
Must-Support: 6 elements

Structures

This structure refers to these other structures:

- US Core Patient Profile (http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient)

Slices

This structure defines the following Slices:

- The element 1 is sliced based on the value of RelatedPerson.relationship

Maturity: 2

Other representations of profile: CSV, Excel, Schematron