ADHA Patient (CDA Class) - Definitions - Clinical Document Architecture with Australian Schema v1.0.0

Clinical Document Architecture with Australian Schema, published by Australian Digital Health Agency. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/AuDigitalHealth/cda-au-schema/ and changes regularly. See the Directory of published versions

Logical Model: au-Patient - Detailed Descriptions

Active as of 2024-11-22

Definitions for the au-Patient logical model.

Differential Elements Table
Key Elements Table
Snapshot Elements Table

Guidance on how to interpret the contents of this table can be found here

0. Patient
Short	Australian adaptation of the HL7 International CDA Patient class
Control	1..1
Logical Container	ADHA ClinicalDocument (CDA Class)
Validation	Instance of this type are validated by templateId
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. Patient.classCode
Control	0..1
Binding	The codes SHALL be taken from EntityClassLivingSubject (required to `http://terminology.hl7.org/ValueSet/v3-EntityClassLivingSubject`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`PSN`
4. Patient.determinerCode
Control	0..1
Binding	The codes SHALL be taken from EntityDeterminer (required to `http://terminology.hl7.org/ValueSet/v3-EntityDeterminer`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`INSTANCE`
6. Patient.id
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
8. Patient.name
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/au-PersonName
10. Patient.administrativeGenderCode
Control	1..1
Binding	For example codes, see AdministrativeGender (example to `http://terminology.hl7.org/ValueSet/v3-AdministrativeGender`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
12. Patient.birthTime
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
14. Patient.maritalStatusCode
Control	0..1
Binding	For example codes, see MaritalStatus (example to `http://terminology.hl7.org/ValueSet/v3-MaritalStatus`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
16. Patient.religiousAffiliationCode
Control	0..1
Binding	For example codes, see ReligiousAffiliation (example to `http://terminology.hl7.org/ValueSet/v3-ReligiousAffiliation`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
18. Patient.raceCode
Control	0..1
Binding	For example codes, see Race (example to `http://terminology.hl7.org/ValueSet/v3-Race`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
20. Patient.ethnicGroupCode
Control	0..1
Binding	For example codes, see Ethnicity (example to `http://terminology.hl7.org/ValueSet/v3-Ethnicity`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
22. Patient.multipleBirthInd
Short	ADHA CDA extension to represent patient's multiple birth indicator
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
24. Patient.multipleBirthOrderNumber
Short	ADHA CDA extension to represent a patient's multiple birth order number
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/INT
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
26. Patient.deceasedInd
Short	ADHA CDA extension to represent a patient's deceased indicator
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
28. Patient.deceasedTime
Short	ADHA CDA extension to represent a patient's deceased time
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
30. Patient.guardian
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/Guardian
32. Patient.birthplace
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/Birthplace
34. Patient.asEntityIdentifier
Short	ADHA CDA extension to represent a patient's identifier
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/asEntityIdentifier(ADHA extension asEntityIdentifier)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
36. Patient.asEmployment
Short	ADHA CDA extension to represent employment class
Control	0..1
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/asEmployment(ADHA Extension asEmployment)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
38. Patient.personalRelationship
Short	ADHA CDA extension to represent personal relationships
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/personalRelationship(ADHA extension personalRelationship)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
40. Patient.languageCommunication
Short	Australian-adapted LanguageCommunication class
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/au-languageCommunication(ADHA LanguageCommunication (CDA Class))

Guidance on how to interpret the contents of this table can be found here

0. Patient
Definition	Defines the basic properties of every data value. This is an abstract type, meaning that no value can be just a data value without belonging to any concrete type. Every concrete type is a specialization of this general abstract DataValue type. Base definition for all types defined in FHIR type system.
Short	Australian adaptation of the HL7 International CDA Patient classBase for all types and resources
Control	10..1*
Is Modifier	false
Logical Container	ADHA ClinicalDocument (CDA Class)
Validation	Instance of this type are validated by templateId
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. Patient.classCode
Control	0..1
Binding	The codes SHALL be taken from EntityClassLivingSubject (required to `http://terminology.hl7.org/ValueSet/v3-EntityClassLivingSubject`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`PSN`
4. Patient.determinerCode
Control	0..1
Binding	The codes SHALL be taken from EntityDeterminer (required to `http://terminology.hl7.org/ValueSet/v3-EntityDeterminer`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`INSTANCE`
6. Patient.id
Definition	The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
Short	Logical id of this artifact
Comments	Within the context of the FHIR RESTful interactions, the resource has an id except for cases like the create and conditional update. Otherwise, the use of the resouce id depends on the given use case.
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/IIid
Is Modifier	false
8. Patient.name
Definition	A name associated with the individual.
Short	A name associated with the patient
Comments	A patient may have multiple names with different uses or applicable periods. For animals, the name is a "HumanName" in the sense that is assigned and used by humans and has the same patterns. Animal names may be communicated as given names, and optionally may include a family name.
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/au-PersonNameHumanName
Is Modifier	false
Requirements	Need to be able to track the patient by multiple names. Examples are your official name and a partner name.
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
10. Patient.administrativeGenderCode
Control	1..1
Binding	For example codes, see AdministrativeGender (example to `http://terminology.hl7.org/ValueSet/v3-AdministrativeGender`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
12. Patient.birthTime
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
14. Patient.maritalStatusCode
Control	0..1
Binding	For example codes, see MaritalStatus (example to `http://terminology.hl7.org/ValueSet/v3-MaritalStatus`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
16. Patient.religiousAffiliationCode
Control	0..1
Binding	For example codes, see ReligiousAffiliation (example to `http://terminology.hl7.org/ValueSet/v3-ReligiousAffiliation`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
18. Patient.raceCode
Control	0..1
Binding	For example codes, see Race (example to `http://terminology.hl7.org/ValueSet/v3-Race`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
20. Patient.ethnicGroupCode
Control	0..1
Binding	For example codes, see Ethnicity (example to `http://terminology.hl7.org/ValueSet/v3-Ethnicity`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
22. Patient.multipleBirthInd
Short	ADHA CDA extension to represent patient's multiple birth indicator
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
24. Patient.multipleBirthOrderNumber
Short	ADHA CDA extension to represent a patient's multiple birth order number
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/INT
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
26. Patient.deceasedInd
Short	ADHA CDA extension to represent a patient's deceased indicator
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
28. Patient.deceasedTime
Short	ADHA CDA extension to represent a patient's deceased time
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
30. Patient.guardian
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/Guardian
32. Patient.birthplace
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/Birthplace
34. Patient.asEntityIdentifier
Short	ADHA CDA extension to represent a patient's identifier
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/asEntityIdentifier(ADHA extension asEntityIdentifier)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
36. Patient.asEmployment
Short	ADHA CDA extension to represent employment class
Control	0..1
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/asEmployment(ADHA Extension asEmployment)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
38. Patient.personalRelationship
Short	ADHA CDA extension to represent personal relationships
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/personalRelationship(ADHA extension personalRelationship)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
40. Patient.languageCommunication
Short	Australian-adapted LanguageCommunication class
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/au-languageCommunication(ADHA LanguageCommunication (CDA Class))

Guidance on how to interpret the contents of this table can be found here

0. Patient
Definition	Defines the basic properties of every data value. This is an abstract type, meaning that no value can be just a data value without belonging to any concrete type. Every concrete type is a specialization of this general abstract DataValue type.
Short	Australian adaptation of the HL7 International CDA Patient class
Control	1..1
Is Modifier	false
Logical Container	ADHA ClinicalDocument (CDA Class)
Validation	Instance of this type are validated by templateId
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. Patient.nullFlavor
Definition	If a value is an exceptional value (NULL-value), this specifies in what way and why proper information is missing.
Control	0..1
Binding	The codes SHALL be taken from CDANullFlavor (required to `http://hl7.org/cda/stds/core/ValueSet/CDANullFlavor`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Exceptional Value Detail
4. Patient.realmCode
Definition	When valued in an instance, this attribute signals the imposition of realm-specific constraints. The value of this attribute identifies the realm in question
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/CS
6. Patient.typeId
Definition	When valued in an instance, this attribute signals the imposition of constraints defined in an HL7-specified message type. This might be a common type (also known as CMET in the messaging communication environment), or content included within a wrapper. The value of this attribute provides a unique identifier for the type in question.
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
8. Patient.typeId.nullFlavor
Definition	If a value is an exceptional value (NULL-value), this specifies in what way and why proper information is missing.
Control	0..1
Binding	The codes SHALL be taken from CDANullFlavor (required to `http://hl7.org/cda/stds/core/ValueSet/CDANullFlavor`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Exceptional Value Detail
10. Patient.typeId.assigningAuthorityName
Definition	A human readable name or mnemonic for the assigning authority. The Assigning Authority Name has no computational value. The purpose of a Assigning Authority Name is to assist an unaided human interpreter of an II value to interpret the authority. Note: no automated processing must depend on the assigning authority name to be present in any form.
Control	0..1
Type	string(st: Character String)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Assigning Authority Name
12. Patient.typeId.displayable
Definition	Specifies if the identifier is intended for human display and data entry (displayable = true) as opposed to pure machine interoperation (displayable = false).
Control	0..1
Type	boolean(bl: Boolean)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Displayable
14. Patient.typeId.root
Definition	Identifies the type as an HL7 Registered model
Control	1..1
Type	string(oid: ISO Object Identifier, uuid: DCE Universal Unique Identifier, ruid: HL7 Reserved Identifier Scheme)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Root
Fixed Value	`2.16.840.1.113883.1.3`
16. Patient.typeId.extension
Definition	A character string as a unique identifier within the scope of the identifier root.
Control	1..1
Type	string(st: Character String)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Label	Extension
18. Patient.templateId
Definition	When valued in an instance, this attribute signals the imposition of a set of template-defined constraints. The value of this attribute provides a unique identifier for the templates in question
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
20. Patient.classCode
Control	0..1
Binding	The codes SHALL be taken from EntityClassLivingSubject (required to `http://terminology.hl7.org/ValueSet/v3-EntityClassLivingSubject`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`PSN`
22. Patient.determinerCode
Control	0..1
Binding	The codes SHALL be taken from EntityDeterminer (required to `http://terminology.hl7.org/ValueSet/v3-EntityDeterminer`)
Type	code(cs: Coded Simple Value)
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
XML Format	In the XML format, this property is represented as an attribute.
Fixed Value	`INSTANCE`
24. Patient.id
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/II
26. Patient.name
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/au-PersonName
28. Patient.administrativeGenderCode
Control	1..1
Binding	For example codes, see AdministrativeGender (example to `http://terminology.hl7.org/ValueSet/v3-AdministrativeGender`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
30. Patient.birthTime
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
32. Patient.maritalStatusCode
Control	0..1
Binding	For example codes, see MaritalStatus (example to `http://terminology.hl7.org/ValueSet/v3-MaritalStatus`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
34. Patient.religiousAffiliationCode
Control	0..1
Binding	For example codes, see ReligiousAffiliation (example to `http://terminology.hl7.org/ValueSet/v3-ReligiousAffiliation`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
36. Patient.raceCode
Control	0..1
Binding	For example codes, see Race (example to `http://terminology.hl7.org/ValueSet/v3-Race`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
38. Patient.ethnicGroupCode
Control	0..1
Binding	For example codes, see Ethnicity (example to `http://terminology.hl7.org/ValueSet/v3-Ethnicity`)
Type	http://hl7.org/cda/stds/core/StructureDefinition/CE
40. Patient.multipleBirthInd
Short	ADHA CDA extension to represent patient's multiple birth indicator
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
42. Patient.multipleBirthOrderNumber
Short	ADHA CDA extension to represent a patient's multiple birth order number
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/INT
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
44. Patient.deceasedInd
Short	ADHA CDA extension to represent a patient's deceased indicator
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/BL
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
46. Patient.deceasedTime
Short	ADHA CDA extension to represent a patient's deceased time
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/TS
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
48. Patient.guardian
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/Guardian
50. Patient.birthplace
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/Birthplace
52. Patient.asEntityIdentifier
Short	ADHA CDA extension to represent a patient's identifier
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/asEntityIdentifier(ADHA extension asEntityIdentifier)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
54. Patient.asEmployment
Short	ADHA CDA extension to represent employment class
Control	0..1
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/asEmployment(ADHA Extension asEmployment)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
56. Patient.personalRelationship
Short	ADHA CDA extension to represent personal relationships
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/personalRelationship(ADHA extension personalRelationship)
XML Format	In the XML format, this property has the namespace `http://ns.electronichealth.net.au/Ci/Cda/Extensions/3.0`.
58. Patient.languageCommunication
Short	Australian-adapted LanguageCommunication class
Control	0..*
Type	http://ns.electronichealth.net.au/cda/StructureDefinition/au-languageCommunication(ADHA LanguageCommunication (CDA Class))