Consolidated CDA
3.0.0-ballot - ballot United States of America flag

This page is part of the CCDA: Consolidated CDA Release (v3.0.0-ballot: CCDA 3.0 Ballot 1) based on FHIR (HL7® FHIR® Standard) v5.0.0. . For a full list of available versions, see the Directory of published versions

Logical Model: US Realm Patient Name (PTN.US.FIELDED)

Official URL: http://hl7.org/cda/us/ccda/StructureDefinition/USRealmPatientNamePTNUSFIELDED Version: 3.0.0-ballot
Draft as of 2023-12-21 Computable Name: USRealmPatientNamePTNUSFIELDED
Other Identifiers: id: urn:oid:2.16.840.1.113883.10.20.22.5.1

The US Realm Patient Name datatype flavor is a set of reusable constraints that can be used for the patient or any other person. It requires a first (given) and last (family) name. If a patient or person has only one name part (e.g., patient with first name only) place the name part in the field required by the organization. Use the appropriate nullFlavor, “Not Applicable” (NA), in the other field.

For information on mixed content see the Extensible Markup Language reference (http://www.w3c.org/TR/2008/REC-xml-20081126/).

Usage:

Formal Views of Profile Content

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

This structure is derived from PN

NameFlagsCard.TypeDescription & Constraintsdoco
.. PN C1..*PNXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, @use, item, validTime, item
Base for all types and resources
Logical Container: ClinicalDocument (CDA Class)
shall-family: SHALL contain exactly one [1..1] family (CONF:81-7159).
shall-given: SHALL contain at least one [1..*] given (CONF:81-7157).
shall-max-suffix: There may be at most one suffix
81-7278: **SHALL NOT** have mixed content except for white space (CONF:81-7278).
... @use 0..1csIf name/@nullFlavor is present, the remaining conformance statements *SHALL NOT* be enforced
... item
.... family 0..*ENXP(USCDI) Last Name
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... given 0..*ENXP(USCDI) First Name / Middle Name
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... prefix 0..*ENXP
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... suffix 0..*ENXP(USCDI) Suffix
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
... validTime 0..1IVL_TS(USCDI) Previous Name - Available for use to identify the time period when name was/is in use.

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
PN.item.family.qualifierrequiredEntityPersonNamePartQualifier
PN.item.given.qualifierrequiredEntityPersonNamePartQualifier
PN.item.prefix.qualifierrequiredEntityPersonNamePartQualifier
PN.item.suffix.qualifierrequiredEntityPersonNamePartQualifier

Constraints

IdGradePath(s)DetailsRequirements
81-7278errorPN**SHALL NOT** have mixed content except for white space (CONF:81-7278).
: item.xmlText.empty()
shall-familyerrorPNSHALL contain exactly one [1..1] family (CONF:81-7159).
: nullFlavor.exists() or item.family.count() = 1
shall-givenerrorPNSHALL contain at least one [1..*] given (CONF:81-7157).
: nullFlavor.exists() or item.given.exists()
shall-max-suffixerrorPNThere may be at most one suffix
: (item.suffix.empty() or item.suffix.count() = 1)
NameFlagsCard.TypeDescription & Constraintsdoco
.. PN C1..*PNXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, @use, item, validTime, item
Base for all types and resources
Logical Container: ClinicalDocument (CDA Class)
shall-family: SHALL contain exactly one [1..1] family (CONF:81-7159).
shall-given: SHALL contain at least one [1..*] given (CONF:81-7157).
shall-max-suffix: There may be at most one suffix
81-7278: **SHALL NOT** have mixed content except for white space (CONF:81-7278).
... @use 0..1csIf name/@nullFlavor is present, the remaining conformance statements *SHALL NOT* be enforced
Binding: CDAEntityNameUse (required)
... item C1..*BaseChoice Group: This is a repeating choice group that does not appear directly in the instance
.... family 0..*ENXP(USCDI) Last Name
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... given 0..*ENXP(USCDI) First Name / Middle Name
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... prefix 0..*ENXP
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... suffix 0..*ENXP(USCDI) Suffix
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
... validTime 0..1IVL_TS(USCDI) Previous Name - Available for use to identify the time period when name was/is in use.

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
PN.userequiredCDAEntityNameUse
PN.item.family.qualifierrequiredEntityPersonNamePartQualifier
PN.item.given.qualifierrequiredEntityPersonNamePartQualifier
PN.item.prefix.qualifierrequiredEntityPersonNamePartQualifier
PN.item.suffix.qualifierrequiredEntityPersonNamePartQualifier

Constraints

IdGradePath(s)DetailsRequirements
81-7278errorPN**SHALL NOT** have mixed content except for white space (CONF:81-7278).
: item.xmlText.empty()
EN-1errorPN.itemCan only have only one of the possible item elements in each choice
: (delimiter | family | given | prefix | suffix | xmlText).count() = 1
pn-no-lserrorPNNo 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()
shall-familyerrorPNSHALL contain exactly one [1..1] family (CONF:81-7159).
: nullFlavor.exists() or item.family.count() = 1
shall-givenerrorPNSHALL contain at least one [1..*] given (CONF:81-7157).
: nullFlavor.exists() or item.given.exists()
shall-max-suffixerrorPNThere may be at most one suffix
: (item.suffix.empty() or item.suffix.count() = 1)
NameFlagsCard.TypeDescription & Constraintsdoco
.. PN C1..*PNXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, @use, item, validTime, item
Base for all types and resources
Logical Container: ClinicalDocument (CDA Class)
shall-family: SHALL contain exactly one [1..1] family (CONF:81-7159).
shall-given: SHALL contain at least one [1..*] given (CONF:81-7157).
shall-max-suffix: There may be at most one suffix
81-7278: **SHALL NOT** have mixed content except for white space (CONF:81-7278).
... @nullFlavor 0..1csBinding: CDANullFlavor (required)
... @use 0..1csIf name/@nullFlavor is present, the remaining conformance statements *SHALL NOT* be enforced
Binding: CDAEntityNameUse (required)
... item C1..*BaseChoice Group: This is a repeating choice group that does not appear directly in the instance
.... (Choice of one) 1..1
..... delimiter 0..*ENXP
..... family 0..*ENXP(USCDI) Last Name
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @representation 0..1csFixed Value: TXT
...... @mediaType 0..1csFixed Value: text/plain
...... @language 0..1cs
...... xmlText 0..1stAllows for mixed text content
...... @partType 0..1csBinding: EntityNamePartType (required)
...... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
..... given 0..*ENXP(USCDI) First Name / Middle Name
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @representation 0..1csFixed Value: TXT
...... @mediaType 0..1csFixed Value: text/plain
...... @language 0..1cs
...... xmlText 0..1stAllows for mixed text content
...... @partType 0..1csBinding: EntityNamePartType (required)
...... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
..... prefix 0..*ENXP
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @representation 0..1csFixed Value: TXT
...... @mediaType 0..1csFixed Value: text/plain
...... @language 0..1cs
...... xmlText 0..1stAllows for mixed text content
...... @partType 0..1csBinding: EntityNamePartType (required)
...... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
..... suffix 0..*ENXP(USCDI) Suffix
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @representation 0..1csFixed Value: TXT
...... @mediaType 0..1csFixed Value: text/plain
...... @language 0..1cs
...... xmlText 0..1stAllows for mixed text content
...... @partType 0..1csBinding: EntityNamePartType (required)
...... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
..... xmlText 0..1stAllows for mixed text content

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
PN.nullFlavorrequiredCDANullFlavor
PN.userequiredCDAEntityNameUse
PN.item.family.nullFlavorrequiredCDANullFlavor
PN.item.family.partTyperequiredEntityNamePartType
PN.item.family.qualifierrequiredEntityPersonNamePartQualifier
PN.item.given.nullFlavorrequiredCDANullFlavor
PN.item.given.partTyperequiredEntityNamePartType
PN.item.given.qualifierrequiredEntityPersonNamePartQualifier
PN.item.prefix.nullFlavorrequiredCDANullFlavor
PN.item.prefix.partTyperequiredEntityNamePartType
PN.item.prefix.qualifierrequiredEntityPersonNamePartQualifier
PN.item.suffix.nullFlavorrequiredCDANullFlavor
PN.item.suffix.partTyperequiredEntityNamePartType
PN.item.suffix.qualifierrequiredEntityPersonNamePartQualifier

Constraints

IdGradePath(s)DetailsRequirements
81-7278errorPN**SHALL NOT** have mixed content except for white space (CONF:81-7278).
: item.xmlText.empty()
EN-1errorPN.itemCan only have only one of the possible item elements in each choice
: (delimiter | family | given | prefix | suffix | xmlText).count() = 1
pn-no-lserrorPNNo 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()
shall-familyerrorPNSHALL contain exactly one [1..1] family (CONF:81-7159).
: nullFlavor.exists() or item.family.count() = 1
shall-givenerrorPNSHALL contain at least one [1..*] given (CONF:81-7157).
: nullFlavor.exists() or item.given.exists()
shall-max-suffixerrorPNThere may be at most one suffix
: (item.suffix.empty() or item.suffix.count() = 1)

This structure is derived from PN

Summary

Differential View

This structure is derived from PN

NameFlagsCard.TypeDescription & Constraintsdoco
.. PN C1..*PNXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, @use, item, validTime, item
Base for all types and resources
Logical Container: ClinicalDocument (CDA Class)
shall-family: SHALL contain exactly one [1..1] family (CONF:81-7159).
shall-given: SHALL contain at least one [1..*] given (CONF:81-7157).
shall-max-suffix: There may be at most one suffix
81-7278: **SHALL NOT** have mixed content except for white space (CONF:81-7278).
... @use 0..1csIf name/@nullFlavor is present, the remaining conformance statements *SHALL NOT* be enforced
... item
.... family 0..*ENXP(USCDI) Last Name
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... given 0..*ENXP(USCDI) First Name / Middle Name
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... prefix 0..*ENXP
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... suffix 0..*ENXP(USCDI) Suffix
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
... validTime 0..1IVL_TS(USCDI) Previous Name - Available for use to identify the time period when name was/is in use.

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
PN.item.family.qualifierrequiredEntityPersonNamePartQualifier
PN.item.given.qualifierrequiredEntityPersonNamePartQualifier
PN.item.prefix.qualifierrequiredEntityPersonNamePartQualifier
PN.item.suffix.qualifierrequiredEntityPersonNamePartQualifier

Constraints

IdGradePath(s)DetailsRequirements
81-7278errorPN**SHALL NOT** have mixed content except for white space (CONF:81-7278).
: item.xmlText.empty()
shall-familyerrorPNSHALL contain exactly one [1..1] family (CONF:81-7159).
: nullFlavor.exists() or item.family.count() = 1
shall-givenerrorPNSHALL contain at least one [1..*] given (CONF:81-7157).
: nullFlavor.exists() or item.given.exists()
shall-max-suffixerrorPNThere may be at most one suffix
: (item.suffix.empty() or item.suffix.count() = 1)

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. PN C1..*PNXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, @use, item, validTime, item
Base for all types and resources
Logical Container: ClinicalDocument (CDA Class)
shall-family: SHALL contain exactly one [1..1] family (CONF:81-7159).
shall-given: SHALL contain at least one [1..*] given (CONF:81-7157).
shall-max-suffix: There may be at most one suffix
81-7278: **SHALL NOT** have mixed content except for white space (CONF:81-7278).
... @use 0..1csIf name/@nullFlavor is present, the remaining conformance statements *SHALL NOT* be enforced
Binding: CDAEntityNameUse (required)
... item C1..*BaseChoice Group: This is a repeating choice group that does not appear directly in the instance
.... family 0..*ENXP(USCDI) Last Name
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... given 0..*ENXP(USCDI) First Name / Middle Name
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... prefix 0..*ENXP
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
.... suffix 0..*ENXP(USCDI) Suffix
..... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
... validTime 0..1IVL_TS(USCDI) Previous Name - Available for use to identify the time period when name was/is in use.

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
PN.userequiredCDAEntityNameUse
PN.item.family.qualifierrequiredEntityPersonNamePartQualifier
PN.item.given.qualifierrequiredEntityPersonNamePartQualifier
PN.item.prefix.qualifierrequiredEntityPersonNamePartQualifier
PN.item.suffix.qualifierrequiredEntityPersonNamePartQualifier

Constraints

IdGradePath(s)DetailsRequirements
81-7278errorPN**SHALL NOT** have mixed content except for white space (CONF:81-7278).
: item.xmlText.empty()
EN-1errorPN.itemCan only have only one of the possible item elements in each choice
: (delimiter | family | given | prefix | suffix | xmlText).count() = 1
pn-no-lserrorPNNo 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()
shall-familyerrorPNSHALL contain exactly one [1..1] family (CONF:81-7159).
: nullFlavor.exists() or item.family.count() = 1
shall-givenerrorPNSHALL contain at least one [1..*] given (CONF:81-7157).
: nullFlavor.exists() or item.given.exists()
shall-max-suffixerrorPNThere may be at most one suffix
: (item.suffix.empty() or item.suffix.count() = 1)

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. PN C1..*PNXML Namespace: urn:hl7-org:v3
Elements defined in Ancestors: @nullFlavor, @use, item, validTime, item
Base for all types and resources
Logical Container: ClinicalDocument (CDA Class)
shall-family: SHALL contain exactly one [1..1] family (CONF:81-7159).
shall-given: SHALL contain at least one [1..*] given (CONF:81-7157).
shall-max-suffix: There may be at most one suffix
81-7278: **SHALL NOT** have mixed content except for white space (CONF:81-7278).
... @nullFlavor 0..1csBinding: CDANullFlavor (required)
... @use 0..1csIf name/@nullFlavor is present, the remaining conformance statements *SHALL NOT* be enforced
Binding: CDAEntityNameUse (required)
... item C1..*BaseChoice Group: This is a repeating choice group that does not appear directly in the instance
.... (Choice of one) 1..1
..... delimiter 0..*ENXP
..... family 0..*ENXP(USCDI) Last Name
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @representation 0..1csFixed Value: TXT
...... @mediaType 0..1csFixed Value: text/plain
...... @language 0..1cs
...... xmlText 0..1stAllows for mixed text content
...... @partType 0..1csBinding: EntityNamePartType (required)
...... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
..... given 0..*ENXP(USCDI) First Name / Middle Name
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @representation 0..1csFixed Value: TXT
...... @mediaType 0..1csFixed Value: text/plain
...... @language 0..1cs
...... xmlText 0..1stAllows for mixed text content
...... @partType 0..1csBinding: EntityNamePartType (required)
...... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
..... prefix 0..*ENXP
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @representation 0..1csFixed Value: TXT
...... @mediaType 0..1csFixed Value: text/plain
...... @language 0..1cs
...... xmlText 0..1stAllows for mixed text content
...... @partType 0..1csBinding: EntityNamePartType (required)
...... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
..... suffix 0..*ENXP(USCDI) Suffix
...... @nullFlavor 0..1csBinding: CDANullFlavor (required)
...... @representation 0..1csFixed Value: TXT
...... @mediaType 0..1csFixed Value: text/plain
...... @language 0..1cs
...... xmlText 0..1stAllows for mixed text content
...... @partType 0..1csBinding: EntityNamePartType (required)
...... @qualifier 0..1csBinding: EntityPersonNamePartQualifier (required)
..... xmlText 0..1stAllows for mixed text content

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
PN.nullFlavorrequiredCDANullFlavor
PN.userequiredCDAEntityNameUse
PN.item.family.nullFlavorrequiredCDANullFlavor
PN.item.family.partTyperequiredEntityNamePartType
PN.item.family.qualifierrequiredEntityPersonNamePartQualifier
PN.item.given.nullFlavorrequiredCDANullFlavor
PN.item.given.partTyperequiredEntityNamePartType
PN.item.given.qualifierrequiredEntityPersonNamePartQualifier
PN.item.prefix.nullFlavorrequiredCDANullFlavor
PN.item.prefix.partTyperequiredEntityNamePartType
PN.item.prefix.qualifierrequiredEntityPersonNamePartQualifier
PN.item.suffix.nullFlavorrequiredCDANullFlavor
PN.item.suffix.partTyperequiredEntityNamePartType
PN.item.suffix.qualifierrequiredEntityPersonNamePartQualifier

Constraints

IdGradePath(s)DetailsRequirements
81-7278errorPN**SHALL NOT** have mixed content except for white space (CONF:81-7278).
: item.xmlText.empty()
EN-1errorPN.itemCan only have only one of the possible item elements in each choice
: (delimiter | family | given | prefix | suffix | xmlText).count() = 1
pn-no-lserrorPNNo 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()
shall-familyerrorPNSHALL contain exactly one [1..1] family (CONF:81-7159).
: nullFlavor.exists() or item.family.count() = 1
shall-givenerrorPNSHALL contain at least one [1..*] given (CONF:81-7157).
: nullFlavor.exists() or item.given.exists()
shall-max-suffixerrorPNThere may be at most one suffix
: (item.suffix.empty() or item.suffix.count() = 1)

This structure is derived from PN

Summary

 

Other representations of profile: CSV, Excel