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 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
Official URL: http://hl7.org/cda/us/ccda/StructureDefinition/USRealmPersonNamePNUSFIELDED | Version: 4.0.0 | |||
Draft as of 2025-10-02 | Computable Name: USRealmPersonNamePNUSFIELDED | |||
Other Identifiers: OID:2.16.840.1.113883.10.20.22.5.1.1 |
The US Realm Clinical Document Person Name datatype flavor is a set of reusable constraints that can be used for Persons.
Usages:
You can also check for usages in the FHIR IG Statistics
Changes since version 3.0.0:
Description of Template, Differentials, Snapshots and how the different presentations work.
This structure is derived from PN
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
C | 1..* | PN | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: 81-9371, 81-9372 |
![]() |
Id | Grade | Path(s) | Description | Expression |
81-9371 | error | PN | 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 | error | PN | 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()
|
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
C | 1..* | PN | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: pn-no-ls, 81-9371, 81-9372 |
![]() ![]() ![]() |
0..1 | cs | Binding: CDANullFlavor (required) | |
![]() ![]() ![]() |
0..* | cs | Binding: CDAEntityNameUse (required) | |
![]() ![]() ![]() |
C | 1..* | Base | Choice Group: This is a repeating choice group that does not appear directly in the instance Constraints: EN-1 |
![]() ![]() ![]() ![]() |
1..1 | |||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..1 | st | Allows for mixed text content | |
![]() ![]() ![]() |
0..1 | IVL_TS | ||
![]() |
Path | Status | Usage | ValueSet | Version | Source |
PN.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
PN.use | Base | required | CDAEntityNameUse | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Id | Grade | Path(s) | Description | Expression |
81-9371 | error | PN | 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 | error | PN | 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()
|
EN-1 | error | PN.item | Can only have only one of the possible item elements in each choice |
(delimiter | family | given | prefix | suffix | xmlText).count() = 1
|
pn-no-ls | error | PN | 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()
|
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
C | 1..* | PN | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: pn-no-ls, 81-9371, 81-9372 |
![]() ![]() ![]() |
0..1 | cs | Binding: CDANullFlavor (required) | |
![]() ![]() ![]() |
0..* | cs | Binding: CDAEntityNameUse (required) | |
![]() ![]() ![]() |
C | 1..* | Base | Choice Group: This is a repeating choice group that does not appear directly in the instance Constraints: EN-1 |
![]() ![]() ![]() ![]() |
1..1 | |||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..1 | st | Allows for mixed text content | |
![]() ![]() ![]() |
0..1 | IVL_TS | ||
![]() |
Path | Status | Usage | ValueSet | Version | Source |
PN.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
PN.use | Base | required | CDAEntityNameUse | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Id | Grade | Path(s) | Description | Expression |
81-9371 | error | PN | 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 | error | PN | 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()
|
EN-1 | error | PN.item | Can only have only one of the possible item elements in each choice |
(delimiter | family | given | prefix | suffix | xmlText).count() = 1
|
pn-no-ls | error | PN | 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()
|
This structure is derived from PN
Differential View
This structure is derived from PN
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
C | 1..* | PN | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: 81-9371, 81-9372 |
![]() |
Id | Grade | Path(s) | Description | Expression |
81-9371 | error | PN | 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 | error | PN | 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()
|
Key Elements View
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
C | 1..* | PN | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: pn-no-ls, 81-9371, 81-9372 |
![]() ![]() ![]() |
0..1 | cs | Binding: CDANullFlavor (required) | |
![]() ![]() ![]() |
0..* | cs | Binding: CDAEntityNameUse (required) | |
![]() ![]() ![]() |
C | 1..* | Base | Choice Group: This is a repeating choice group that does not appear directly in the instance Constraints: EN-1 |
![]() ![]() ![]() ![]() |
1..1 | |||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..1 | st | Allows for mixed text content | |
![]() ![]() ![]() |
0..1 | IVL_TS | ||
![]() |
Path | Status | Usage | ValueSet | Version | Source |
PN.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
PN.use | Base | required | CDAEntityNameUse | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Id | Grade | Path(s) | Description | Expression |
81-9371 | error | PN | 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 | error | PN | 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()
|
EN-1 | error | PN.item | Can only have only one of the possible item elements in each choice |
(delimiter | family | given | prefix | suffix | xmlText).count() = 1
|
pn-no-ls | error | PN | 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()
|
Snapshot View
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
C | 1..* | PN | XML Namespace: urn:hl7-org:v3 Base for all types and resources Logical Container: ClinicalDocument (CDA Class) Constraints: pn-no-ls, 81-9371, 81-9372 |
![]() ![]() ![]() |
0..1 | cs | Binding: CDANullFlavor (required) | |
![]() ![]() ![]() |
0..* | cs | Binding: CDAEntityNameUse (required) | |
![]() ![]() ![]() |
C | 1..* | Base | Choice Group: This is a repeating choice group that does not appear directly in the instance Constraints: EN-1 |
![]() ![]() ![]() ![]() |
1..1 | |||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..* | ENXP | ||
![]() ![]() ![]() ![]() ![]() |
0..1 | st | Allows for mixed text content | |
![]() ![]() ![]() |
0..1 | IVL_TS | ||
![]() |
Path | Status | Usage | ValueSet | Version | Source |
PN.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
PN.use | Base | required | CDAEntityNameUse | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Id | Grade | Path(s) | Description | Expression |
81-9371 | error | PN | 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 | error | PN | 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()
|
EN-1 | error | PN.item | Can only have only one of the possible item elements in each choice |
(delimiter | family | given | prefix | suffix | xmlText).count() = 1
|
pn-no-ls | error | PN | 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()
|
This structure is derived from PN