3.34.9 StructureDefinition: Shared Health HumanName - XML Profile
XML representation of the dtprofile-humanname Profile.
Narrative view of the profile
<StructureDefinition xmlns="http://hl7.org/fhir">
<id value="dtprofile-humanname"/>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml"><table border="0" cellpadding="0" cellspacing="0" style="border: 0px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top;"><tr style="border: 1px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top"><th style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a href="http://hl7.org/fhir/2016may/formats.html#table" title="The logical name of the element">Name</a></th><th style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a href="http://hl7.org/fhir/2016may/formats.html#table" title="Information about the use of the element">Flags</a></th><th style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a href="http://hl7.org/fhir/2016may/formats.html#table" title="Minimum and Maximum # of times the the element can appear in the instance">Card.</a></th><th style="width: 100px" class="hierarchy"><a href="http://hl7.org/fhir/2016may/formats.html#table" title="Reference to the type of the element">Type</a></th><th style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a href="http://hl7.org/fhir/2016may/formats.html#table" title="Additional information about the element">Description & Constraints</a><span style="float: right"><a href="http://hl7.org/fhir/2016may/formats.html#table" title="Legend for this format"><img src="http://hl7.org/fhir/2016may/help16.png" alt="doco" style="background-color: inherit"/></a></span></th></tr><tr style="border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white"><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck1.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="icon_element.gif" alt="." style="background-color: white; background-color: inherit" title="Element" class="hierarchy"/> <a href="dtprofile-humanname-definitions.html#HumanName">HumanName</a><a name="HumanName"> </a></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"/><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="opacity: 0.5">0</span><span style="opacity: 0.5">..</span><span style="opacity: 0.5">*</span></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a href="http://hl7.org/fhir/2016may/datatypes.html#HumanName">HumanName</a></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="opacity: 0.5">Name of a human - parts and usage</span></td></tr>
<tr style="border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7"><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vjoin.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="icon_element.gif" alt="." style="background-color: #F7F7F7; background-color: inherit" title="Element" class="hierarchy"/> <a href="dtprofile-humanname-definitions.html#HumanName.use">use</a><a name="HumanName.use"> </a></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="padding-left: 3px; padding-right: 3px; color: white; background-color: red" title="This element must be supported">S</span></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy">1..<span style="opacity: 0.5">1</span></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a style="opacity: 0.5" href="http://hl7.org/fhir/2016may/datatypes.html#code">code</a></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy">official | usual<br/><span style="font-weight:bold">Binding: </span><a href="https://tgateway.infoway-inforoute.ca/vs/sharednameuse?versionid=20190415">SharedNameUse (20190415)</a> (<a href="http://hl7.org/fhir/2016may/terminologies.html#required" title="To be conformant, the concept in this element SHALL be from the specified value set.">required</a>)</td></tr>
<tr style="border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white"><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vjoin.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="icon_element.gif" alt="." style="background-color: white; background-color: inherit" title="Element" class="hierarchy"/> <a href="dtprofile-humanname-definitions.html#HumanName.family">family</a><a name="HumanName.family"> </a></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="padding-left: 3px; padding-right: 3px; color: white; background-color: red" title="This element must be supported">S</span></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy">1..1</td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a style="opacity: 0.5" href="http://hl7.org/fhir/2016may/datatypes.html#string">string</a></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="opacity: 0.5">Family name (often called 'Surname')</span></td></tr>
<tr style="border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7"><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vjoin.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="icon_element.gif" alt="." style="background-color: #F7F7F7; background-color: inherit" title="Element" class="hierarchy"/> <a href="dtprofile-humanname-definitions.html#HumanName.given">given</a><a name="HumanName.given"> </a></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="padding-left: 3px; padding-right: 3px; color: white; background-color: red" title="This element must be supported">S</span></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy">1..2</td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a style="opacity: 0.5" href="http://hl7.org/fhir/2016may/datatypes.html#string">string</a></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="opacity: 0.5">Given names (not always 'first'). Includes middle names</span></td></tr>
<tr style="border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white"><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vjoin.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="icon_element.gif" alt="." style="background-color: white; background-color: inherit" title="Element" class="hierarchy"/> <a href="dtprofile-humanname-definitions.html#HumanName.prefix">prefix</a><a name="HumanName.prefix"> </a></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="padding-left: 3px; padding-right: 3px; color: white; background-color: red" title="This element must be supported">S</span></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy">0..1</td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a style="opacity: 0.5" href="http://hl7.org/fhir/2016may/datatypes.html#string">string</a></td><td style="vertical-align: top; text-align : left; background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="opacity: 0.5">Parts that come before the name</span></td></tr>
<tr style="border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7"><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck00.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vjoin_end.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="icon_element.gif" alt="." style="background-color: #F7F7F7; background-color: inherit" title="Element" class="hierarchy"/> <a href="dtprofile-humanname-definitions.html#HumanName.suffix">suffix</a><a name="HumanName.suffix"> </a></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="padding-left: 3px; padding-right: 3px; color: white; background-color: red" title="This element must be supported">S</span></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy">0..1</td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><a style="opacity: 0.5" href="http://hl7.org/fhir/2016may/datatypes.html#string">string</a></td><td style="vertical-align: top; text-align : left; background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px" class="hierarchy"><span style="opacity: 0.5">Parts that come after the name</span></td></tr>
<tr><td colspan="5" class="hierarchy"><br/><a href="http://hl7.org/fhir/2016may/formats.html#table" title="Legend for this format"><img src="http://hl7.org/fhir/2016may/help16.png" alt="doco" style="background-color: inherit"/> Documentation for this format</a></td></tr></table></div>
</text>
<url
value="http://sharedhealth.exchange/fhir/StructureDefinition/dtprofile-humanname"/>
<version value="5.0"/>
<name value="Shared Health HumanName"/>
<status value="draft"/>
<date value="2015-09-22T06:02:49-04:00"/>
<description value="Common constraints for human names"/>
<fhirVersion value="1.4.0"/>
<mapping>
<identity value="v2"/>
<uri value="http://hl7.org/v2"/>
<name value="HL7 v2"/>
</mapping>
<mapping>
<identity value="rim"/>
<uri value="http://hl7.org/v3"/>
<name value="RIM"/>
</mapping>
<mapping>
<identity value="servd"/>
<uri value="http://www.omg.org/spec/ServD/1.0/"/>
<name value="ServD"/>
</mapping>
<kind value="datatype"/>
<abstract value="false"/>
<baseType value="HumanName"/>
<baseDefinition value="http://hl7.org/fhir/StructureDefinition/HumanName"/>
<derivation value="constraint"/>
<snapshot>
<element id="HumanName">
<path value="HumanName"/>
<short value="Name of a human - parts and usage"/>
<definition
value="A human's name with the ability to identify parts and usage."/>
<comments
value="This data type is used to support both Practitioner names and Patient names. These name values are used for SAML validation (Practitioner) and eFax generation, and possibly patient matching algorithms.
Conformance Rule: For the purpose of presentation, the data elements will be organized as Prefix + Given1 + Given2 + Family + Suffix."/>
<min value="0"/>
<max value="*"/>
<base>
<path value="HumanName"/>
<min value="0"/>
<max value="*"/>
</base>
<maxLength value="0"/>
<mustSupport value="false"/>
<isModifier value="false"/>
<isSummary value="false"/>
<mapping>
<identity value="v2"/>
<map value="XPN"/>
</mapping>
<mapping>
<identity value="rim"/>
<map value="EN (actually, PN)"/>
</mapping>
<mapping>
<identity value="servd"/>
<map value="ProviderName"/>
</mapping>
</element>
<element id="HumanName.id">
<path value="HumanName.id"/>
<representation value="xmlAttr"/>
<short value="xml:id (or equivalent in JSON)"/>
<definition
value="unique id for the element within a resource (for internal references)."/>
<min value="0"/>
<max value="1"/>
<base>
<path value="Element.id"/>
<min value="0"/>
<max value="*"/>
</base>
<type>
<code value="id"/>
</type>
<maxLength value="0"/>
<mustSupport value="false"/>
<isModifier value="false"/>
<isSummary value="false"/>
<mapping>
<identity value="rim"/>
<map value="n/a"/>
</mapping>
</element>
<element id="HumanName.extension">
<path value="HumanName.extension"/>
<short value="Additional Content defined by implementations"/>
<definition
value="May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension."/>
<comments
value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone."/>
<alias value="extensions"/>
<alias value="user content"/>
<min value="0"/>
<max value="*"/>
<base>
<path value="Element.extension"/>
<min value="0"/>
<max value="*"/>
</base>
<type>
<code value="Extension"/>
</type>
<maxLength value="0"/>
<mustSupport value="false"/>
<isModifier value="false"/>
<isSummary value="false"/>
<mapping>
<identity value="rim"/>
<map value="n/a"/>
</mapping>
</element>
<element id="HumanName.use">
<path value="HumanName.use"/>
<short value="official | usual"/>
<definition value="Identifies the purpose for this name."/>
<comments
value="This is labeled as "Is Modifier" because applications should not mistake a temporary or old name etc.for a current/permanent one. Applications can assume that a name is current unless it explicitly says that it is temporary or old."/>
<requirements
value="Allows the appropriate name for a particular context of use to be selected from among a set of names."/>
<min value="1"/>
<max value="1"/>
<base>
<path value="HumanName.use"/>
<min value="0"/>
<max value="1"/>
</base>
<type>
<code value="code"/>
</type>
<maxLength value="0"/>
<mustSupport value="true"/>
<isModifier value="true"/>
<isSummary value="true"/>
<binding>
<strength value="required"/>
<valueSetReference>
<reference
value="https://fhir.infoway-inforoute.ca/ValueSet/sharednameuse|20190415"/>
</valueSetReference>
</binding>
<mapping>
<identity value="v2"/>
<map value="XPN.7, but often indicated by which field contains the name"/>
</mapping>
<mapping>
<identity value="rim"/>
<map value="unique(./use)"/>
</mapping>
<mapping>
<identity value="servd"/>
<map value="./NamePurpose"/>
</mapping>
</element>
<element id="HumanName.text">
<path value="HumanName.text"/>
<short value="Text representation of the full name"/>
<definition value="A full text representation of the name."/>
<comments
value="Can provide both a text representation and structured parts."/>
<requirements value="A renderable, unencoded form."/>
<min value="0"/>
<max value="1"/>
<base>
<path value="HumanName.text"/>
<min value="0"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
<maxLength value="0"/>
<mustSupport value="false"/>
<isModifier value="false"/>
<isSummary value="true"/>
<mapping>
<identity value="v2"/>
<map value="implied by XPN.11"/>
</mapping>
<mapping>
<identity value="rim"/>
<map value="./formatted"/>
</mapping>
</element>
<element id="HumanName.family">
<path value="HumanName.family"/>
<short value="Family name (often called 'Surname')"/>
<definition
value="The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father."/>
<comments
value="Conformance rule: Family is not to include professional designations"/>
<alias value="surname"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="HumanName.family"/>
<min value="0"/>
<max value="*"/>
</base>
<type>
<code value="string"/>
</type>
<maxLength value="0"/>
<mustSupport value="true"/>
<isModifier value="false"/>
<isSummary value="true"/>
<mapping>
<identity value="v2"/>
<map value="XPN.1"/>
</mapping>
<mapping>
<identity value="rim"/>
<map value="./part[partType = FAM]"/>
</mapping>
<mapping>
<identity value="servd"/>
<map value="./FamilyName"/>
</mapping>
</element>
<element id="HumanName.given">
<path value="HumanName.given"/>
<short
value="Given names (not always 'first'). Includes middle names"/>
<definition value="Given name."/>
<comments
value="Conformance Rule: Given name(s) is not to include profession designations"/>
<alias value="first name"/>
<alias value="middle name"/>
<min value="1"/>
<max value="2"/>
<base>
<path value="HumanName.given"/>
<min value="0"/>
<max value="*"/>
</base>
<type>
<code value="string"/>
</type>
<maxLength value="0"/>
<mustSupport value="true"/>
<isModifier value="false"/>
<isSummary value="true"/>
<mapping>
<identity value="v2"/>
<map value="XPN.2 + XPN.3"/>
</mapping>
<mapping>
<identity value="rim"/>
<map value="./part[partType = GIV]"/>
</mapping>
<mapping>
<identity value="servd"/>
<map value="./GivenNames"/>
</mapping>
</element>
<element id="HumanName.prefix">
<path value="HumanName.prefix"/>
<short value="Parts that come before the name"/>
<definition
value="Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the start of the name."/>
<comments
value="Conformance Rule: Prefix or Suffix must be used for Practitioner to represent the appropriate professional designation."/>
<min value="0"/>
<max value="1"/>
<base>
<path value="HumanName.prefix"/>
<min value="0"/>
<max value="*"/>
</base>
<type>
<code value="string"/>
</type>
<maxLength value="0"/>
<mustSupport value="true"/>
<isModifier value="false"/>
<isSummary value="true"/>
<mapping>
<identity value="v2"/>
<map value="XPN.5"/>
</mapping>
<mapping>
<identity value="rim"/>
<map value="./part[partType = PFX]"/>
</mapping>
<mapping>
<identity value="servd"/>
<map value="./TitleCode"/>
</mapping>
</element>
<element id="HumanName.suffix">
<path value="HumanName.suffix"/>
<short value="Parts that come after the name"/>
<definition
value="Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the end of the name."/>
<comments
value="Conformance Rule: Prefix or Suffix must be used for Practitioner to represent the appropriate professional designation."/>
<min value="0"/>
<max value="1"/>
<base>
<path value="HumanName.suffix"/>
<min value="0"/>
<max value="*"/>
</base>
<type>
<code value="string"/>
</type>
<maxLength value="0"/>
<mustSupport value="true"/>
<isModifier value="false"/>
<isSummary value="true"/>
<mapping>
<identity value="v2"/>
<map value="XPN/4"/>
</mapping>
<mapping>
<identity value="rim"/>
<map value="./part[partType = SFX]"/>
</mapping>
</element>
<element id="HumanName.period">
<path value="HumanName.period"/>
<short value="Time period when name was/is in use"/>
<definition
value="Indicates the period of time when this name was valid for the named person."/>
<requirements value="Allows names to be placed in historical context."/>
<min value="0"/>
<max value="1"/>
<base>
<path value="HumanName.period"/>
<min value="0"/>
<max value="1"/>
</base>
<type>
<code value="Period"/>
</type>
<maxLength value="0"/>
<mustSupport value="false"/>
<isModifier value="false"/>
<isSummary value="true"/>
<mapping>
<identity value="v2"/>
<map value="XPN.13 + XPN.14"/>
</mapping>
<mapping>
<identity value="rim"/>
<map value="./usablePeriod[type="IVL<TS>"]"/>
</mapping>
<mapping>
<identity value="servd"/>
<map value="./StartDate and ./EndDate"/>
</mapping>
</element>
</snapshot>
<differential>
<element id="HumanName">
<path value="HumanName"/>
<comments
value="This data type is used to support both Practitioner names and Patient names. These name values are used for SAML validation (Practitioner) and eFax generation, and possibly patient matching algorithms.
Conformance Rule: For the purpose of presentation, the data elements will be organized as Prefix + Given1 + Given2 + Family + Suffix."/>
</element>
<element id="HumanName.use">
<path value="HumanName.use"/>
<short value="official | usual"/>
<min value="1"/>
<mustSupport value="true"/>
<binding>
<strength value="required"/>
<valueSetReference>
<reference
value="https://fhir.infoway-inforoute.ca/ValueSet/sharednameuse|20190415"/>
</valueSetReference>
</binding>
</element>
<element id="HumanName.family">
<path value="HumanName.family"/>
<comments
value="Conformance rule: Family is not to include professional designations"/>
<min value="1"/>
<max value="1"/>
<mustSupport value="true"/>
</element>
<element id="HumanName.given">
<path value="HumanName.given"/>
<comments
value="Conformance Rule: Given name(s) is not to include profession designations"/>
<min value="1"/>
<max value="2"/>
<mustSupport value="true"/>
</element>
<element id="HumanName.prefix">
<path value="HumanName.prefix"/>
<comments
value="Conformance Rule: Prefix or Suffix must be used for Practitioner to represent the appropriate professional designation."/>
<min value="0"/>
<max value="1"/>
<mustSupport value="true"/>
</element>
<element id="HumanName.suffix">
<path value="HumanName.suffix"/>
<comments
value="Conformance Rule: Prefix or Suffix must be used for Practitioner to represent the appropriate professional designation."/>
<min value="0"/>
<max value="1"/>
<mustSupport value="true"/>
</element>
</differential>
</StructureDefinition>