Release 5 Ballot

This page is part of the FHIR Specification (v5.0.0-ballot: FHIR R5 Ballot Preview). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3

Example CodeSystem/name-use (XML)

FHIR Infrastructure Work GroupMaturity Level: N/AStandards Status: Informative

Raw XML (canonical form + also see XML Format Specification)

Definition for Code SystemNameUse

<?xml version="1.0" encoding="UTF-8"?>

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="name-use"/> 
  <meta> 
    <lastUpdated value="2022-09-07T10:58:29.429+10:00"/> 
  </meta> 
  <text> 
    <status value="generated"/> 
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p> This code system 
        <code> http://hl7.org/fhir/name-use</code>  defines the following codes:
      </p> 
      <table class="codes">
        <tr> 
          <td> 
            <b> Lvl</b> 
          </td> 
          <td style="white-space:nowrap">
            <b> Code</b> 
          </td> 
          <td> 
            <b> Display</b> 
          </td> 
          <td> 
            <b> Definition</b> 
          </td> 
        </tr> 
        <tr> 
          <td> 1</td> 
          <td style="white-space:nowrap">usual
            <a name="name-use-usual"> </a> 
          </td> 
          <td> Usual</td> 
          <td> Known as/conventional/the one you normally use.</td> 
        </tr> 
        <tr> 
          <td> 1</td> 
          <td style="white-space:nowrap">official
            <a name="name-use-official"> </a> 
          </td> 
          <td> Official</td> 
          <td> The formal name as registered in an official (government) registry, but which name might
             not be commonly used. May be called &quot;legal name&quot;.</td> 
        </tr> 
        <tr> 
          <td> 1</td> 
          <td style="white-space:nowrap">temp
            <a name="name-use-temp"> </a> 
          </td> 
          <td> Temp</td> 
          <td> A temporary name. Name.period can provide more detailed information. This may also be
             used for temporary names assigned at birth or in emergency situations.</td> 
        </tr> 
        <tr> 
          <td> 1</td> 
          <td style="white-space:nowrap">nickname
            <a name="name-use-nickname"> </a> 
          </td> 
          <td> Nickname</td> 
          <td> A name that is used to address the person in an informal manner, but is not part of their
             formal or usual name.</td> 
        </tr> 
        <tr> 
          <td> 1</td> 
          <td style="white-space:nowrap">anonymous
            <a name="name-use-anonymous"> </a> 
          </td> 
          <td> Anonymous</td> 
          <td> Anonymous assigned name, alias, or pseudonym (used to protect a person's identity for
             privacy reasons).</td> 
        </tr> 
        <tr> 
          <td> 1</td> 
          <td style="white-space:nowrap">old
            <a name="name-use-old"> </a> 
          </td> 
          <td> Old</td> 
          <td> This name is no longer in use (or was never correct, but retained for records).</td> 
        </tr> 
        <tr> 
          <td> 2</td> 
          <td style="white-space:nowrap">  maiden
            <a name="name-use-maiden"> </a> 
          </td> 
          <td> Name changed for Marriage</td> 
          <td> A name used prior to changing name because of marriage. This name use is for use by applications
             that collect and store names that were used prior to a marriage. Marriage naming customs
             vary greatly around the world, and are constantly changing. This term is not gender specific.
             The use of this term does not imply any particular history for a person's name.</td> 
        </tr> 
      </table> 
    </div> 
  </text> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="fhir"/> 
  </extension> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    <valueCode value="normative"/> 
  </extension> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version">
    <valueCode value="4.0.0"/> 
  </extension> 
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="5"/> 
  </extension> 
  <url value="http://hl7.org/fhir/name-use"/> 
  <identifier> 
    <system value="urn:ietf:rfc:3986"/> 
    <value value="urn:oid:2.16.840.1.113883.4.642.4.66"/> 
  </identifier> 
  <version value="5.0.0-ballot"/> 
  <name value="NameUse"/> 
  <title value="NameUse"/> 
  <status value="active"/> 
  <experimental value="false"/> 
  <date value="2022-09-07T10:58:29+10:00"/> 
  <publisher value="HL7 (FHIR Project)"/> 
  <contact> 
    <telecom> 
      <system value="url"/> 
      <value value="http://hl7.org/fhir"/> 
    </telecom> 
    <telecom> 
      <system value="email"/> 
      <value value="fhir@lists.hl7.org"/> 
    </telecom> 
  </contact> 
  <description value="The use of a human name."/> 
  <caseSensitive value="true"/> 
  <valueSet value="http://hl7.org/fhir/ValueSet/name-use"/> 
  <content value="complete"/> 
  <concept> 
    <code value="usual"/> 
    <display value="Usual"/> 
    <definition value="Known as/conventional/the one you normally use."/> 
  </concept> 
  <concept> 
    <code value="official"/> 
    <display value="Official"/> 
    <definition value="The formal name as registered in an official (government) registry, but which name might
     not be commonly used. May be called &quot;legal name&quot;."/> 
  </concept> 
  <concept> 
    <code value="temp"/> 
    <display value="Temp"/> 
    <definition value="A temporary name. Name.period can provide more detailed information. This may also be
     used for temporary names assigned at birth or in emergency situations."/> 
  </concept> 
  <concept> 
    <code value="nickname"/> 
    <display value="Nickname"/> 
    <definition value="A name that is used to address the person in an informal manner, but is not part of their
     formal or usual name."/> 
  </concept> 
  <concept> 
    <code value="anonymous"/> 
    <display value="Anonymous"/> 
    <definition value="Anonymous assigned name, alias, or pseudonym (used to protect a person's identity for
     privacy reasons)."/> 
  </concept> 
  <concept> 
    <code value="old"/> 
    <display value="Old"/> 
    <definition value="This name is no longer in use (or was never correct, but retained for records)."/> 
    <concept> 
      <code value="maiden"/> 
      <display value="Name changed for Marriage"/> 
      <definition value="A name used prior to changing name because of marriage. This name use is for use by applications
       that collect and store names that were used prior to a marriage. Marriage naming customs
       vary greatly around the world, and are constantly changing. This term is not gender specific.
       The use of this term does not imply any particular history for a person's name."/> 
    </concept> 
  </concept> 
</CodeSystem> 

Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.