PN: PersonName (V3 Data Type) - 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: PN - Detailed Descriptions

Active as of 2024-11-22

Definitions for the PN 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. PN
Definition	A name for a person. A sequence of name parts, such as given name or family name, prefix, suffix, etc. Examples for person name values are "Jim Bob Walton, Jr.", "Adam Everyman", etc. A person name may be as simple as a character string or may consist of several person name parts, such as, "Jim", "Bob", "Walton", and "Jr.". PN differs from EN because the qualifier type cannot include LS (Legal Status).
Logical Container	ADHA ClinicalDocument (CDA Class)
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
Invariants	pn-no-ls: No PN name part may have a qualifier of LS. (`(item.delimiter \| item.family \| item.given \| item.prefix \| item.suffix).where(qualifier.where($this = 'LS').exists()).empty()`)
2. PN.item
Control	1..*

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

0. PN
Definition	A name for a person. A sequence of name parts, such as given name or family name, prefix, suffix, etc. Examples for person name values are "Jim Bob Walton, Jr.", "Adam Everyman", etc. A person name may be as simple as a character string or may consist of several person name parts, such as, "Jim", "Bob", "Walton", and "Jr.". PN differs from EN because the qualifier type cannot include LS (Legal Status). Base definition for all types defined in FHIR type system.
Short	Base for all types and resources
Control	10..*
Is Modifier	false
Logical Container	ADHA ClinicalDocument (CDA Class)
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
Invariants	pn-no-ls: No PN name part may have a qualifier of LS. (`(item.delimiter \| item.family \| item.given \| item.prefix \| item.suffix).where(qualifier.where($this = 'LS').exists()).empty()`)
2. PN.item
Definition	A series of items that constitute the name.
Control	1..*
Type	http://hl7.org/fhir/StructureDefinition/Base
Choice Group	This is a repeating choice group that does not appear directly in the instance
Invariants	EN-1: Can only have only one of the possible item elements in each choice (`(delimiter \| family \| given \| prefix \| suffix \| xmlText).count() = 1`)

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

0. PN
Definition	A name for a person. A sequence of name parts, such as given name or family name, prefix, suffix, etc. Examples for person name values are "Jim Bob Walton, Jr.", "Adam Everyman", etc. A person name may be as simple as a character string or may consist of several person name parts, such as, "Jim", "Bob", "Walton", and "Jr.". PN differs from EN because the qualifier type cannot include LS (Legal Status).
Short	Base for all types and resources
Control	1..*
Is Modifier	false
Logical Container	ADHA ClinicalDocument (CDA Class)
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
Invariants	pn-no-ls: No PN name part may have a qualifier of LS. (`(item.delimiter \| item.family \| item.given \| item.prefix \| item.suffix).where(qualifier.where($this = 'LS').exists()).empty()`)
2. PN.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. PN.use
Definition	A set of codes advising a system or user which name in a set of like names to select for a given purpose. A name without specific use code might be a default name useful for any purpose, but a name with a specific use code would be preferred for that respective purpose
Control	0..*
Binding	The codes SHALL be taken from CDAEntityNameUse (required to `http://hl7.org/cda/stds/core/ValueSet/CDAEntityNameUse`)
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	Use Code
6. PN.item
Definition	A series of items that constitute the name.
Control	1..*
Type	http://hl7.org/fhir/StructureDefinition/Base
Choice Group	This is a repeating choice group that does not appear directly in the instance
Invariants	EN-1: Can only have only one of the possible item elements in each choice (`(delimiter \| family \| given \| prefix \| suffix \| xmlText).count() = 1`)
8. PN.item.delimiter
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
10. PN.item.family
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
12. PN.item.given
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
14. PN.item.prefix
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
16. PN.item.suffix
Control	0..*
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
18. PN.item.xmlText
Short	Allows for mixed text content
Comments	This element is represented in XML as textual content. The actual name "xmlText" will not appear in a CDA instance.
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 unadorned text.
20. PN.validTime
Definition	An interval of time specifying the time during which the name is or was used for the entity. This accomodates the fact that people change names for people, places and things.
Control	0..1
Type	http://hl7.org/cda/stds/core/StructureDefinition/IVL-TS
Label	Valid Time