HL7 FHIR® US Core Implementation Guide (Release 3.0.1 STU3 Update for Comment)

This page is part of the US Core (v3.0.1: STU3 Ballot 3) based on FHIR R4. The current version which supercedes this version is 5.0.1. For a full list of available versions, see the Directory of published versions

StructureDefinition-us-core-ethnicity

US Core Ethnicity Extension

This Complex Extension for ethnicity allows one or more ethnicity codes of which:

  • Must Support one code from OMB Ethnicity Categories
  • May include additional ethnicity codes from CDC Ethnicity Codes
  • Must include text description of ethnicity

Context of Use: US Core Patient Profile

Formal Views of Profile Content

Description of Profiles, Differentials, and Snapshots.

The official URL for this profile is: http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity

Published on Tue May 21 00:00:00 EDT 2019 as active by the HL7 US Realm Steering Committee.

This profile builds on Extension

Extension

Summary of the Mandatory Requirements

  1. a Text Extension value
    • which must have a fixed Extension.extension.url = text
    • which must have a string value in Extension.extension.valueString
    • which must have a fixed Extension.url = http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity

Summary of the Must Support Requirements

  1. An Ombcategory Extension
    • which must have a fixed Extension.extension.url = ombCategory
    • which must have a Coding value in Extension.extension.valueCoding with a required binding to OMB Ethnicity Categories

#### Summary of Other Supported Elements

  1. One or more Detailed Extensions
    • which must have a fixed Extension.extension.url = detailed
    • which must have a Coding value in Extension.extension.valueCoding with a required binding to Detailed ethnicity
NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..1US Core ethnicity Extension
... extension:ombCategory S0..1ExtensionHispanic or Latino|Not Hispanic or Latino
.... url 1..1uri"ombCategory"
.... valueCoding 1..1CodingBinding: OMB Ethnicity Categories (required)
... extension:detailed 0..*ExtensionExtended ethnicity codes
.... url 1..1uri"detailed"
.... valueCoding 1..1CodingBinding: Detailed ethnicity (required)
... extension:text S1..1Extensionethnicity Text
.... url 1..1uri"text"
.... valueString 1..1string
... url 1..1"http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension I0..1US Core ethnicity Extension
... id 0..1stringxml:id (or equivalent in JSON)
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... extension:ombCategory S0..1ExtensionHispanic or Latino|Not Hispanic or Latino
.... id 0..1stringxml:id (or equivalent in JSON)
.... url 1..1uri"ombCategory"
.... valueCoding 1..1CodingValue of extension
Binding: OMB Ethnicity Categories (required)
... extension:detailed 0..*ExtensionExtended ethnicity codes
.... id 0..1stringxml:id (or equivalent in JSON)
.... url 1..1uri"detailed"
.... valueCoding 1..1CodingValue of extension
Binding: Detailed ethnicity (required)
... extension:text S1..1Extensionethnicity Text
.... id 0..1stringxml:id (or equivalent in JSON)
.... url 1..1uri"text"
.... valueString 1..1stringValue of extension
... url 1..1uri"http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"

doco Documentation for this format

Extension

Summary of the Mandatory Requirements

  1. a Text Extension value
    • which must have a fixed Extension.extension.url = text
    • which must have a string value in Extension.extension.valueString
    • which must have a fixed Extension.url = http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity

Summary of the Must Support Requirements

  1. An Ombcategory Extension
    • which must have a fixed Extension.extension.url = ombCategory
    • which must have a Coding value in Extension.extension.valueCoding with a required binding to OMB Ethnicity Categories

#### Summary of Other Supported Elements

  1. One or more Detailed Extensions
    • which must have a fixed Extension.extension.url = detailed
    • which must have a Coding value in Extension.extension.valueCoding with a required binding to Detailed ethnicity

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..1US Core ethnicity Extension
... extension:ombCategory S0..1ExtensionHispanic or Latino|Not Hispanic or Latino
.... url 1..1uri"ombCategory"
.... valueCoding 1..1CodingBinding: OMB Ethnicity Categories (required)
... extension:detailed 0..*ExtensionExtended ethnicity codes
.... url 1..1uri"detailed"
.... valueCoding 1..1CodingBinding: Detailed ethnicity (required)
... extension:text S1..1Extensionethnicity Text
.... url 1..1uri"text"
.... valueString 1..1string
... url 1..1"http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension I0..1US Core ethnicity Extension
... id 0..1stringxml:id (or equivalent in JSON)
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... extension:ombCategory S0..1ExtensionHispanic or Latino|Not Hispanic or Latino
.... id 0..1stringxml:id (or equivalent in JSON)
.... url 1..1uri"ombCategory"
.... valueCoding 1..1CodingValue of extension
Binding: OMB Ethnicity Categories (required)
... extension:detailed 0..*ExtensionExtended ethnicity codes
.... id 0..1stringxml:id (or equivalent in JSON)
.... url 1..1uri"detailed"
.... valueCoding 1..1CodingValue of extension
Binding: Detailed ethnicity (required)
... extension:text S1..1Extensionethnicity Text
.... id 0..1stringxml:id (or equivalent in JSON)
.... url 1..1uri"text"
.... valueString 1..1stringValue of extension
... url 1..1uri"http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"

doco Documentation for this format

See the Conformance requirements for a complete list of supported RESTful interactions for this IG.