HL7® FHIR® New Zealand Base Implementation Guide
3.1.0 - Draft

HL7® FHIR® New Zealand Base Implementation Guide, published by HL7 New Zealand. This guide is not an authorized publication; it is the continuous build for version 3.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7NZ/nzbase/ and changes regularly. See the Directory of published versions

Extension: NZ Ethnicity

Official URL: http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity Version: 0.1.0
Active as of 2020-07-20 Computable Name: Nz_ethnicity

Copyright/Legal: HL7 New Zealand© 2020+; Licensed Under Creative Commons No Rights Reserved.

The ethnic group or groups that a person identifies with or feels they belong to. Ethnicity is a measure of cultural affiliation as opposed to race, ancestry, nationality or citizen. Ethnicity is self-perceived and a person can belong to more than one group.

The Stats New Zealand standard can be found here.

Context of Use

Example of extension


  <extension url="http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity">
    <valueCodeableConcept>
      <coding>
        <system value="https://standards.digital.health.nz/ns/ethnic-group-level-4-code"/>
        <code value="21111"/>
        <display value="Maori"/>
      </coding>
    </valueCodeableConcept>
  </extension>

Codes to record a person's ethnicity, drawn from Level 4 of the Ethnicity code system described here

Example instances

Patient with ethnicity

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NZ Ethnicity
... extension 0..0
... url 1..1 uri "http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity"
... value[x] 1..1 CodeableConcept Value of extension
Binding: Ethnicity of a person (L4) (preferred)

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NZ Ethnicity
... id 0..1 string Unique id for inter-element referencing
... extension 0..0
... url 1..1 uri "http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity"

doco Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type CodeableConcept: The ethnic group or groups that a person identifies with or feels they belong to. Ethnicity is a measure of cultural affiliation as opposed to race, ancestry, nationality or citizen. Ethnicity is self-perceived and a person can belong to more than one group.

The Stats New Zealand standard can be found here.

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NZ Ethnicity
... extension 0..0
... url 1..1 uri "http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity"
... value[x] 1..1 CodeableConcept Value of extension
Binding: Ethnicity of a person (L4) (preferred)

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension NZ Ethnicity
... id 0..1 string Unique id for inter-element referencing
... extension 0..0
... url 1..1 uri "http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity"

doco Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type CodeableConcept: The ethnic group or groups that a person identifies with or feels they belong to. Ethnicity is a measure of cultural affiliation as opposed to race, ancestry, nationality or citizen. Ethnicity is self-perceived and a person can belong to more than one group.

The Stats New Zealand standard can be found here.

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

PathConformanceValueSetURI
Extension.value[x]preferredEthnicity(a valid code from Level 4 ethnicity codes)
https://nzhts.digital.health.nz/fhir/ValueSet/ethnic-group-level-4-code
From this IG

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()