Consolidated CDA (C-CDA)
4.0.0 - STU4 United States of America flag

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

Logical Model: US Realm Person Name (PN.US.FIELDED)

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:

  • New Content
  • Formal Views of Template Content

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

    This structure is derived from PN

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. PN 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

    doco Documentation for this format

    Constraints

    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()
    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. PN 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
    ... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ... @use 0..* cs Binding: CDAEntityNameUse (required)
    ... item C 1..* 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 Clinical Document Architecture v2.0
    PN.use Base required CDAEntityNameUse 📦2.0.1-sd Clinical Document Architecture v2.0

    Constraints

    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()
    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. PN 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
    ... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ... @use 0..* cs Binding: CDAEntityNameUse (required)
    ... item C 1..* 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 Clinical Document Architecture v2.0
    PN.use Base required CDAEntityNameUse 📦2.0.1-sd Clinical Document Architecture v2.0

    Constraints

    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

    Summary

    Differential View

    This structure is derived from PN

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. PN 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

    doco Documentation for this format

    Constraints

    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

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. PN 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
    ... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ... @use 0..* cs Binding: CDAEntityNameUse (required)
    ... item C 1..* 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 Clinical Document Architecture v2.0
    PN.use Base required CDAEntityNameUse 📦2.0.1-sd Clinical Document Architecture v2.0

    Constraints

    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

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. PN 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
    ... @nullFlavor 0..1 cs Binding: CDANullFlavor (required)
    ... @use 0..* cs Binding: CDAEntityNameUse (required)
    ... item C 1..* 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 Clinical Document Architecture v2.0
    PN.use Base required CDAEntityNameUse 📦2.0.1-sd Clinical Document Architecture v2.0

    Constraints

    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

    Summary

     

    Other representations of profile: CSV, Excel