Consolidated CDA (C-CDA), published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 4.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/CDA-ccda/ and changes regularly. See the Directory of published versions
Draft as of 2024-11-21 |
Definitions for the USRealmPersonNamePNUSFIELDED logical model.
Guidance on how to interpret the contents of this table can be found here
0. PN | |
Logical Container | ClinicalDocument (CDA Class) |
XML Format | In the XML format, this property has the namespace urn:hl7-org:v3 . |
Invariants | 81-9371: The content of name **SHALL** be either a conformant Patient Name (PTN.US.FIELDED), or a string (CONF:81-9371). (conformsTo('http://hl7.org/cda/us/ccda/StructureDefinition/USRealmPatientNamePTNUSFIELDED') or item.xmlText.exists() )81-9372: The string **SHALL NOT** contain name parts (CONF:81-9372). ( item.xmlText.exists() implies (item.delimiter | item.family | item.given | item.prefix | item.suffix).empty() ) |
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 | 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() )81-9371: The content of name **SHALL** be either a conformant Patient Name (PTN.US.FIELDED), or a string (CONF:81-9371). ( conformsTo('http://hl7.org/cda/us/ccda/StructureDefinition/USRealmPatientNamePTNUSFIELDED') or item.xmlText.exists() )81-9372: The string **SHALL NOT** contain name parts (CONF:81-9372). ( item.xmlText.exists() implies (item.delimiter | item.family | item.given | item.prefix | item.suffix).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 | 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() )81-9371: The content of name **SHALL** be either a conformant Patient Name (PTN.US.FIELDED), or a string (CONF:81-9371). ( conformsTo('http://hl7.org/cda/us/ccda/StructureDefinition/USRealmPatientNamePTNUSFIELDED') or item.xmlText.exists() )81-9372: The string **SHALL NOT** contain name parts (CONF:81-9372). ( item.xmlText.exists() implies (item.delimiter | item.family | item.given | item.prefix | item.suffix).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 |