Clinical Document Architecture
2.0.1-sd - release

Clinical Document Architecture, published by Health Level 7. This guide is not an authorized publication; it is the continuous build for version 2.0.1-sd built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-core-sd/ and changes regularly. See the Directory of published versions

Logical Model: PN: PersonName (V3 Data Type)

Official URL: http://hl7.org/cda/stds/core/StructureDefinition/PN Version: 2.0.1-sd
Active as of 2025-10-02 Computable Name: PN

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).

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Template Content

Description of Template, Differentials, Snapshots and how the different presentations work.

This structure is derived from EN

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PN C 1..* EN XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, @use, item, validTime
Logical Container: ClinicalDocument (CDA Class)
Constraints: pn-no-ls
... item 0..* Base

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
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()
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PN C 1..* EN XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, @use, item, validTime
Logical Container: ClinicalDocument (CDA Class)
Constraints: pn-no-ls
... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
... @use 0..* cs Binding: CDAEntityNameUse (required)
... item C 0..* Base Choice Group: This is a repeating choice group that does not appear directly in the instance
Constraints: EN-1
.... (Choice of one) 1..1
..... delimiter 0..* ENXP
..... family 0..* ENXP
..... given 0..* ENXP
..... prefix 0..* ENXP
..... suffix 0..* ENXP
..... xmlText 0..1 st Allows for mixed text content

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PN.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
PN.use Base required CDAEntityNameUse 📦2.0.1-sd This IG

Constraints

Id Grade Path(s) Description Expression
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()
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PN C 1..* EN XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, @use, item, validTime
Logical Container: ClinicalDocument (CDA Class)
Constraints: pn-no-ls
... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
... @use 0..* cs Binding: CDAEntityNameUse (required)
... item C 0..* Base Choice Group: This is a repeating choice group that does not appear directly in the instance
Constraints: EN-1
.... (Choice of one) 1..1
..... delimiter 0..* ENXP
..... family 0..* ENXP
..... given 0..* ENXP
..... prefix 0..* ENXP
..... suffix 0..* ENXP
..... xmlText 0..1 st Allows for mixed text content

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PN.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
PN.use Base required CDAEntityNameUse 📦2.0.1-sd This IG

Constraints

Id Grade Path(s) Description Expression
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 EN

Summary

Differential View

This structure is derived from EN

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PN C 1..* EN XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, @use, item, validTime
Logical Container: ClinicalDocument (CDA Class)
Constraints: pn-no-ls
... item 0..* Base

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
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()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PN C 1..* EN XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, @use, item, validTime
Logical Container: ClinicalDocument (CDA Class)
Constraints: pn-no-ls
... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
... @use 0..* cs Binding: CDAEntityNameUse (required)
... item C 0..* Base Choice Group: This is a repeating choice group that does not appear directly in the instance
Constraints: EN-1
.... (Choice of one) 1..1
..... delimiter 0..* ENXP
..... family 0..* ENXP
..... given 0..* ENXP
..... prefix 0..* ENXP
..... suffix 0..* ENXP
..... xmlText 0..1 st Allows for mixed text content

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PN.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
PN.use Base required CDAEntityNameUse 📦2.0.1-sd This IG

Constraints

Id Grade Path(s) Description Expression
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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PN C 1..* EN XML Namespace: urn:hl7-org:v3
Base for all types and resources

Elements defined in Ancestors:@nullFlavor, @use, item, validTime
Logical Container: ClinicalDocument (CDA Class)
Constraints: pn-no-ls
... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
... @use 0..* cs Binding: CDAEntityNameUse (required)
... item C 0..* Base Choice Group: This is a repeating choice group that does not appear directly in the instance
Constraints: EN-1
.... (Choice of one) 1..1
..... delimiter 0..* ENXP
..... family 0..* ENXP
..... given 0..* ENXP
..... prefix 0..* ENXP
..... suffix 0..* ENXP
..... xmlText 0..1 st Allows for mixed text content

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PN.nullFlavor Base required CDANullFlavor 📦2.0.1-sd This IG
PN.use Base required CDAEntityNameUse 📦2.0.1-sd This IG

Constraints

Id Grade Path(s) Description Expression
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 EN

Summary

 

Other representations of profile: CSV, Excel