Terminology Change Set Exchange
1.0.0 - STU1 International flag

Terminology Change Set Exchange, published by HL7 International / Terminology Infrastructure. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/termchangeset-ig/ and changes regularly. See the Directory of published versions

FHIR Limitiations

Page standards status: Informative

FHIR Limitations and Possible Solutions

Recognizing that FHIR's Terminology resources were not designed to enable collaboration between terminology authoring entities, there are several limitations implementers should be aware of when using FHIR for Terminology Change Set Exchange. Many of these limitations can be addressed through FHIR's inherent extensibility, but others are more difficult to address.

Limitations addressed via Extensions

Concept description attributes

These are secondary attributes adding context to concept designations, utilized at the CodeSystem.concept.designation element level.

  • Concept designation dialect - to distinguish between multiple designations used in different langauges or dialects. For example, the SNOMED CT term 271737000 | Anemia (disorder) has a designation "Anemia" in the United States English dialect, but "Anaemia" in the Great Britain English dialect.
  • Concept designation case sensitivity - to identify the case sensitivity applicable to the designation to retain its meaning. For example, "HIV" (for Human Immunodeficiency Virus) must remain uppercase and therefore is "Case Sensitive", whereas "diabetes mellitus" can be shown as "Diabetes Mellitus," "DIABETES MELLITUS," etc. and therefore is "Case Insensitive".
  • Concept designation acceptability - to identify the relative suitability across several designations for a given concept. For example, for the SNOMED CT concept 22298006 |Myocardial infarction (disorder), a "Preferred" designation for use is "Myocardial infarction", but "Heart attack" is an "Acceptable" designation.

Concept property attributes

These are secondary attributes adding context to properties for concepts, utilized at the CodeSystem.concept.property element level.

Other Limitations

Standardization of CodeSystem.property codes

HL7 has published some guidance on codes to use to represent properties from several terminologies (see: SNOMED CT Properties and LOINC Properties), but widespread implementations appear inconsistent. Additionally, any terminology exchange that lacks this standardization will likely struggle to convey semantic detail for concepts.

Change Sets with granularity below the concept level

As currently modelled, the smallest change that can be represented in a CodeSystem resource is a full "snapshot" representation of a Concept from that CodeSystem. If for example, the only change made to a Concept was a change to one of it's designation values, implementations would need to include the full semantic detail for that Concept in a Change Set. The specific change made would only be apparent via a comparison to the prior representation of the Concept.

Provenance to small changes

In the situation where multiple small changes were authored by several individuals, there are limits to how those changes can be referenced via a Provenance resource. Recognizing that with FHIR R5 a common extension was published allowing Provenances to reference elements within a resource (https://hl7.org/fhir/extensions/StructureDefinition-targetElement.html), even this approach is limited to those elements that have id attributes. In a CodeSystem change set instance, the most granular structure a Provenance could refer to using this approach would be an individual CodeSystem.concept, and changes specifically to sub-elements such as a Concept designation can not be indicated in this way.