2nd DSTU Draft For Comment

This page is part of the FHIR Specification (v0.4.0: DSTU 2 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 . Page versions: R4 R3 R2

V3-hl7Realm.xml

Raw XML (canonical form)

Description: Coded concepts representing Binding Realms (used for Context Binding of terminology in HL7 models) and/or Namespace Realms (used to help ensure unique identification of HL7 artifacts). This code system is partitioned into three sections: Affiliate realms, Binding realms and Namespace realms. All affiliate realm codes may automatically be used as both binding realms and namespace realms. Furthermore, affiliate realms are the only realms that have authority over the creation of binding realms. (Note that 'affiliate' includes the idea of both international affiliates and the HL7 International organization.) All other codes must be associated with an owning affiliate realm and must appear as a specialization of _BindingRealm or _NamespaceRealm. For affiliates whose concepts align with nations, the country codes from ISO 3166-1 2-character alpha are used for the code when possible so these codes should not be used for other realm types. It is recommended that binding realm and namespace codes submitted by affiliates use the realm code as a prefix to avoid possible collisions with ISO codes. However, tooling does not currently support namepace realm codes greater than 2 characters. Open Issue: The name of the concept property "owningAffiliate" should be changed to better reflect that the property value is the human readable name of the organizational entity that manages the Realm identified by the Realm Code. Open Issue: In spite of the inability of tooling to process codes longer than 2 characters, there is at least one realm codes ('SOA') that was added that is 3 characters in length.

Raw XML

<ValueSet xmlns="http://hl7.org/fhir">
  <id value="v3-hl7Realm"/>
  <meta>
    <lastUpdated value="2014-12-11T00:00:00.000+11:00"/>
    <profile value="http://hl7.org/fhir/Profile/valueset-shareable-definition"/>
  </meta>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><!-- Snipped for brevity --></div>
  </text>
  <extension url="http://hl7.org/fhir/ExtensionDefinition/valueset-oid">
    <valueUri value="urn:oid:2.16.840.1.113883.1.11.20355"/>
  </extension>
  <url value="http://hl7.org/fhir/v3/vs/hl7Realm"/>
  <version value="2014-12-11"/>
  <name value="v3 Code System hl7Realm"/>
  <publisher value="HL7, Inc"/>
  <contact>
    <telecom>
      <system value="url"/>
      <value value="http://hl7.org"/>
    </telecom>
  </contact>
  <description value="  Description: Coded concepts representing Binding Realms (used for Context Binding of
     terminology in HL7 models)  and/or Namespace Realms (used to help ensure unique identification
     of HL7 artifacts). This code system is partitioned into three sections: Affiliate realms,
     Binding realms and Namespace realms.  All affiliate realm codes may automatically be used
     as both binding realms and namespace realms.  Furthermore, affiliate realms are the only
     realms that have authority over the creation of binding realms.  (Note that 'affiliate'
     includes the idea of both international affiliates and the HL7 International organization.)
      All other codes must be associated with an owning affiliate realm and must appear as
     a specialization of _BindingRealm or _NamespaceRealm.  For affiliates whose concepts align
     with nations, the country codes from ISO 3166-1 2-character alpha are used for the code
     when possible so these codes should not be used for other realm types.  It is recommended
     that binding realm and namespace codes submitted by affiliates use the realm code as a
     prefix to avoid possible collisions with ISO codes.  However, tooling does not currently
     support namepace realm codes greater than 2 characters.  Open Issue: The name of the concept
     property &quot;owningAffiliate&quot; should be changed to better reflect that the property
     value is the human readable name of the organizational entity that manages the Realm identified
     by the Realm Code.  Open Issue: In spite of the inability of tooling to process codes
     longer than 2 characters, there is at least one realm codes ('SOA') that was added that
     is 3 characters in length."/>
  <status value="active"/>
  <experimental value="false"/>
  <date value="2014-12-11"/>
  <define>
    <extension url="http://hl7.org/fhir/ExtensionDefinition/valueset-oid">
      <valueUri value="urn:oid:2.16.840.1.113883.5.1124"/>
    </extension>
    <system value="http://hl7.org/fhir/v3/hl7Realm"/>
    <caseSensitive value="true"/>
    <concept>
      <code value="BindingRealms"/>
      <abstract value="true"/>
      <display value="binding realms"/>
      <definition value="Description: Concepts that can be used as Binding Realms when creating Binding Statements.
          These codes are permitted to appear in the InfrastructureRoot.realmCode attribute."/>
      <concept>
        <code value="AffiliateRealms"/>
        <abstract value="true"/>
        <display value="Affiliate Realms"/>
        <definition value="Description: Realm codes for official HL7 organizational bodies.  This includes both the
           HL7 International organization as well as all recognized international affiliates (past
           and present).  These groups have the ability to bind vocabulary and develop artifacts.
            As well, they have the ability to have &quot;ownership&quot; over other binding realms
           and namespace realms via the owningAffiliate property of those other realm codes."/>
        <concept>
          <code value="AR"/>
          <abstract value="false"/>
          <display value="Argentina"/>
          <definition value="Description: Realm code for use of Argentina"/>
        </concept>
        <concept>
          <code value="AT"/>
          <abstract value="false"/>
          <display value="Austria"/>
          <definition value="Description: Realm code for use of Austria"/>
        </concept>
        <concept>
          <code value="AU"/>
          <abstract value="false"/>
          <display value="Australia"/>
          <definition value="Description: Realm code for use of Australia"/>
        </concept>
        <concept>
          <code value="BR"/>
          <abstract value="false"/>
          <display value="Brazil"/>
          <definition value="Description: Realm code for use of Brazil"/>
        </concept>
        <concept>
          <code value="CA"/>
          <abstract value="false"/>
          <display value="Canada"/>
          <definition value="Description: Realm code for use of Canada"/>
        </concept>
        <concept>
          <code value="CH"/>
          <abstract value="false"/>
          <display value="Switzerland"/>
          <definition value="Description: Realm code for use of Switzerland"/>
        </concept>
        <concept>
          <code value="CL"/>
          <abstract value="false"/>
          <display value="Chile"/>
          <definition value="Description: Realm code for use of Chile"/>
        </concept>
        <concept>
          <code value="CN"/>
          <abstract value="false"/>
          <display value="China"/>
          <definition value="Description: Realm code for use of China"/>
        </concept>
        <concept>
          <code value="CO"/>
          <abstract value="false"/>
          <display value="Columbia"/>
          <definition value="Description: Realm code for use of Localized Version"/>
        </concept>
        <concept>
          <code value="CZ"/>
          <abstract value="false"/>
          <display value="Czech Republic"/>
          <definition value="Description: Realm code for use of Czech Republic"/>
        </concept>
        <concept>
          <code value="DE"/>
          <abstract value="false"/>
          <display value="Germany"/>
          <definition value="Description: Realm code for use of Germany"/>
        </concept>
        <concept>
          <code value="DK"/>
          <abstract value="false"/>
          <display value="Denmark"/>
          <definition value="Description: Realm code for use of Denmark"/>
        </concept>
        <concept>
          <code value="ES"/>
          <abstract value="false"/>
          <display value="Spain"/>
          <definition value="Description: Realm code for use of Spain"/>
        </concept>
        <concept>
          <code value="FI"/>
          <abstract value="false"/>
          <display value="Finland"/>
          <definition value="Description: Realm code for use of Finland"/>
        </concept>
        <concept>
          <code value="FR"/>
          <abstract value="false"/>
          <display value="France"/>
          <definition value="Description: Realm code for use of France"/>
        </concept>
        <concept>
          <code value="GR"/>
          <abstract value="false"/>
          <display value="Greece"/>
          <definition value="Description: Realm code for use of Greece"/>
        </concept>
        <concept>
          <code value="HR"/>
          <abstract value="false"/>
          <display value="Croatia"/>
          <definition value="Description: Realm code for use of Croatia"/>
        </concept>
        <concept>
          <code value="IE"/>
          <abstract value="false"/>
          <display value="Ireland"/>
          <definition value="Description: Realm code for use of Ireland"/>
        </concept>
        <concept>
          <code value="IN"/>
          <abstract value="false"/>
          <display value="India"/>
          <definition value="Description: Realm code for use of India"/>
        </concept>
        <concept>
          <code value="IT"/>
          <abstract value="false"/>
          <display value="Italy"/>
          <definition value="Description: Realm code for use of Italy"/>
        </concept>
        <concept>
          <code value="JP"/>
          <abstract value="false"/>
          <display value="Japan"/>
          <definition value="Description: Realm code for use of Japan"/>
        </concept>
        <concept>
          <code value="KR"/>
          <abstract value="false"/>
          <display value="Korea"/>
          <definition value="Description: Realm code for use of Korea"/>
        </concept>
        <concept>
          <code value="LT"/>
          <abstract value="false"/>
          <display value="Lithuania"/>
          <definition value="Description: Realm code for use of Lithuania"/>
        </concept>
        <concept>
          <code value="MX"/>
          <abstract value="false"/>
          <display value="Mexico"/>
          <definition value="Description: Realm code for use of Mexico"/>
        </concept>
        <concept>
          <code value="NL"/>
          <abstract value="false"/>
          <display value="The Netherlands"/>
          <definition value="Description: Realm code for use of The Netherlands"/>
        </concept>
        <concept>
          <code value="NZ"/>
          <abstract value="false"/>
          <display value="New Zealand"/>
          <definition value="Description: Realm code for use of New Zealand"/>
        </concept>
        <concept>
          <code value="RO"/>
          <abstract value="false"/>
          <display value="Romania"/>
          <definition value="Description: Realm code for use of Romania"/>
        </concept>
        <concept>
          <code value="RU"/>
          <abstract value="false"/>
          <display value="Russian Federation"/>
          <definition value="Description: Realm code for use of Russian Federation"/>
        </concept>
        <concept>
          <code value="SE"/>
          <abstract value="false"/>
          <display value="Sweden"/>
          <definition value="Description: Realm code for use of Sweden"/>
        </concept>
        <concept>
          <code value="SG"/>
          <abstract value="false"/>
          <display value="Singapore"/>
          <definition value="Description: Realm code for use of Localized Version"/>
        </concept>
        <concept>
          <code value="SOA"/>
          <abstract value="false"/>
          <display value="Southern Africa"/>
          <definition value="Description: Realm code for use of Southern Africa"/>
        </concept>
        <concept>
          <code value="TR"/>
          <abstract value="false"/>
          <display value="Turkey"/>
          <definition value="Description: Realm code for use of Turkey"/>
        </concept>
        <concept>
          <code value="TW"/>
          <abstract value="false"/>
          <display value="Taiwan"/>
          <definition value="Description: Realm code for use of Taiwan"/>
        </concept>
        <concept>
          <code value="UK"/>
          <abstract value="false"/>
          <display value="United Kingdom"/>
          <definition value="Description: Realm code for use of United Kingdom"/>
        </concept>
        <concept>
          <code value="US"/>
          <abstract value="false"/>
          <display value="United States of America"/>
          <definition value="Description: Realm code for use of United States of America"/>
        </concept>
        <concept>
          <code value="UV"/>
          <abstract value="false"/>
          <display value="Universal"/>
          <definition value="Description: Realm code for use of Universal realm or context, used in every instance"/>
        </concept>
        <concept>
          <code value="UY"/>
          <abstract value="false"/>
          <display value="Uruguay"/>
          <definition value="Description: Realm code for use of Uruguay"/>
        </concept>
      </concept>
      <concept>
        <code value="C1"/>
        <abstract value="false"/>
        <display value="Unclassified Realm"/>
        <definition value="Description: Realm code for use of Unclassified Realm"/>
      </concept>
      <concept>
        <code value="GB"/>
        <abstract value="false"/>
        <display value="Great Britain"/>
        <definition value="Description: Realm code for use of Great Britain"/>
      </concept>
      <concept>
        <code value="R1"/>
        <abstract value="false"/>
        <display value="Representative Realm"/>
        <definition value="Description: Realm code for use of Representative Realm"/>
      </concept>
      <concept>
        <code value="X1"/>
        <abstract value="false"/>
        <display value="Example Realm"/>
        <definition value="Description: Realm code for use of Example Realm"/>
      </concept>
    </concept>
    <concept>
      <modifierExtension url="http://hl7.org/fhir/ExtensionDefinition/valueset-subsumes">
        <valueCode value="AffiliateRealms"/>
      </modifierExtension>
      <modifierExtension url="http://hl7.org/fhir/ExtensionDefinition/valueset-subsumes">
        <valueCode value="GB"/>
      </modifierExtension>
      <code value="NamespaceRealms"/>
      <abstract value="true"/>
      <display value="namespace realms"/>
      <definition value="Description: Codes that can be used in the &quot;realm&quot; portion of HL7 v3 artifact
         identifiers."/>
      <concept>
        <code value="ZZ"/>
        <abstract value="false"/>
        <display value="Localized Version"/>
        <definition value="Description: An artifact created for local use only.  This realm namespace has no owning
           affiliate.  Its use is uncontrolled, i.e. anyone can create artifacts using this realm
           namespace.  Because of this, there is a significant likelihood of artifact identifier
           collisions.  Implementers are encouraged to register their artifacts under an affiliate
           owned and controlled namespace to avoid such collision problems where possible."/>
      </concept>
    </concept>
  </define>
</ValueSet>

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.