<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="Person" />
  <meta>
    <lastUpdated value="2021-01-02T08:58:31.578+11:00" />
  </meta>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-category">
    <valueString value="Base.Individuals" />
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    <valueCode value="trial-use" />
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="2" />
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-security-category">
    <valueCode value="patient" />
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="pa" />
  </extension>
  <extension url="http://hl7.org/fhir/build/StructureDefinition/entered-in-error-status">
    <valueCode value=".active = false" />
  </extension>
  <url value="http://hl7.org/fhir/StructureDefinition/Person" />
  <version value="4.6.0" />
  <name value="Person" />
  <status value="draft" />
  <date value="2021-01-02T08:58:31+11:00" />
  <publisher value="Health Level Seven International (Patient Administration)" />
  <contact>
    <telecom>
      <system value="url" />
      <value value="http://hl7.org/fhir" />
    </telecom>
  </contact>
  <contact>
    <telecom>
      <system value="url" />
      <value value="http://www.hl7.org/Special/committees/pafm/index.cfm" />
    </telecom>
  </contact>
  <description value="Demographics and administrative information about a person independent of a specific health-related context." />
  <purpose value="Need to track persons potentially across multiple roles." />
  <fhirVersion value="4.6.0" />
  <mapping>
    <identity value="rim" />
    <uri value="http://hl7.org/v3" />
    <name value="RIM Mapping" />
  </mapping>
  <mapping>
    <identity value="w5" />
    <uri value="http://hl7.org/fhir/fivews" />
    <name value="FiveWs Pattern Mapping" />
  </mapping>
  <mapping>
    <identity value="v2" />
    <uri value="http://hl7.org/v2" />
    <name value="HL7 v2 Mapping" />
  </mapping>
  <kind value="resource" />
  <abstract value="false" />
  <type value="Person" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/DomainResource" />
  <derivation value="specialization" />
  <differential>
    <element id="Person">
      <extension url="http://hl7.org/fhir/build/StructureDefinition/svg">
        <valueCode value="0,0" />
      </extension>
      <path value="Person" />
      <short value="A generic person record" />
      <definition value="Demographics and administrative information about a person independent of a specific health-related context." />
      <comment value="The Person resource does justice to person registries that keep track of persons regardless of their role. The Person resource is also a primary resource to point to for people acting in a particular role such as SubjectofCare, Practitioner, and Agent. Very few attributes are specific to any role and so Person is kept lean. Most attributes are expected to be tied to the role the Person plays rather than the Person himself. Examples of that are Guardian (SubjectofCare), ContactParty (SubjectOfCare, Practitioner), and multipleBirthInd (SubjectofCare)." />
      <min value="0" />
      <max value="*" />
      <mapping>
        <identity value="rim" />
        <map value="Person(classCode=&quot;PSN&quot; and determinerCode=&quot;INST&quot; and quantity=&quot;1&quot;)" />
      </mapping>
      <mapping>
        <identity value="w5" />
        <map value="administrative.entity" />
      </mapping>
    </element>
    <element id="Person.identifier">
      <extension url="http://hl7.org/fhir/build/StructureDefinition/committee-notes">
        <valueString value="Keeping Person.id cardinality as a matter of safety in the same manner as Person Activate." />
      </extension>
      <path value="Person.identifier" />
      <short value="A human identifier for this person" />
      <definition value="Identifier for a person within a particular scope." />
      <requirements value="People are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the person. Examples are national person identifier and local identifier." />
      <min value="0" />
      <max value="*" />
      <type>
        <code value="Identifier" />
      </type>
      <mapping>
        <identity value="w5" />
        <map value="FiveWs.identifier" />
      </mapping>
      <mapping>
        <identity value="v2" />
        <map value="PID-3" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value=".plays:Role(classCode='IDENT').id" />
      </mapping>
    </element>
    <element id="Person.active">
      <path value="Person.active" />
      <short value="This person's record is in active use" />
      <definition value="Whether this person's record is in active use." />
      <requirements value="Need to be able to mark a person record as not to be used because it was created in error." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="boolean" />
      </type>
      <isModifier value="true" />
      <isModifierReason value="This element is labelled as a modifier because it is a status element that can indicate that a record should not be treated as valid" />
      <isSummary value="true" />
      <mapping>
        <identity value="w5" />
        <map value="FiveWs.status" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="statusCode" />
      </mapping>
    </element>
    <element id="Person.name">
      <extension url="http://hl7.org/fhir/build/StructureDefinition/committee-notes">
        <valueString value="Committee does not fully grasp implications of HumanName datatype, so as a matter of safety decided to have cardinality 0..*. It is not clear to the committee whether or not all 80% name parts can be conveyed in one name instance." />
      </extension>
      <path value="Person.name" />
      <short value="A name associated with the person" />
      <definition value="A name associated with the person." />
      <comment value="Person may have multiple names with different uses or applicable periods." />
      <requirements value="Need to be able to track the person by multiple names. Examples are your official name and a partner name." />
      <min value="0" />
      <max value="*" />
      <type>
        <code value="HumanName" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="v2" />
        <map value="PID-5, PID-9" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="./name" />
      </mapping>
    </element>
    <element id="Person.telecom">
      <extension url="http://hl7.org/fhir/build/StructureDefinition/committee-notes">
        <valueString value="renamed from contact, because that suggested &quot;contact party&quot; at first sight. &quot;telecom&quot; is a well-worn path, so without a really good working alternative we want to stick to it." />
      </extension>
      <path value="Person.telecom" />
      <short value="A contact detail for the person" />
      <definition value="A contact detail for the person, e.g. a telephone number or an email address." />
      <comment value="Person may have multiple ways to be contacted with different uses or applicable periods.  May need to have options for contacting the person urgently and also to help with identification." />
      <requirements value="People have (primary) ways to contact them in some way such as phone, email." />
      <min value="0" />
      <max value="*" />
      <type>
        <code value="ContactPoint" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="v2" />
        <map value="PID-13, PID-14" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="./telecom" />
      </mapping>
    </element>
    <element id="Person.gender">
      <extension url="http://hl7.org/fhir/build/StructureDefinition/committee-notes">
        <valueString value="'gender' is still the administrative gender, but this is reflected in its description rather than its name." />
      </extension>
      <path value="Person.gender" />
      <short value="male | female | other | unknown" />
      <definition value="Administrative Gender." />
      <comment value="The gender might not match the biological sex as determined by genetics, or the individual's preferred identification. Note that for both humans and particularly animals, there are other legitimate possibilities than M and F, though a clear majority of systems and contexts only support M and F." />
      <requirements value="Needed for identification of the person, in combination with (at least) name and birth date. Gender of person drives many clinical processes." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="code" />
      </type>
      <isSummary value="true" />
      <binding>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
          <valueString value="AdministrativeGender" />
        </extension>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
          <valueBoolean value="true" />
        </extension>
        <extension url="http://hl7.org/fhir/build/StructureDefinition/v2-map">
          <valueString value="http://terminology.hl7.org/ValueSet/v2-0001" />
        </extension>
        <extension url="http://hl7.org/fhir/build/StructureDefinition/v3-map">
          <valueString value="http://terminology.hl7.org/ValueSet/v3-AdministrativeGender" />
        </extension>
        <strength value="required" />
        <description value="The gender of a person used for administrative purposes." />
        <valueSet value="http://hl7.org/fhir/ValueSet/administrative-gender" />
      </binding>
      <mapping>
        <identity value="v2" />
        <map value="PID-8" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender" />
      </mapping>
    </element>
    <element id="Person.birthDate">
      <extension url="http://hl7.org/fhir/build/StructureDefinition/committee-notes">
        <valueString value="renamed from dob, because the abbreviation is not obvious to non-English speakers." />
      </extension>
      <path value="Person.birthDate" />
      <short value="The date on which the person was born" />
      <definition value="The birth date for the person." />
      <comment value="At least an estimated year should be provided as a guess if the real DOB is unknown." />
      <requirements value="Age of person drives many clinical processes, and is often used in performing identification of the person. Times are not included so as to not confuse things with potential timezone issues." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="date" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="v2" />
        <map value="PID-7" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="./birthTime" />
      </mapping>
    </element>
    <element id="Person.deceased[x]">
      <path value="Person.deceased[x]" />
      <short value="Indicates if the individual is deceased or not" />
      <definition value="Indicates if the individual is deceased or not." />
      <comment value="If there's no value in the instance, it means there is no statement on whether or not the individual is deceased. Most systems will interpret the absence of a value as a sign of the person being alive." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="boolean" />
      </type>
      <type>
        <code value="dateTime" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="v2" />
        <map value="PID-30  (bool) and PID-29 (datetime)" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime" />
      </mapping>
    </element>
    <element id="Person.address">
      <path value="Person.address" />
      <short value="One or more addresses for the person" />
      <definition value="One or more addresses for the person." />
      <comment value="Person may have multiple addresses with different uses or applicable periods." />
      <requirements value="May need to keep track of person's addresses for contacting, billing or reporting requirements and also to help with identification." />
      <min value="0" />
      <max value="*" />
      <type>
        <code value="Address" />
      </type>
      <mapping>
        <identity value="v2" />
        <map value="PID-11" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="./addr" />
      </mapping>
    </element>
    <element id="Person.maritalStatus">
      <path value="Person.maritalStatus" />
      <short value="Marital (civil) status of a person" />
      <definition value="This field contains a person's most recent marital (civil) status." />
      <comment value="Many contries maintain a register of births, deaths and marriages, and this would simplify that interaction" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="CodeableConcept" />
      </type>
      <binding>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
          <valueString value="MaritalStatus" />
        </extension>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
          <valueBoolean value="true" />
        </extension>
        <strength value="extensible" />
        <description value="The domestic partnership status of a person." />
        <valueSet value="http://hl7.org/fhir/ValueSet/marital-status" />
      </binding>
      <mapping>
        <identity value="v2" />
        <map value="PID-16" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="player[classCode=PSN]/maritalStatusCode" />
      </mapping>
    </element>
    <element id="Person.photo">
      <path value="Person.photo" />
      <short value="Image of the person" />
      <definition value="An image that can be displayed as a thumbnail of the person to enhance the identification of the individual." />
      <min value="0" />
      <max value="*" />
      <type>
        <code value="Attachment" />
      </type>
      <mapping>
        <identity value="v2" />
        <map value="OBX-5 - needs a profile" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/desc" />
      </mapping>
    </element>
    <element id="Person.managingOrganization">
      <path value="Person.managingOrganization" />
      <short value="The organization that is the custodian of the person record" />
      <definition value="The organization that is the custodian of the person record." />
      <requirements value="Need to know who recognizes this person record, manages and updates it." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Reference" />
        <targetProfile value="http://hl7.org/fhir/StructureDefinition/Organization" />
      </type>
      <isSummary value="true" />
      <mapping>
        <identity value="rim" />
        <map value="scoper" />
      </mapping>
    </element>
    <element id="Person.communication">
      <extension url="http://hl7.org/fhir/build/StructureDefinition/committee-notes">
        <valueString value="Rationale for putting this in the core is based on input from Canada. Other persons on call are from single language countries. Committee felt uncomfortable with leaving any of the 3 optional attributes modeCode, proficiencyLevelCode, or preferenceInd up to extensions. Instead we said that isModifier is &quot;no&quot; on modeCode and preferenceInd." />
      </extension>
      <extension url="http://hl7.org/fhir/build/StructureDefinition/svg">
        <valueCode value="40,270" />
      </extension>
      <path value="Person.communication" />
      <short value="A language which may be used to communicate with the person about his or her health" />
      <definition value="A language which may be used to communicate with the person about his or her health." />
      <comment value="If no language is specified, this *implies* that the default local language is spoken.  If you need to convey proficiency for multiple modes, then you need multiple Person.Communication associations.   For animals, language is not a relevant field, and should be absent from the instance. If the Patient does not speak the default local language, then the Interpreter Required Standard can be used to explicitly declare that an interpreter is required.&#xA;&#xA;Note that this property should not be used to update any linked/logically linked practitioner resources as it serves as a language that can be used to communicate with patients - however it may be used to inform the value on practitioner, along with their role at the organization (with the practitioner's permission)" />
      <requirements value="If a person does not speak the local language, interpreters may be required, so languages spoken and proficiency are important things to keep track of both for person and other persons of interest." />
      <min value="0" />
      <max value="*" />
      <type>
        <code value="BackboneElement" />
      </type>
      <mapping>
        <identity value="rim" />
        <map value="LanguageCommunication" />
      </mapping>
    </element>
    <element id="Person.communication.language">
      <path value="Person.communication.language" />
      <short value="The language which can be used to communicate with the person about his or her health" />
      <definition value="The ISO-639-1 alpha 2 code in lower case for the language, optionally followed by a hyphen and the ISO-3166-1 alpha 2 code for the region in upper case; e.g. &quot;en&quot; for English, or &quot;en-US&quot; for American English versus &quot;en-EN&quot; for England English." />
      <comment value="The structure aa-BB with this exact casing is one the most widely used notations for locale. However not all systems actually code this but instead have it as free text. Hence CodeableConcept instead of code as the data type." />
      <requirements value="Most systems in multilingual countries will want to convey language. Not all systems actually need the regional dialect." />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="CodeableConcept" />
      </type>
      <binding>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
          <valueString value="Language" />
        </extension>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-isCommonBinding">
          <valueBoolean value="true" />
        </extension>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-maxValueSet">
          <valueCanonical value="http://hl7.org/fhir/ValueSet/all-languages" />
        </extension>
        <extension url="http://hl7.org/fhir/build/StructureDefinition/definition">
          <valueString value="A human language." />
        </extension>
        <strength value="preferred" />
        <description value="IETF language tag" />
        <valueSet value="http://hl7.org/fhir/ValueSet/languages" />
      </binding>
      <mapping>
        <identity value="v2" />
        <map value="PID-15, LAN-2" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="player[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code" />
      </mapping>
    </element>
    <element id="Person.communication.preferred">
      <path value="Person.communication.preferred" />
      <short value="Language preference indicator" />
      <definition value="Indicates whether or not the person prefers this language (over other languages he masters up a certain level)." />
      <comment value="This language is specifically identified for communicating healthcare information." />
      <requirements value="People that master multiple languages up to certain level may prefer one or more, i.e. feel more confident in communicating in a particular language making other languages sort of a fall back method." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="boolean" />
      </type>
      <mapping>
        <identity value="v2" />
        <map value="PID-15" />
      </mapping>
      <mapping>
        <identity value="rim" />
        <map value="preferenceInd" />
      </mapping>
    </element>
    <element id="Person.link">
      <extension url="http://hl7.org/fhir/build/StructureDefinition/svg">
        <valueCode value="350,40" />
      </extension>
      <path value="Person.link" />
      <short value="Link to a resource that concerns the same actual person" />
      <definition value="Link to a resource that concerns the same actual person." />
      <min value="0" />
      <max value="*" />
      <type>
        <code value="BackboneElement" />
      </type>
      <mapping>
        <identity value="rim" />
        <map value="outboundLink" />
      </mapping>
    </element>
    <element id="Person.link.target">
      <path value="Person.link.target" />
      <short value="The resource to which this actual person is associated" />
      <definition value="The resource to which this actual person is associated." />
      <min value="1" />
      <max value="1" />
      <type>
        <code value="Reference" />
        <targetProfile value="http://hl7.org/fhir/StructureDefinition/Patient" />
        <targetProfile value="http://hl7.org/fhir/StructureDefinition/Practitioner" />
        <targetProfile value="http://hl7.org/fhir/StructureDefinition/RelatedPerson" />
        <targetProfile value="http://hl7.org/fhir/StructureDefinition/Person" />
      </type>
      <mapping>
        <identity value="rim" />
        <map value="id" />
      </mapping>
    </element>
    <element id="Person.link.assurance">
      <path value="Person.link.assurance" />
      <short value="level1 | level2 | level3 | level4" />
      <definition value="Level of assurance that this link is associated with the target resource." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="code" />
      </type>
      <binding>
        <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
          <valueString value="IdentityAssuranceLevel" />
        </extension>
        <strength value="required" />
        <description value="The level of confidence that this link represents the same actual person, based on NIST Authentication Levels." />
        <valueSet value="http://hl7.org/fhir/ValueSet/identity-assuranceLevel" />
      </binding>
      <mapping>
        <identity value="rim" />
        <map value="priorityNumber?" />
      </mapping>
    </element>
  </differential>
</StructureDefinition>