Clinical Document Architecture
2.0.1-sd - release
Clinical Document Architecture
2.0.1-sd - release
Clinical Document Architecture, published by Health Level 7. This guide is not an authorized publication; it is the continuous build for version 2.0.1-sd built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-core-sd/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/cda/stds/core/StructureDefinition/Guardian | Version: 2.0.1-sd | |||
| Active as of 2025-10-02 | Computable Name: Guardian | |||
A patient's guardian is a person or organization in the role of guardian (Guardian class). The entity playing the role of guardian is a person (Person class) or organization (Organization class). The entity scoping the role is the patient (Patient class).
Where a guardian is not explicitly stated, the value should default to local business practice (e.g. the patient makes their own health care decisions unless incapacitated in which case healthcare decisions are made by the patient's spouse).
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 InfrastructureRoot
| Name | Flags | Card. | Type | Description & Constraints Filter:   |
|---|---|---|---|---|
  Guardian |
C | 1..1 | InfrastructureRoot | XML Namespace: urn:hl7-org:v3 Base for all types and resources Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) Constraints: guardian-choice |
  @classCode |
0..1 | cs | Binding: RoleClassAgent (required) Fixed Value: GUARD | |
 id |
0..* | II | ||
| sdtcIdentifiedBy |
0..* | IdentifiedBy | XML Namespace: urn:hl7-org:sdtc XML: identifiedBy (urn:hl7-org:sdtc) | |
| code |
0..1 | CE | Binding: CDARoleCode (example) | |
| addr |
0..* | AD | ||
| telecom |
0..* | TEL | ||
  (Choice of one) |
1..1 | |||
  guardianPerson |
0..1 | Person | ||
 guardianOrganization |
0..1 | Organization | ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Guardian.classCode | Base | required | RoleClassAgent | 📦2.0.0 | THO v5.2 |
| Guardian.code | Base | example | CDARoleCode | 📦2.0.1-sd | This IG |
| Id | Grade | Path(s) | Description | Expression |
| guardian-choice | error | Guardian | guardianPerson and guardianOrganization are mutually exclusive (one must be present) |
(guardianPerson | guardianOrganization).count() = 1
|
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Guardian |
C | 1..1 | InfrastructureRoot | XML Namespace: urn:hl7-org:v3 Base for all types and resources Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) Constraints: guardian-choice |
| @nullFlavor |
0..1 | cs | Binding: CDANullFlavor (required) | |
| realmCode |
0..* | CS | ||
 typeId |
C | 0..1 | II | Constraints: II-1 |
 @nullFlavor |
0..1 | cs | Binding: CDANullFlavor (required) | |
| @assigningAuthorityName |
0..1 | st | ||
| @displayable |
0..1 | bl | ||
| @root |
1..1 | oid, uuid, ruid | Fixed Value: 2.16.840.1.113883.1.3 | |
 @extension |
1..1 | st | ||
| templateId |
0..* | II | ||
| @classCode |
0..1 | cs | Binding: RoleClassAgent (required) Fixed Value: GUARD | |
| id |
0..* | II | ||
| sdtcIdentifiedBy |
0..* | IdentifiedBy | XML Namespace: urn:hl7-org:sdtc XML: identifiedBy (urn:hl7-org:sdtc) | |
| code |
0..1 | CE | Binding: CDARoleCode (example) | |
| addr |
0..* | AD | ||
| telecom |
0..* | TEL | ||
| (Choice of one) |
1..1 | |||
| guardianPerson |
0..1 | Person | ||
| guardianOrganization |
0..1 | Organization | ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Guardian.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | This IG |
| Guardian.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | This IG |
| Guardian.classCode | Base | required | RoleClassAgent | 📦2.0.0 | THO v5.2 |
| Guardian.code | Base | example | CDARoleCode | 📦2.0.1-sd | This IG |
| Id | Grade | Path(s) | Description | Expression |
| II-1 | error | Guardian.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
| guardian-choice | error | Guardian | guardianPerson and guardianOrganization are mutually exclusive (one must be present) |
(guardianPerson | guardianOrganization).count() = 1
|
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Guardian |
C | 1..1 | InfrastructureRoot | XML Namespace: urn:hl7-org:v3 Base for all types and resources Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) Constraints: guardian-choice |
| @nullFlavor |
0..1 | cs | Binding: CDANullFlavor (required) | |
| realmCode |
0..* | CS | ||
| typeId |
C | 0..1 | II | Constraints: II-1 |
| @nullFlavor |
0..1 | cs | Binding: CDANullFlavor (required) | |
| @assigningAuthorityName |
0..1 | st | ||
| @displayable |
0..1 | bl | ||
| @root |
1..1 | oid, uuid, ruid | Fixed Value: 2.16.840.1.113883.1.3 | |
| @extension |
1..1 | st | ||
| templateId |
0..* | II | ||
| @classCode |
0..1 | cs | Binding: RoleClassAgent (required) Fixed Value: GUARD | |
| id |
0..* | II | ||
| sdtcIdentifiedBy |
0..* | IdentifiedBy | XML Namespace: urn:hl7-org:sdtc XML: identifiedBy (urn:hl7-org:sdtc) | |
| code |
0..1 | CE | Binding: CDARoleCode (example) | |
| addr |
0..* | AD | ||
| telecom |
0..* | TEL | ||
| (Choice of one) |
1..1 | |||
| guardianPerson |
0..1 | Person | ||
| guardianOrganization |
0..1 | Organization | ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Guardian.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | This IG |
| Guardian.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | This IG |
| Guardian.classCode | Base | required | RoleClassAgent | 📦2.0.0 | THO v5.2 |
| Guardian.code | Base | example | CDARoleCode | 📦2.0.1-sd | This IG |
| Id | Grade | Path(s) | Description | Expression |
| II-1 | error | Guardian.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
| guardian-choice | error | Guardian | guardianPerson and guardianOrganization are mutually exclusive (one must be present) |
(guardianPerson | guardianOrganization).count() = 1
|
This structure is derived from InfrastructureRoot
Differential View
This structure is derived from InfrastructureRoot
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Guardian |
C | 1..1 | InfrastructureRoot | XML Namespace: urn:hl7-org:v3 Base for all types and resources Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) Constraints: guardian-choice |
| @classCode |
0..1 | cs | Binding: RoleClassAgent (required) Fixed Value: GUARD | |
| id |
0..* | II | ||
| sdtcIdentifiedBy |
0..* | IdentifiedBy | XML Namespace: urn:hl7-org:sdtc XML: identifiedBy (urn:hl7-org:sdtc) | |
| code |
0..1 | CE | Binding: CDARoleCode (example) | |
| addr |
0..* | AD | ||
| telecom |
0..* | TEL | ||
| (Choice of one) |
1..1 | |||
| guardianPerson |
0..1 | Person | ||
| guardianOrganization |
0..1 | Organization | ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Guardian.classCode | Base | required | RoleClassAgent | 📦2.0.0 | THO v5.2 |
| Guardian.code | Base | example | CDARoleCode | 📦2.0.1-sd | This IG |
| Id | Grade | Path(s) | Description | Expression |
| guardian-choice | error | Guardian | guardianPerson and guardianOrganization are mutually exclusive (one must be present) |
(guardianPerson | guardianOrganization).count() = 1
|
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Guardian |
C | 1..1 | InfrastructureRoot | XML Namespace: urn:hl7-org:v3 Base for all types and resources Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) Constraints: guardian-choice |
| @nullFlavor |
0..1 | cs | Binding: CDANullFlavor (required) | |
| realmCode |
0..* | CS | ||
| typeId |
C | 0..1 | II | Constraints: II-1 |
| @nullFlavor |
0..1 | cs | Binding: CDANullFlavor (required) | |
| @assigningAuthorityName |
0..1 | st | ||
| @displayable |
0..1 | bl | ||
| @root |
1..1 | oid, uuid, ruid | Fixed Value: 2.16.840.1.113883.1.3 | |
| @extension |
1..1 | st | ||
| templateId |
0..* | II | ||
| @classCode |
0..1 | cs | Binding: RoleClassAgent (required) Fixed Value: GUARD | |
| id |
0..* | II | ||
| sdtcIdentifiedBy |
0..* | IdentifiedBy | XML Namespace: urn:hl7-org:sdtc XML: identifiedBy (urn:hl7-org:sdtc) | |
| code |
0..1 | CE | Binding: CDARoleCode (example) | |
| addr |
0..* | AD | ||
| telecom |
0..* | TEL | ||
| (Choice of one) |
1..1 | |||
| guardianPerson |
0..1 | Person | ||
| guardianOrganization |
0..1 | Organization | ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Guardian.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | This IG |
| Guardian.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | This IG |
| Guardian.classCode | Base | required | RoleClassAgent | 📦2.0.0 | THO v5.2 |
| Guardian.code | Base | example | CDARoleCode | 📦2.0.1-sd | This IG |
| Id | Grade | Path(s) | Description | Expression |
| II-1 | error | Guardian.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
| guardian-choice | error | Guardian | guardianPerson and guardianOrganization are mutually exclusive (one must be present) |
(guardianPerson | guardianOrganization).count() = 1
|
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Guardian |
C | 1..1 | InfrastructureRoot | XML Namespace: urn:hl7-org:v3 Base for all types and resources Elements defined in Ancestors:@nullFlavor, realmCode, typeId, templateId Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) Constraints: guardian-choice |
| @nullFlavor |
0..1 | cs | Binding: CDANullFlavor (required) | |
| realmCode |
0..* | CS | ||
| typeId |
C | 0..1 | II | Constraints: II-1 |
| @nullFlavor |
0..1 | cs | Binding: CDANullFlavor (required) | |
| @assigningAuthorityName |
0..1 | st | ||
| @displayable |
0..1 | bl | ||
| @root |
1..1 | oid, uuid, ruid | Fixed Value: 2.16.840.1.113883.1.3 | |
| @extension |
1..1 | st | ||
| templateId |
0..* | II | ||
| @classCode |
0..1 | cs | Binding: RoleClassAgent (required) Fixed Value: GUARD | |
| id |
0..* | II | ||
| sdtcIdentifiedBy |
0..* | IdentifiedBy | XML Namespace: urn:hl7-org:sdtc XML: identifiedBy (urn:hl7-org:sdtc) | |
| code |
0..1 | CE | Binding: CDARoleCode (example) | |
| addr |
0..* | AD | ||
| telecom |
0..* | TEL | ||
| (Choice of one) |
1..1 | |||
| guardianPerson |
0..1 | Person | ||
| guardianOrganization |
0..1 | Organization | ||
| Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Guardian.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | This IG |
| Guardian.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | This IG |
| Guardian.classCode | Base | required | RoleClassAgent | 📦2.0.0 | THO v5.2 |
| Guardian.code | Base | example | CDARoleCode | 📦2.0.1-sd | This IG |
| Id | Grade | Path(s) | Description | Expression |
| II-1 | error | Guardian.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
| guardian-choice | error | Guardian | guardianPerson and guardianOrganization are mutually exclusive (one must be present) |
(guardianPerson | guardianOrganization).count() = 1
|
This structure is derived from InfrastructureRoot
IG © 2019+ Health Level 7. Package hl7.cda.uv.core#2.0.1-sd based on FHIR 5.0.0. Generated 2025-10-02
Links: Table of Contents |
QA Report
| Version History 
|
|
Propose a change