This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
Extension-us-core-ethnicity.xml

Raw XML (canonical form)
US Core ethnicity Extension
<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="us-core-ethnicity"/>
  <url value="http://hl7.org/fhir/StructureDefinition/us-core-ethnicity"/>
  <name value="US Core ethnicity Extension"/>
  <title value="US Core ethnicity Extension"/>
  <status value="draft"/>
  <publisher value="Health Level Seven International (US Realm Steering Committee)"/>
  <contact>
    <telecom>
      <system value="url"/>
      <value value="http://www.hl7.org/Special/Committees/usrealm"/>
    </telecom>
  </contact>
  <date value="2013-12-03"/>
  <description value="Concepts classifying the person into a named category of humans sharing common history,
   traits, geographical origin or nationality.  The ethnicity codes used to represent these
   concepts are based upon the [CDC ethnicity and Ethnicity Code Set Version 1.0](http://www.cdc.gov/ph
  in/resources/vocabulary/index.html) which includes over 900 concepts for representing race
   and ethnicity of which 43 reference ethnicity.  The ethnicity concepts are grouped by
   and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic
   or Latino."/>
  <fhirVersion value="1.8.0"/>
  <mapping>
    <identity value="cda"/>
    <uri value="http://hl7.org/v3/cda"/>
    <name value="CDA (R2)"/>
  </mapping>
  <mapping>
    <identity value="rim"/>
    <uri value="http://hl7.org/v3"/>
    <name value="RIM Mapping"/>
  </mapping>
  <kind value="complex-type"/>
  <abstract value="false"/>
  <contextType value="resource"/>
  <context value="Patient"/>
  <type value="Extension"/>
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Extension"/>
  <derivation value="constraint"/>
  <snapshot>
    <element id="Extension:uscoreethnicityextension">
      <path value="Extension"/>
      <short value="US Core ethnicity Extension"/>
      <definition value="Concepts classifying the person into a named category of humans sharing common history,
       traits, geographical origin or nationality.  The ethnicity codes used to represent these
       concepts are based upon the [CDC ethnicity and Ethnicity Code Set Version 1.0](http://www.cdc.gov/ph
      in/resources/vocabulary/index.html) which includes over 900 concepts for representing race
       and ethnicity of which 43 reference ethnicity.  The ethnicity concepts are grouped by
       and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic
       or Latino."/>
      <min value="0"/>
      <max value="1"/>
      <base>
        <path value="Extension"/>
        <min value="0"/>
        <max value="*"/>
      </base>
      <condition value="ele-1"/>
      <constraint>
        <key value="ele-1"/>
        <severity value="error"/>
        <human value="All FHIR elements must have a @value or children"/>
        <expression value="children().count() &gt; id.count()"/>
        <xpath value="@value|f:*|h:div"/>
        <source value="Element"/>
      </constraint>
      <constraint>
        <key value="ext-1"/>
        <severity value="error"/>
        <human value="Must have either extensions or value[x], not both"/>
        <expression value="extension.exists() != value.exists()"/>
        <xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])"/>
        <source value="Extension"/>
      </constraint>
    </element>
    <element id="Extension:uscoreethnicityextension.id">
      <path value="Extension.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). This may be any
       string value that does not contain spaces."/>
      <min value="0"/>
      <max value="1"/>
      <base>
        <path value="Element.id"/>
        <min value="0"/>
        <max value="1"/>
      </base>
      <type>
        <code value="string"/>
      </type>
      <mapping>
        <identity value="rim"/>
        <map value="n/a"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension">
      <path value="Extension.extension"/>
      <slicing id="76">
        <discriminator value="url"/>
        <ordered value="false"/>
        <rules value="open"/>
      </slicing>
      <short value="Extension"/>
      <definition value="An Extension"/>
      <min value="0"/>
      <max value="*"/>
      <base>
        <path value="Element.extension"/>
        <min value="0"/>
        <max value="*"/>
      </base>
      <type>
        <code value="Extension"/>
      </type>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory">
      <path value="Extension.extension"/>
      <sliceName value="ombCategory"/>
      <short value="Hispanic or Latino|Not Hispanic or Latino"/>
      <definition value="The 2 ethnicity category codes according to the [OMB Standards for Maintaining, Collecting,
       and Presenting Federal Data on Race and Ethnicity, Statistical Policy Directive No. 15,
       as revised, October 30, 1997](https://www.whitehouse.gov/omb/fedreg_1997standards)."/>
      <min value="1"/>
      <max value="1"/>
      <base>
        <path value="Element.extension"/>
        <min value="0"/>
        <max value="*"/>
      </base>
      <type>
        <code value="Extension"/>
      </type>
      <mapping>
        <identity value="cda"/>
        <map value="/ClinicalDocument/recordTarget/patientRole/patient/ethnicGroupCode"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory.id">
      <path value="Extension.extension.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). This may be any
       string value that does not contain spaces."/>
      <min value="0"/>
      <max value="1"/>
      <base>
        <path value="Element.id"/>
        <min value="0"/>
        <max value="1"/>
      </base>
      <type>
        <code value="string"/>
      </type>
      <mapping>
        <identity value="rim"/>
        <map value="n/a"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory.extension:extension">
      <path value="Extension.extension.extension"/>
      <sliceName value="extension"/>
      <short value="Extension"/>
      <definition value="An Extension"/>
      <min value="0"/>
      <max value="0"/>
      <base>
        <path value="Element.extension"/>
        <min value="0"/>
        <max value="*"/>
      </base>
      <type>
        <code value="Extension"/>
      </type>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory.url">
      <path value="Extension.extension.url"/>
      <representation value="xmlAttr"/>
      <short value="identifies the meaning of the extension"/>
      <definition value="Source of the definition for the extension code - a logical name or a URL."/>
      <comments value="The definition may point directly to a computable or human-readable definition of the
       extensibility codes, or it may be a logical URI as declared in some other specification.
       The definition SHALL be a URI for the Structure Definition defining the extension."/>
      <min value="1"/>
      <max value="1"/>
      <base>
        <path value="Extension.url"/>
        <min value="1"/>
        <max value="1"/>
      </base>
      <type>
        <code value="uri"/>
      </type>
      <fixedUri value="ombCategory"/>
      <mapping>
        <identity value="rim"/>
        <map value="N/A"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory.valueCoding">
      <path value="Extension.extension.valueCoding"/>
      <short value="Value of extension"/>
      <definition value="Value of extension - may be a resource or one of a constrained set of the data types (see
       Extensibility in the spec for list)."/>
      <min value="1"/>
      <max value="1"/>
      <base>
        <path value="Extension.value[x]"/>
        <min value="0"/>
        <max value="1"/>
      </base>
      <type>
        <code value="Coding"/>
      </type>
      <binding>
        <strength value="required"/>
        <description value="The 2 ethnicity category codes according to the [OMB Standards for Maintaining, Collecting,
         and Presenting Federal Data on Race and Ethnicity, Statistical Policy Directive No. 15,
         as revised, October 30, 1997](https://www.whitehouse.gov/omb/fedreg_1997standards)."/>
        <valueSetReference>
          <reference value="http://hl7.org/fhir/ValueSet/omb-ethnicity"/>
        </valueSetReference>
      </binding>
      <mapping>
        <identity value="rim"/>
        <map value="N/A"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed">
      <path value="Extension.extension"/>
      <sliceName value="detailed"/>
      <short value="Extended ethnicity codes"/>
      <definition value="The 41 CDC ethnicity codes that are grouped under one of the 2 OMB ethnicity category
       codes."/>
      <min value="0"/>
      <max value="*"/>
      <base>
        <path value="Element.extension"/>
        <min value="0"/>
        <max value="*"/>
      </base>
      <type>
        <code value="Extension"/>
      </type>
      <mapping>
        <identity value="cda"/>
        <map value="/ClinicalDocument/recordTarget/patientRole/patient/sdtc:ethnicGroupCode"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed.id">
      <path value="Extension.extension.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). This may be any
       string value that does not contain spaces."/>
      <min value="0"/>
      <max value="1"/>
      <base>
        <path value="Element.id"/>
        <min value="0"/>
        <max value="1"/>
      </base>
      <type>
        <code value="string"/>
      </type>
      <mapping>
        <identity value="rim"/>
        <map value="n/a"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed.extension:extension">
      <path value="Extension.extension.extension"/>
      <sliceName value="extension"/>
      <short value="Extension"/>
      <definition value="An Extension"/>
      <min value="0"/>
      <max value="0"/>
      <base>
        <path value="Element.extension"/>
        <min value="0"/>
        <max value="*"/>
      </base>
      <type>
        <code value="Extension"/>
      </type>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed.url">
      <path value="Extension.extension.url"/>
      <representation value="xmlAttr"/>
      <short value="identifies the meaning of the extension"/>
      <definition value="Source of the definition for the extension code - a logical name or a URL."/>
      <comments value="The definition may point directly to a computable or human-readable definition of the
       extensibility codes, or it may be a logical URI as declared in some other specification.
       The definition SHALL be a URI for the Structure Definition defining the extension."/>
      <min value="1"/>
      <max value="1"/>
      <base>
        <path value="Extension.url"/>
        <min value="1"/>
        <max value="1"/>
      </base>
      <type>
        <code value="uri"/>
      </type>
      <fixedUri value="detailed"/>
      <mapping>
        <identity value="rim"/>
        <map value="N/A"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed.valueCoding">
      <path value="Extension.extension.valueCoding"/>
      <short value="Value of extension"/>
      <definition value="Value of extension - may be a resource or one of a constrained set of the data types (see
       Extensibility in the spec for list)."/>
      <min value="1"/>
      <max value="1"/>
      <base>
        <path value="Extension.value[x]"/>
        <min value="0"/>
        <max value="1"/>
      </base>
      <type>
        <code value="Coding"/>
      </type>
      <binding>
        <strength value="required"/>
        <description value="The 41 [CDC ethnicity codes](http://www.cdc.gov/phin/resources/vocabulary/index.html)
         that are grouped under one of the 2 OMB ethnicity category codes."/>
        <valueSetReference>
          <reference value="http://hl7.org/fhir/ValueSet/detailed-ethnicity"/>
        </valueSetReference>
      </binding>
      <mapping>
        <identity value="rim"/>
        <map value="N/A"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text">
      <path value="Extension.extension"/>
      <sliceName value="text"/>
      <short value="ethnicity Text"/>
      <definition value="Plain text representation of the ethnicity concept(s)."/>
      <min value="0"/>
      <max value="1"/>
      <base>
        <path value="Element.extension"/>
        <min value="0"/>
        <max value="*"/>
      </base>
      <type>
        <code value="Extension"/>
      </type>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text.id">
      <path value="Extension.extension.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). This may be any
       string value that does not contain spaces."/>
      <min value="0"/>
      <max value="1"/>
      <base>
        <path value="Element.id"/>
        <min value="0"/>
        <max value="1"/>
      </base>
      <type>
        <code value="string"/>
      </type>
      <mapping>
        <identity value="rim"/>
        <map value="n/a"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text.extension:extension">
      <path value="Extension.extension.extension"/>
      <sliceName value="extension"/>
      <short value="Extension"/>
      <definition value="An Extension"/>
      <min value="0"/>
      <max value="0"/>
      <base>
        <path value="Element.extension"/>
        <min value="0"/>
        <max value="*"/>
      </base>
      <type>
        <code value="Extension"/>
      </type>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text.url">
      <path value="Extension.extension.url"/>
      <representation value="xmlAttr"/>
      <short value="identifies the meaning of the extension"/>
      <definition value="Source of the definition for the extension code - a logical name or a URL."/>
      <comments value="The definition may point directly to a computable or human-readable definition of the
       extensibility codes, or it may be a logical URI as declared in some other specification.
       The definition SHALL be a URI for the Structure Definition defining the extension."/>
      <min value="1"/>
      <max value="1"/>
      <base>
        <path value="Extension.url"/>
        <min value="1"/>
        <max value="1"/>
      </base>
      <type>
        <code value="uri"/>
      </type>
      <fixedUri value="text"/>
      <mapping>
        <identity value="rim"/>
        <map value="N/A"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text.valueString">
      <path value="Extension.extension.valueString"/>
      <short value="Value of extension"/>
      <definition value="Value of extension - may be a resource or one of a constrained set of the data types (see
       Extensibility in the spec for list)."/>
      <min value="1"/>
      <max value="1"/>
      <base>
        <path value="Extension.value[x]"/>
        <min value="0"/>
        <max value="1"/>
      </base>
      <type>
        <code value="string"/>
      </type>
      <mapping>
        <identity value="rim"/>
        <map value="N/A"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.url">
      <path value="Extension.url"/>
      <representation value="xmlAttr"/>
      <short value="identifies the meaning of the extension"/>
      <definition value="Source of the definition for the extension code - a logical name or a URL."/>
      <comments value="The definition may point directly to a computable or human-readable definition of the
       extensibility codes, or it may be a logical URI as declared in some other specification.
       The definition SHALL be a URI for the Structure Definition defining the extension."/>
      <min value="1"/>
      <max value="1"/>
      <base>
        <path value="Extension.url"/>
        <min value="1"/>
        <max value="1"/>
      </base>
      <type>
        <code value="uri"/>
      </type>
      <fixedUri value="http://hl7.org/fhir/StructureDefinition/us-core-ethnicity"/>
      <mapping>
        <identity value="rim"/>
        <map value="N/A"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.value[x]">
      <path value="Extension.value[x]"/>
      <short value="Value of extension"/>
      <definition value="Value of extension - may be a resource or one of a constrained set of the data types (see
       Extensibility in the spec for list)."/>
      <min value="0"/>
      <max value="0"/>
      <base>
        <path value="Extension.value[x]"/>
        <min value="0"/>
        <max value="1"/>
      </base>
      <type>
        <code value="base64Binary"/>
      </type>
      <type>
        <code value="boolean"/>
      </type>
      <type>
        <code value="code"/>
      </type>
      <type>
        <code value="date"/>
      </type>
      <type>
        <code value="dateTime"/>
      </type>
      <type>
        <code value="decimal"/>
      </type>
      <type>
        <code value="id"/>
      </type>
      <type>
        <code value="instant"/>
      </type>
      <type>
        <code value="integer"/>
      </type>
      <type>
        <code value="markdown"/>
      </type>
      <type>
        <code value="oid"/>
      </type>
      <type>
        <code value="positiveInt"/>
      </type>
      <type>
        <code value="string"/>
      </type>
      <type>
        <code value="time"/>
      </type>
      <type>
        <code value="unsignedInt"/>
      </type>
      <type>
        <code value="uri"/>
      </type>
      <type>
        <code value="Address"/>
      </type>
      <type>
        <code value="Age"/>
      </type>
      <type>
        <code value="Annotation"/>
      </type>
      <type>
        <code value="Attachment"/>
      </type>
      <type>
        <code value="CodeableConcept"/>
      </type>
      <type>
        <code value="Coding"/>
      </type>
      <type>
        <code value="ContactPoint"/>
      </type>
      <type>
        <code value="Count"/>
      </type>
      <type>
        <code value="Distance"/>
      </type>
      <type>
        <code value="Duration"/>
      </type>
      <type>
        <code value="HumanName"/>
      </type>
      <type>
        <code value="Identifier"/>
      </type>
      <type>
        <code value="Money"/>
      </type>
      <type>
        <code value="Period"/>
      </type>
      <type>
        <code value="Quantity"/>
      </type>
      <type>
        <code value="Range"/>
      </type>
      <type>
        <code value="Ratio"/>
      </type>
      <type>
        <code value="Reference"/>
      </type>
      <type>
        <code value="SampledData"/>
      </type>
      <type>
        <code value="Signature"/>
      </type>
      <type>
        <code value="Timing"/>
      </type>
      <type>
        <code value="Meta"/>
      </type>
      <mapping>
        <identity value="rim"/>
        <map value="N/A"/>
      </mapping>
    </element>
  </snapshot>
  <differential>
    <element id="Extension:uscoreethnicityextension">
      <path value="Extension"/>
      <short value="US Core ethnicity Extension"/>
      <definition value="Concepts classifying the person into a named category of humans sharing common history,
       traits, geographical origin or nationality.  The ethnicity codes used to represent these
       concepts are based upon the [CDC ethnicity and Ethnicity Code Set Version 1.0](http://www.cdc.gov/ph
      in/resources/vocabulary/index.html) which includes over 900 concepts for representing race
       and ethnicity of which 43 reference ethnicity.  The ethnicity concepts are grouped by
       and pre-mapped to the 2 OMB ethnicity categories: - Hispanic or Latino - Not Hispanic
       or Latino."/>
      <min value="0"/>
      <max value="1"/>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory">
      <path value="Extension.extension"/>
      <sliceName value="ombCategory"/>
      <short value="Hispanic or Latino|Not Hispanic or Latino"/>
      <definition value="The 2 ethnicity category codes according to the [OMB Standards for Maintaining, Collecting,
       and Presenting Federal Data on Race and Ethnicity, Statistical Policy Directive No. 15,
       as revised, October 30, 1997](https://www.whitehouse.gov/omb/fedreg_1997standards)."/>
      <min value="1"/>
      <max value="1"/>
      <type>
        <code value="Extension"/>
      </type>
      <mapping>
        <identity value="cda"/>
        <map value="/ClinicalDocument/recordTarget/patientRole/patient/ethnicGroupCode"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory.extension:extension">
      <path value="Extension.extension.extension"/>
      <sliceName value="extension"/>
      <max value="0"/>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory.url">
      <path value="Extension.extension.url"/>
      <type>
        <code value="uri"/>
      </type>
      <fixedUri value="ombCategory"/>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:ombcategory.value[x]">
      <path value="Extension.extension.value[x]"/>
      <min value="1"/>
      <type>
        <code value="Coding"/>
      </type>
      <binding>
        <strength value="required"/>
        <description value="The 2 ethnicity category codes according to the [OMB Standards for Maintaining, Collecting,
         and Presenting Federal Data on Race and Ethnicity, Statistical Policy Directive No. 15,
         as revised, October 30, 1997](https://www.whitehouse.gov/omb/fedreg_1997standards)."/>
        <valueSetReference>
          <reference value="http://hl7.org/fhir/ValueSet/omb-ethnicity"/>
        </valueSetReference>
      </binding>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed">
      <path value="Extension.extension"/>
      <sliceName value="detailed"/>
      <short value="Extended ethnicity codes"/>
      <definition value="The 41 CDC ethnicity codes that are grouped under one of the 2 OMB ethnicity category
       codes."/>
      <min value="0"/>
      <max value="*"/>
      <type>
        <code value="Extension"/>
      </type>
      <mapping>
        <identity value="cda"/>
        <map value="/ClinicalDocument/recordTarget/patientRole/patient/sdtc:ethnicGroupCode"/>
      </mapping>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed.extension:extension">
      <path value="Extension.extension.extension"/>
      <sliceName value="extension"/>
      <max value="0"/>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed.url">
      <path value="Extension.extension.url"/>
      <type>
        <code value="uri"/>
      </type>
      <fixedUri value="detailed"/>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:detailed.value[x]">
      <path value="Extension.extension.value[x]"/>
      <min value="1"/>
      <type>
        <code value="Coding"/>
      </type>
      <binding>
        <strength value="required"/>
        <description value="The 41 [CDC ethnicity codes](http://www.cdc.gov/phin/resources/vocabulary/index.html)
         that are grouped under one of the 2 OMB ethnicity category codes."/>
        <valueSetReference>
          <reference value="http://hl7.org/fhir/ValueSet/detailed-ethnicity"/>
        </valueSetReference>
      </binding>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text">
      <path value="Extension.extension"/>
      <sliceName value="text"/>
      <short value="ethnicity Text"/>
      <definition value="Plain text representation of the ethnicity concept(s)."/>
      <min value="0"/>
      <max value="1"/>
      <type>
        <code value="Extension"/>
      </type>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text.extension:extension">
      <path value="Extension.extension.extension"/>
      <sliceName value="extension"/>
      <max value="0"/>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text.url">
      <path value="Extension.extension.url"/>
      <type>
        <code value="uri"/>
      </type>
      <fixedUri value="text"/>
    </element>
    <element id="Extension:uscoreethnicityextension.extension:text.value[x]">
      <path value="Extension.extension.value[x]"/>
      <min value="1"/>
      <type>
        <code value="string"/>
      </type>
    </element>
    <element id="Extension:uscoreethnicityextension.url">
      <path value="Extension.url"/>
      <type>
        <code value="uri"/>
      </type>
      <fixedUri value="http://hl7.org/fhir/StructureDefinition/us-core-ethnicity"/>
    </element>
    <element id="Extension:uscoreethnicityextension.value[x]">
      <path value="Extension.value[x]"/>
      <min value="0"/>
      <max value="0"/>
    </element>
  </differential>
</StructureDefinition>
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.