Extensions for Using Data Elements from FHIR R5 in FHIR STU3
0.1.0 - STU
Extensions for Using Data Elements from FHIR R5 in FHIR STU3
0.1.0 - STU
Extensions for Using Data Elements from FHIR R5 in FHIR STU3 - Downloaded Version null See the Directory of published versions
| Official URL: http://hl7.org/fhir/uv/xver/ConceptMap/R5-CodeSystem-element-map-to-R3 | Version: 0.1.0 | |||
| Standards status: Trial-use | Maturity Level: 0 | Computable Name: R5CodeSystemElementMapToR3 | ||
This ConceptMap represents cross-version mappings for elements from a FHIR R5 CodeSystem to FHIR STU3.
Mapping from http://hl7.org/fhir/5.0 to http://hl7.org/fhir/3.0
Group 1 Mapping from http://hl7.org/fhir/StructureDefinition/CodeSystem|5.0.0 to http://hl7.org/fhir/StructureDefinition/CodeSystem|3.0.2
| Source Code | Relationship | Target Code | Comment |
| CodeSystem.meta (meta) | is equivalent to | CodeSystem.meta | Element `CodeSystem.meta` is mapped to FHIR STU3 element `CodeSystem.meta` as `Equivalent`. |
| CodeSystem.implicitRules (implicitRules) | is equivalent to | CodeSystem.implicitRules | Element `CodeSystem.implicitRules` is mapped to FHIR STU3 element `CodeSystem.implicitRules` as `Equivalent`. Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of its narrative along with other profiles, value sets, etc. |
| CodeSystem.language (language) | is equivalent to | CodeSystem.language | Element `CodeSystem.language` is mapped to FHIR STU3 element `CodeSystem.language` as `Equivalent`. Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute). |
| CodeSystem.text (text) | is equivalent to | CodeSystem.text | Element `CodeSystem.text` is mapped to FHIR STU3 element `CodeSystem.text` as `Equivalent`. Contained resources do not have a narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later. |
| CodeSystem.contained (contained) | is equivalent to | CodeSystem.contained | Element `CodeSystem.contained` is mapped to FHIR STU3 element `CodeSystem.contained` as `SourceIsBroaderThanTarget`. This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags in their meta elements, but SHALL NOT have security labels. |
| CodeSystem.url (url) | is equivalent to | CodeSystem.url | Element `CodeSystem.url` is mapped to FHIR STU3 element `CodeSystem.url` as `Equivalent`. Can be a urn:uuid: or a urn:oid: but real http: addresses are preferred. Multiple instances may share the same URL if they have a distinct version. The determination of when to create a new version of a resource (same url, new version) vs. defining a new artifact is up to the author. Considerations for making this decision are found in [Technical and Business Versions](https://hl7.org/fhir/resource..html#versions). In some cases, the resource can no longer be found at the stated url, but the url itself cannot change. Implementations can use the [meta.source](https://hl7.org/fhir/resou.html#meta) element to indicate where the current master source of the resource can be found. |
| CodeSystem.identifier (identifier) | is equivalent to | CodeSystem.identifier | Element `CodeSystem.identifier` is mapped to FHIR STU3 element `CodeSystem.identifier` as `SourceIsBroaderThanTarget`. Typically, this is used for identifiers that can go in an HL7 V3 II (instance identifier) data type, and can then identify this code system outside of FHIR, where it is not possible to use the logical URI. Note that HL7 defines at least three identifiers for many of its code systems - the FHIR canonical URL, the OID and the V2 Table 0396 mnemonic code. |
| CodeSystem.version (version) | is equivalent to | CodeSystem.version | Element `CodeSystem.version` is mapped to FHIR STU3 element `CodeSystem.version` as `Equivalent`. There may be different code system instances that have the same identifier but different versions. The version can be appended to the url in a reference to allow a reference to a particular business version of the code system with the format [url]|[version]. The version SHOULD NOT contain a '#' - see [Business Version](https://hl7.org/fhir/resource.h.html#bv-format). |
| CodeSystem.name (name) | is equivalent to | CodeSystem.name | Element `CodeSystem.name` is mapped to FHIR STU3 element `CodeSystem.name` as `Equivalent`. The name is not expected to be globally unique. The name should be a simple alphanumeric type name to ensure that it is machine-processing friendly. |
| CodeSystem.title (title) | is equivalent to | CodeSystem.title | Element `CodeSystem.title` is mapped to FHIR STU3 element `CodeSystem.title` as `Equivalent`. This name does not need to be machine-processing friendly and may contain punctuation, white-space, etc. |
| CodeSystem.status (status) | is equivalent to | CodeSystem.status | Element `CodeSystem.status` is mapped to FHIR STU3 element `CodeSystem.status` as `Equivalent`. Allows filtering of code systems that are appropriate for use versus not. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization). |
| CodeSystem.experimental (experimental) | is equivalent to | CodeSystem.experimental | Element `CodeSystem.experimental` is mapped to FHIR STU3 element `CodeSystem.experimental` as `Equivalent`. Allows filtering of code systems that are appropriate for use versus not. |
| CodeSystem.date (date) | is equivalent to | CodeSystem.date | Element `CodeSystem.date` is mapped to FHIR STU3 element `CodeSystem.date` as `Equivalent`. The date is often not tracked until the resource is published, but may be present on draft content. Note that this is not the same as the resource last-modified-date, since the resource may be a secondary representation of the code system. Additional specific dates may be added as extensions or be found by consulting Provenances associated with past versions of the resource. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization). |
| CodeSystem.publisher (publisher) | is equivalent to | CodeSystem.publisher | Element `CodeSystem.publisher` is mapped to FHIR STU3 element `CodeSystem.publisher` as `Equivalent`. Usually an organization but may be an individual. The publisher (or steward) of the code system is the organization or individual primarily responsible for the maintenance and upkeep of the code system. This is not necessarily the same individual or organization that developed and initially authored the content. The publisher is the primary point of contact for questions or issues with the code system. This item SHOULD be populated unless the information is available from context. |
| CodeSystem.contact (contact) | maps to wider concept | CodeSystem.contact | Element `CodeSystem.contact` is mapped to FHIR STU3 element `CodeSystem.contact` as `SourceIsBroaderThanTarget`. The mappings for `CodeSystem.contact` do not cover the following types: ContactDetail. The mappings for `CodeSystem.contact` do not cover the following types based on type expansion: name, telecom. May be a web site, an email address, a telephone number, etc. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization). |
| CodeSystem.description (description) | is equivalent to | CodeSystem.description | Element `CodeSystem.description` is mapped to FHIR STU3 element `CodeSystem.description` as `Equivalent`. This description can be used to capture details such as comments about misuse, instructions for clinical use and interpretation, literature references, examples from the paper world, etc. It is not a rendering of the code system as conveyed in the 'text' field of the resource itself. This item SHOULD be populated unless the information is available from context (e.g. the language of the code system is presumed to be the predominant language in the place the code system was created). |
| CodeSystem.useContext (useContext) | is equivalent to | CodeSystem.useContext | Element `CodeSystem.useContext` is mapped to FHIR STU3 element `CodeSystem.useContext` as `Equivalent`. When multiple useContexts are specified, there is no expectation that all or any of the contexts apply. |
| CodeSystem.jurisdiction (jurisdiction) | is equivalent to | CodeSystem.jurisdiction | Element `CodeSystem.jurisdiction` is mapped to FHIR STU3 element `CodeSystem.jurisdiction` as `Equivalent`. Element `CodeSystem.jurisdiction` has been flagged as deprecated. It may be possible for the code system to be used in jurisdictions other than those for which it was originally designed or intended. DEPRECATION NOTE: For consistency, implementations are encouraged to migrate to using the new 'jurisdiction' code in the useContext element. (I.e. useContext.code indicating http://terminology.hl7.org/CodeSystem/usage-context-type#jurisdiction and useContext.valueCodeableConcept indicating the jurisdiction.) |
| CodeSystem.purpose (purpose) | is equivalent to | CodeSystem.purpose | Element `CodeSystem.purpose` is mapped to FHIR STU3 element `CodeSystem.purpose` as `Equivalent`. This element does not describe the usage of the code system. Instead, it provides traceability of ''why'' the resource is either needed or ''why'' it is defined as it is. This may be used to point to source materials or specifications that drove the structure of this code system. |
| CodeSystem.copyright (copyright) | is equivalent to | CodeSystem.copyright | Element `CodeSystem.copyright` is mapped to FHIR STU3 element `CodeSystem.copyright` as `Equivalent`. ... Sometimes, the copyright differs between the code system and the codes that are included. The copyright statement should clearly differentiate between these when required. |
| CodeSystem.caseSensitive (caseSensitive) | is equivalent to | CodeSystem.caseSensitive | Element `CodeSystem.caseSensitive` is mapped to FHIR STU3 element `CodeSystem.caseSensitive` as `Equivalent`. If this value is missing, then it is not specified whether a code system is case sensitive or not. When the rule is not known, Postel's law should be followed: produce codes with the correct case, and accept codes in any case. This element is primarily provided to support validation software. |
| CodeSystem.valueSet (valueSet) | is equivalent to | CodeSystem.valueSet | Element `CodeSystem.valueSet` is mapped to FHIR STU3 element `CodeSystem.valueSet` as `Equivalent`. The definition of the value set SHALL include all codes from this code system, independent of concept status, and only codes from this code system. It SHALL be immutable, and operations SHOULD support validation of any allowed code compositions. |
| CodeSystem.hierarchyMeaning (hierarchyMeaning) | is equivalent to | CodeSystem.hierarchyMeaning | Element `CodeSystem.hierarchyMeaning` is mapped to FHIR STU3 element `CodeSystem.hierarchyMeaning` as `Equivalent`. Note that other representations might have a different hierarchy or none at all, and represent the information using properties. |
| CodeSystem.compositional (compositional) | is equivalent to | CodeSystem.compositional | Element `CodeSystem.compositional` is mapped to FHIR STU3 element `CodeSystem.compositional` as `Equivalent`. Note that the code system resource does not define what the compositional grammar is, only whether or not there is one. |
| CodeSystem.versionNeeded (versionNeeded) | is equivalent to | CodeSystem.versionNeeded | Element `CodeSystem.versionNeeded` is mapped to FHIR STU3 element `CodeSystem.versionNeeded` as `Equivalent`. Best practice is that code systems do not redefine concepts, or that if concepts are redefined, a new code system definition is created. But this is not always possible, so some code systems may be defined as 'versionNeeded'. Most code systems occasionally refine the displays defined for concepts between versions. Contexts in which the concept display values are validated may require that the version be specified for some code systems irrespective of the value of this property. |
| CodeSystem.content (content) | maps to wider concept | CodeSystem.content | Element `CodeSystem.content` is mapped to FHIR STU3 element `CodeSystem.content` as `SourceIsBroaderThanTarget`. |
| CodeSystem.count (count) | is equivalent to | CodeSystem.count | Element `CodeSystem.count` is mapped to FHIR STU3 element `CodeSystem.count` as `Equivalent`. The count of concepts defined in this resource cannot be more than this value but may be less for several reasons - see the content element. |
| CodeSystem.filter (filter) | maps to wider concept | CodeSystem.filter | Element `CodeSystem.filter` is mapped to FHIR STU3 element `CodeSystem.filter` as `Equivalent`. Note that filters defined in code systems usually require custom code on the part of any terminology engine that will make them available for use in value set filters. For this reason, they are generally only seen in high value published terminologies. |
| CodeSystem.filter.code (code) | is equivalent to | CodeSystem.filter.code | Element `CodeSystem.filter.code` is mapped to FHIR STU3 element `CodeSystem.filter.code` as `Equivalent`. |
| CodeSystem.filter.description (description) | is equivalent to | CodeSystem.filter.description | Element `CodeSystem.filter.description` is mapped to FHIR STU3 element `CodeSystem.filter.description` as `Equivalent`. |
| CodeSystem.filter.operator (operator) | maps to wider concept | CodeSystem.filter.operator | Element `CodeSystem.filter.operator` is mapped to FHIR STU3 element `CodeSystem.filter.operator` as `SourceIsBroaderThanTarget`. |
| CodeSystem.filter.value (value) | is equivalent to | CodeSystem.filter.value | Element `CodeSystem.filter.value` is mapped to FHIR STU3 element `CodeSystem.filter.value` as `Equivalent`. |
| CodeSystem.property (property) | maps to wider concept | CodeSystem.property | Element `CodeSystem.property` is mapped to FHIR STU3 element `CodeSystem.property` as `Equivalent`. Multiple occurrences of CodeSystem.concept.property may occur for a CodeSystem.property where CodeSystem.concept.property.code is the same and CodeSystem.concept.property.value differs. For example: multiple designations for a single concept. |
| CodeSystem.property.code (code) | is equivalent to | CodeSystem.property.code | Element `CodeSystem.property.code` is mapped to FHIR STU3 element `CodeSystem.property.code` as `Equivalent`. |
| CodeSystem.property.uri (uri) | is equivalent to | CodeSystem.property.uri | Element `CodeSystem.property.uri` is mapped to FHIR STU3 element `CodeSystem.property.uri` as `Equivalent`. |
| CodeSystem.property.description (description) | is equivalent to | CodeSystem.property.description | Element `CodeSystem.property.description` is mapped to FHIR STU3 element `CodeSystem.property.description` as `Equivalent`. |
| CodeSystem.property.type (type) | maps to wider concept | CodeSystem.property.type | Element `CodeSystem.property.type` is mapped to FHIR STU3 element `CodeSystem.property.type` as `SourceIsBroaderThanTarget`. |
| CodeSystem.concept (concept) | maps to wider concept | CodeSystem.concept | Element `CodeSystem.concept` is mapped to FHIR STU3 element `CodeSystem.concept` as `Equivalent`. If this is empty, it means that the code system resource does not represent the content of the code system. |
| CodeSystem.concept.code (code) | is equivalent to | CodeSystem.concept.code | Element `CodeSystem.concept.code` is mapped to FHIR STU3 element `CodeSystem.concept.code` as `Equivalent`. |
| CodeSystem.concept.display (display) | is equivalent to | CodeSystem.concept.display | Element `CodeSystem.concept.display` is mapped to FHIR STU3 element `CodeSystem.concept.display` as `Equivalent`. |
| CodeSystem.concept.definition (definition) | is equivalent to | CodeSystem.concept.definition | Element `CodeSystem.concept.definition` is mapped to FHIR STU3 element `CodeSystem.concept.definition` as `Equivalent`. |
| CodeSystem.concept.designation (designation) | maps to wider concept | CodeSystem.concept.designation | Element `CodeSystem.concept.designation` is mapped to FHIR STU3 element `CodeSystem.concept.designation` as `Equivalent`. Concepts have both a ```display``` and an array of ```designation```. The display is equivalent to a special designation with an implied ```designation.use``` of "primary code" and a language equal to the [Resource Language](https://hl7.org/fhir/resource..html#language). |
| CodeSystem.concept.designation.language (language) | is equivalent to | CodeSystem.concept.designation.language | Element `CodeSystem.concept.designation.language` is mapped to FHIR STU3 element `CodeSystem.concept.designation.language` as `Equivalent`. In the absence of a language, the resource language applies. |
| CodeSystem.concept.designation.use (use) | is equivalent to | CodeSystem.concept.designation.use | Element `CodeSystem.concept.designation.use` is mapped to FHIR STU3 element `CodeSystem.concept.designation.use` as `Equivalent`. If no use is provided, the designation can be assumed to be suitable for general display to a human user. |
| CodeSystem.concept.designation.value (value) | is equivalent to | CodeSystem.concept.designation.value | Element `CodeSystem.concept.designation.value` is mapped to FHIR STU3 element `CodeSystem.concept.designation.value` as `Equivalent`. |
| CodeSystem.concept.property (property) | maps to wider concept | CodeSystem.concept.property | Element `CodeSystem.concept.property` is mapped to FHIR STU3 element `CodeSystem.concept.property` as `Equivalent`. |
| CodeSystem.concept.property.code (code) | is equivalent to | CodeSystem.concept.property.code | Element `CodeSystem.concept.property.code` is mapped to FHIR STU3 element `CodeSystem.concept.property.code` as `Equivalent`. |
| CodeSystem.concept.property.value[x] (value[x]) | maps to wider concept | CodeSystem.concept.property.value[x] | Element `CodeSystem.concept.property.value[x]` is mapped to FHIR STU3 element `CodeSystem.concept.property.value[x]` as `SourceIsBroaderThanTarget`. The mappings for `CodeSystem.concept.property.value[x]` do not cover the following types: decimal. The target context `CodeSystem.concept.property.value[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `CodeSystem.concept.property`. |
| CodeSystem.concept.concept (concept) | is equivalent to | CodeSystem.concept.concept | Element `CodeSystem.concept.concept` is mapped to FHIR STU3 element `CodeSystem.concept.concept` as `Equivalent`. |
Group 2 Mapping from http://hl7.org/fhir/StructureDefinition/CodeSystem|5.0.0 to R5: contact additional typesversion: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CodeSystem.contact (contact) | is equivalent to | Extension (R5: contact additional types) | Element `CodeSystem.contact` is mapped to FHIR STU3 element `CodeSystem.contact` as `SourceIsBroaderThanTarget`. The mappings for `CodeSystem.contact` do not cover the following types: ContactDetail. The mappings for `CodeSystem.contact` do not cover the following types based on type expansion: name, telecom. May be a web site, an email address, a telephone number, etc. See guidance around (not) making local changes to elements [here](https://hl7.org/fhir/canonicalreso.html#localization). |
Group 3 Mapping from http://hl7.org/fhir/StructureDefinition/CodeSystem|5.0.0 to R5: not-present | example | fragment | complete | supplementversion: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CodeSystem.content (content) | is equivalent to | Extension (R5: not-present | example | fragment | complete | supplement) | Element `CodeSystem.content` is mapped to FHIR STU3 element `CodeSystem.content` as `SourceIsBroaderThanTarget`. |
Group 4 Mapping from http://hl7.org/fhir/StructureDefinition/CodeSystem|5.0.0 to R5: Canonical URL of Code System this adds designations and properties to (new)version: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CodeSystem.supplements (supplements) | is equivalent to | Extension (R5: Canonical URL of Code System this adds designations and properties to (new)) | Element `CodeSystem.supplements` has a context of CodeSystem based on following the parent source element upwards and mapping to `CodeSystem`. Element `CodeSystem.supplements` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). The most common use of a code system supplement is to add additional language support. |
Group 5 Mapping from http://hl7.org/fhir/StructureDefinition/CodeSystem|5.0.0 to R5: = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | existsversion: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CodeSystem.filter.operator (operator) | is equivalent to | Extension (R5: = | is-a | descendent-of | is-not-a | regex | in | not-in | generalizes | child-of | descendent-leaf | exists) | Element `CodeSystem.filter.operator` is mapped to FHIR STU3 element `CodeSystem.filter.operator` as `SourceIsBroaderThanTarget`. |
Group 6 Mapping from http://hl7.org/fhir/StructureDefinition/CodeSystem|5.0.0 to R5: code | Coding | string | integer | boolean | dateTime | decimalversion: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CodeSystem.property.type (type) | is equivalent to | Extension (R5: code | Coding | string | integer | boolean | dateTime | decimal) | Element `CodeSystem.property.type` is mapped to FHIR STU3 element `CodeSystem.property.type` as `SourceIsBroaderThanTarget`. |
Group 7 Mapping from http://hl7.org/fhir/StructureDefinition/CodeSystem|5.0.0 to R5: Additional ways how this designation would be used (new)version: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CodeSystem.concept.designation.additionalUse (additionalUse) | maps to wider concept | Extension (R5: Additional ways how this designation would be used (new)) | Element `CodeSystem.concept.designation.additionalUse` has a context of CodeSystem.concept.designation based on following the parent source element upwards and mapping to `CodeSystem`. Element `CodeSystem.concept.designation.additionalUse` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element). This was added rather than increasing the cardinality of .use to 0..* in order to maintain backward compatibility. |
Group 8 Mapping from http://hl7.org/fhir/StructureDefinition/CodeSystem|5.0.0 to R5: value additional typesversion: 0.1.0)
| Source Code | Relationship | Target Code | Comment |
| CodeSystem.concept.property.value[x] (value[x]) | is equivalent to | Extension (R5: value additional types) | Element `CodeSystem.concept.property.value[x]` is mapped to FHIR STU3 element `CodeSystem.concept.property.value[x]` as `SourceIsBroaderThanTarget`. The mappings for `CodeSystem.concept.property.value[x]` do not cover the following types: decimal. The target context `CodeSystem.concept.property.value[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `CodeSystem.concept.property`. |
IG © 2025+ FHIR Infrastructure. Package hl7.fhir.uv.xver-r5.r3#0.1.0 based on FHIR 3.0.2. Generated 2026-03-20
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change