Introduction

Custodians of standardized terminologies have developed rich semantic frameworks that can be used to interact with individual concepts in an elegant fashion, utilizing the relationships between terms to dynamically adjust user interfaces or derive clinical patterns. Today, these frameworks are distributed via proprietary formats and are tailored to the specific source terminology. As a result, any system looking to utilize the full semantic power of the terminology must build customized data pipelines to process those formats.

This Implementation Guide (IG) provides profiles and implementation guidance on utilizing the CodeSystem resource for exchanging terminology change sets that include full semantic detail from the source terminology. It also addresses exchanging terminology change sets containing provisional concepts not yet incorporated in source terminologies, such as those requiring rapid distribution during a pandemic-response context. Analysis of semantic detail to include in a change set is informed by the Tinkar Standardized Terminology Knowledgebase Reference Model, and mappings from that architecture are included on CodeSystem profiles.

Technical Overview

The design for Terminology Change Sets is primarily a robust utilization of the CodeSystem resource's modelling for CodeSystem.concept and CodeSystem.property to convey not just the concept identifiers and descriptions, but the full semantic design for each concept. Additionally, a Provenance instance is used to provide insight into the creation of the Terminology Change Set, particularly using Provenance.what to reference the baseline Terminology from which the Change Set was derived.

The main sections of this IG are:

• ​ Guidance - this page provides best practices and considerations for implementation of Terminology Change Sets.
• Background - these pages provide background on how incremental releases of Terminologies are currently handled, the need for a standardized Terminology Change Set format in FHIR, and an inventory of known FHIR limitations related to the inclusion of full semantic detail for terminology concepts.
• FHIR Artifacts - this page provides the central source for all Profiles, Extensions, ValueSets, and Examples used in this IG.
• Tinkar Reference Model - these pages provide context and background for the Tinkar Reference Model, which informed the analysis and design for Terminology Change Set profiles.
• Downloads - this page provides links to downloadable artifacts.
• Change Log - this page documents the changes across the versions of the Terminology Change Set IG.

Credits

This implementation guide was made possible by the thoughtful contributions of the following people and organizations:

• Keith Campbell MD PhD, US Food and Drug Administration (FDA)
• Marti Velezis, Sonrisa Consulting
• Russell Ott, Deloitte Consulting LLP
• Raja Cholan, Deloitte Consulting LLP
• Matthew Deitz, Deloitte Consulting LLP
• Bimla Siwakoti, Deloitte Consulting LLP
• Jess Bota, Apelon
• Andrea Pitkus PhD MLS(ASCP)^CM FAMIA, University of Wisconsin School of Medicine and Public Health
• Carol Macumber, Clinical Architecture

Cross Version Analysis

Dependency Table

Package hl7.fhir.uv.extensions.r5#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Globals Statements

There are no Global profiles defined

IP Statements

No use of external IP