<?xml-model href="http://hl7.org/fhir/STU3/structuredefinition.sch" type="application/xml" schematypens="http://purl.oclc.org/dsdl/schematron"?>
<StructureDefinition xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://hl7.org/fhir http://hl7.org/fhir/STU3/structuredefinition.xsd" xmlns="http://hl7.org/fhir">
  <id value="nl-core-humanname" />
  <meta>
    <versionId value="17" />
    <lastUpdated value="2018-02-20T12:56:38.08+01:00" />
  </meta>
  <url value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
  <version value="2.0.1" />
  <name value="nl core humanname" />
  <title value="nl-core-humanname" />
  <status value="active" />
  <date value="2015-09-22T12:02:49+02:00" />
  <publisher value="HL7 Netherlands" />
  <contact>
    <name value="Nictiz" />
    <telecom>
      <system value="email" />
      <value value="info@nictiz.nl" />
      <use value="work" />
    </telecom>
  </contact>
  <description value="Base datatype for HumanName Type with additions for Dutch realm names. Dutch names break down the family into maximum of 4 parts that are important to know separately in some if not most use cases." />
  <purpose value="Name information is used to identify and address person." />
  <copyright value="CC0" />
  <fhirVersion value="3.0.1" />
  <mapping>
    <identity value="hcim-nameinformation-v2.0.1-2015EN" />
    <uri value="https://zibs.nl/wiki/Patient-v2.0.1(2015EN)" />
    <name value="NameInformation as part of HCIM Patient-v2.0.1(2015EN)" />
    <comment value="NameInformation has become an independent information model as of release 2017 of the HCIMs" />
  </mapping>
  <mapping>
    <identity value="hcim-nameinformation-v3.0-2016EN" />
    <uri value="https://zibs.nl/wiki/Patient-v3.0(2016EN)" />
    <name value="NameInformation as part of HCIM Patient-v3.0(2016EN)" />
    <comment value="NameInformation has become an independent information model as of release 2017 of the HCIMs" />
  </mapping>
  <mapping>
    <identity value="hcim-nameinformation-v1.0.1-2017EN" />
    <uri value="https://zibs.nl/wiki/NameInformation-v1.0.1(2017EN)" />
    <name value="HCIM NameInformation-v1.0.1(2017EN)" />
  </mapping>
  <mapping>
    <identity value="BRP" />
    <uri value="https://nl.wikipedia.org/wiki/Basisregistratie_Personen" />
    <name value="Basisregistratie Personen" />
    <comment value="Voorheen GBA - Gemeentelijke basisregistratie" />
  </mapping>
  <kind value="complex-type" />
  <abstract value="false" />
  <type value="HumanName" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/HumanName" />
  <derivation value="constraint" />
  <differential>
    <element id="HumanName">
      <path value="HumanName" />
      <comment value="Names may be changed, or repudiated, or people may have different names in different contexts. Names may be divided into parts of different type that have variable significance depending on context, though the division into parts does not always matter. With personal names, the different parts may or may not be imbued with some implicit meaning; various cultures associate different importance with the name parts and the degree to which systems must care about name parts around the world varies widely.&#xD;&#xA;&#xD;&#xA;A Dutch HumanName is a proper FHIR HumanName. Systems that do not understand any of the extensions, will be able to render and work with a Dutch name. Dutch names make certain name parts seaprately communicable. These parts are required for use in true Dutch systems when dealing with Dutch names, but may not have value for international systems when information gets sent abroad.&#xD;&#xA;&#xD;&#xA;To have true compatibility an implementer SHOULD use the core HumanName parts as intended. To have names work for Dutch context, the implementer SHOULD in addition use the extension elements.&#xD;&#xA;&#xD;&#xA;The extension elements cover birth name (NL: eigennaam / geslachtsnaam) and partner/spouse name. Both may have a prefix (NL: voorvoegsel). When a person marries, he or she may keep their own name, assume the partner name, append the partner name to their own name, or the other way around.&#xD;&#xA;&#xD;&#xA;For this reason, there are extensions for marking each part for what it is. &#xD;&#xA;&#xD;&#xA;Example: miss Irma Jongeneel marries mister de Haas and assumes the name Irma Jongeneel-de Haas&#xD;&#xA;family = &quot;Jongeneel-de Haas&quot;&#xD;&#xA;given = &quot;Irma&quot;&#xD;&#xA;humanname-own-name = &quot;Jongeneel&quot;&#xD;&#xA;humanname-partner-prefix = &quot;de &quot;&#xD;&#xA;humanname-partner-name = &quot;Haas&quot;" />
      <example>
        <label value="Structured HumanName (preferred above unstructured)" />
        <valueHumanName>
          <extension url="http://hl7.org/fhir/StructureDefinition/humanname-assembly-order">
            <valueCode value="NL4" />
          </extension>
          <use value="official" />
          <family value="Jongeneel-de Haas">
            <extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
              <valueString value="Jongeneel" />
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/humanname-partner-prefix">
              <valueString value="de " />
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/humanname-partner-name">
              <valueString value="Haas" />
            </extension>
          </family>
          <given value="Irma">
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
              <valueCode value="CL" />
            </extension>
          </given>
          <given value="I.">
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
              <valueCode value="IN" />
            </extension>
          </given>
        </valueHumanName>
      </example>
      <example>
        <label value="Unstructured HumanName" />
        <valueHumanName>
          <use value="official" />
          <text value="Irma Jongeneel-de Haas" />
        </valueHumanName>
      </example>
      <constraint>
        <key value="nl-core-humanname-1" />
        <severity value="error" />
        <human value="if you specify a prefix for an own name then an own name is also expected" />
        <expression value="name.family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-prefix').empty().not() implies name.family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-name').empty().not()" />
        <xpath value="not(f:extension[@url='http://hl7.org/fhir/StructureDefinition/humanname-own-prefix']) or f:extension[@url='http://hl7.org/fhir/StructureDefinition/humanname-own-name']" />
      </constraint>
      <constraint>
        <key value="nl-core-humanname-2" />
        <severity value="error" />
        <human value="if you specify a voorvoegsel for a partner name then a partner name is also expected" />
        <expression value="name.family.extension('http://hl7.org/fhir/StructureDefinition/humanname-partner-prefix').empty().not() implies name.family.extension('http://hl7.org/fhir/StructureDefinition/humanname-partner-name').empty().not()" />
        <xpath value="not(f:extension[@url='http://hl7.org/fhir/StructureDefinition/humanname-partner-prefix']) or f:extension[@url='http://hl7.org/fhir/StructureDefinition/humanname-partner-name']" />
      </constraint>
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.6" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.6" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.1" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="02 Naam" />
      </mapping>
    </element>
    <element id="HumanName.extension">
      <path value="HumanName.extension" />
      <slicing>
        <discriminator>
          <type value="value" />
          <path value="url" />
        </discriminator>
        <rules value="open" />
      </slicing>
    </element>
    <element id="HumanName.extension:humannameAssemblyOrder">
      <path value="HumanName.extension" />
      <sliceName value="humannameAssemblyOrder" />
      <short value="Preferred display order of name parts" />
      <definition value="A code that represents the preferred display order of the components of this human name." />
      <alias value="Voorkeursvolgorde van de naamdelen." />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/humanname-assembly-order" />
      </type>
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.34" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.34" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.7" />
      </mapping>
    </element>
    <element id="HumanName.family">
      <path value="HumanName.family" />
      <short value="Surname" />
      <alias value="Achternaam" />
    </element>
    <element id="HumanName.family.extension">
      <path value="HumanName.family.extension" />
      <slicing>
        <discriminator>
          <type value="value" />
          <path value="url" />
        </discriminator>
        <rules value="open" />
      </slicing>
    </element>
    <element id="HumanName.family.extension:humannameOwnPrefix">
      <path value="HumanName.family.extension" />
      <sliceName value="humannameOwnPrefix" />
      <short value="PrefixOwnName" />
      <definition value="The prefix portion (e.g. voorvoegsel) inclusive of the space between the prefix and the surname, if applicable, of the family name that is derived from the person's own surname, as distinguished from any portion that is derived from the surname of the person's partner or spouse." />
      <comment value="An example of a voorvoegsel is the &quot;van&quot; in &quot;Ludwig van Beethoven&quot;. Since the voorvoegsel doesn't sort completely alphabetically, it is reasonable to specify it as a separate sub-component." />
      <alias value="VoorvoegselGeslachtsnaam" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/humanname-own-prefix" />
      </type>
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.38" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.38" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.11" />
      </mapping>
    </element>
    <element id="HumanName.family.extension:humannameOwnName">
      <path value="HumanName.family.extension" />
      <sliceName value="humannameOwnName" />
      <short value="OwnName" />
      <definition value="The person’s official last name." />
      <comment value="The portion of the family name that is derived from the person's own surname, as distinguished from any portion that is derived from the surname of the person's partner or spouse. If the person's surname has legally changed to become (or incorporate) the surname of the person's partner or spouse, this is the person's surname immediately prior to such change. Often this is the person's &quot;maiden name&quot;." />
      <alias value="Geslachtsnaam" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/humanname-own-name" />
      </type>
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.24" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.24" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.10" />
      </mapping>
    </element>
    <element id="HumanName.family.extension:humannamePartnerPrefix">
      <path value="HumanName.family.extension" />
      <sliceName value="humannamePartnerPrefix" />
      <short value="PrefixSurname" />
      <definition value="Voorvoegsel derived from person's partner's surname inclusive of the space between the prefix and the surname, if applicable." />
      <comment value="An example of a voorvoegsel is the &quot;van&quot; in &quot;Ludwig van Beethoven&quot;. Since the voorvoegsel doesn't sort completely alphabetically, it is reasonable to identify it as a separate sub-component." />
      <alias value="VoorvoegselGeslachtsnaamPartner" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/humanname-partner-prefix" />
      </type>
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.39" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.39" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.9" />
      </mapping>
    </element>
    <element id="HumanName.family.extension:humannamePartnerName">
      <path value="HumanName.family.extension" />
      <sliceName value="humannamePartnerName" />
      <short value="LastNamePartner" />
      <definition value="Partner’s official last name. " />
      <comment value="The portion of the family name that is derived from the person's partner's surname, as distinguished from any portion that is derived from the surname of the person's own name. If the person's surname has legally changed to become (or incorporate) the surname of the person's partner or spouse, this is the person's surname immediately prior to such change. Often this is the person's &quot;maiden name&quot;." />
      <alias value="GeslachtsnaamPartner" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/humanname-partner-name" />
      </type>
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.25" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.25" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.8" />
      </mapping>
    </element>
    <element id="HumanName.given">
      <path value="HumanName.given" />
      <short value="Given" />
      <definition value="Note that in order to mark the type of a given name, that you use the FHIR standard extension for ISO 21090 EN Qualifiers. Examples include call me name (Dutch: roepnaam) and initials. Each initial is expected to be delimited by a dot." />
      <comment value="To be conformant to the Zib for NameInformation, at least the following qualifiers SHALL be supported: BR, IN and CL. The qualifier 'BR' maps to the Zib concept FirstNames, 'IN' maps to Initials and 'CL' to GivenName." />
      <alias value="Voornamen" />
      <alias value="Initialen" />
      <alias value="Roepnaam" />
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.26" />
        <comment value="Qualifier 'BR'" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.35" />
        <comment value="Qualifier 'IN'" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.27" />
        <comment value="Qualifier 'CL'" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="02.10 Voornamen" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.26" />
        <comment value="Qualifier 'BR'" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.35" />
        <comment value="Qualifier 'IN'" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.27" />
        <comment value="Qualifier 'CL'" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.4" />
        <comment value="Qualifier 'BR'" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.5" />
        <comment value="Qualifier 'IN'" />
      </mapping>
      <mapping>
        <identity value="hcim-nameinformation-v1.0.1-2017EN" />
        <map value="NL-CM:20.4.6" />
        <comment value="Qualifier 'CL'" />
      </mapping>
    </element>
    <element id="HumanName.given.extension">
      <path value="HumanName.given.extension" />
      <slicing>
        <discriminator>
          <type value="value" />
          <path value="url" />
        </discriminator>
        <rules value="open" />
      </slicing>
    </element>
    <element id="HumanName.given.extension:iso21090EnQualifier">
      <path value="HumanName.given.extension" />
      <sliceName value="iso21090EnQualifier" />
      <short value="LS | AC | NB | PR | HON | BR | AD | SP | MID | CL | IN | VV" />
      <definition value="A set of codes each of which specifies a certain subcategory of the name part in addition to the main name part type." />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier" />
      </type>
    </element>
  </differential>
</StructureDefinition>