TN: TrivialName (V3 Data Type) - Definitions - Clinical Document Architecture with Australian Schema v1.0.1

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.1 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: TN - Detailed Descriptions

Active as of 2025-10-09

Maturity Level: 1

Definitions for the TN logical model.

Key Elements Table
Differential Elements Table
Snapshot Elements Table

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

0. TN
Definition	A restriction of entity name that is effectively a simple string used for a simple name for things and places. Base definition for all types defined in FHIR type system.
Short	Base for all types and resources
Control	10..*
Is Modifier	false
Logical Container	ClinicalDocument (CDA Class)
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. TN.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. TN.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. TN.item
Definition	A series of items that constitute the name.
Control	0..*
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. TN.item.delimiter
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
10. TN.item.family
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
12. TN.item.given
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
14. TN.item.prefix
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
16. TN.item.suffix
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
18. TN.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. TN.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

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

0. TN
Definition	A restriction of entity name that is effectively a simple string used for a simple name for things and places.
Control	1..*
Logical Container	ClinicalDocument (CDA Class)
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. TN.use
Binding	The codes SHALL be taken from CDAEntityNameUse (required to `http://hl7.org/cda/stds/core/ValueSet/CDAEntityNameUse`)
4. TN.item
6. TN.item.delimiter
Control	0..0
8. TN.item.family
Control	0..0
10. TN.item.given
Control	0..0
12. TN.item.prefix
Control	0..0
14. TN.item.suffix
Control	0..0

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

0. TN
Definition	A restriction of entity name that is effectively a simple string used for a simple name for things and places.
Short	Base for all types and resources
Control	1..*
Is Modifier	false
Logical Container	ClinicalDocument (CDA Class)
XML Format	In the XML format, this property has the namespace `urn:hl7-org:v3`.
2. TN.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. TN.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. TN.item
Definition	A series of items that constitute the name.
Control	0..*
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. TN.item.delimiter
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
10. TN.item.family
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
12. TN.item.given
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
14. TN.item.prefix
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
16. TN.item.suffix
Control	0..0
Type	http://hl7.org/cda/stds/core/StructureDefinition/ENXP
18. TN.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. TN.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