Background: HL7 FHIR terminological services (TS) are a valuable tool towards better healthcare interoperability, but require representations of terminologies using FHIR resources. As most terminologies are not natively distributed using FHIR resources, converters are needed. Large-scale FHIR projects, especially those with a national or even an international scope, define enormous numbers of value sets and reference many complex code systems, which must be regularly updated in TS and other systems. This necessitates a flexible, scalable and efficient provision of these artifacts. This work aims to develop a comprehensive, extensible and accessible toolkit for FHIR terminology conversion.
Implementation: Based on the prevalent HL7 FHIR Shorthand (FSH) specification, a converter toolkit, called BabelFSH, was created that utilizes an adaptable plugin architecture to separate the definition of content from that of the needed declarative metadata. The development process was guided by formalized design goals.
Results: All eight design goals were addressed by BabelFSH. Validation of the systems’ performance and completeness was exemplarily demonstrated using Alpha-ID-SE, an important terminology used for diagnosis coding especially of rare diseases within Germany. The tool is now used extensively within the content delivery pipeline for a central FHIR TS with a national scope within the German Medical Informatics Initiative and Network University Medicine.
Discussion: The first development focus was geared towards the requirements of the central research FHIR TS for the federated FHIR infrastructure in Germany, and has proven to be very useful towards that goal. Opportunities for further improvement were identified in the validation process especially, as the validation messages are currently imprecise at times. The design of the application lends itself to the implementation of further use cases, such as direct connectivity to legacy systems for catalog conversion to FHIR.
Conclusions: The developed BabelFSH tool is a novel, powerful and open-source approach to making heterogenous sources of terminological knowledge accessible as FHIR resources, thus aiding semantic interoperability in healthcare in general.
@article{wiedekopf_babelfshtoolkit_2025,title={{BabelFSH}—A Toolkit for an Effective {HL}7 {FHIR}-based Terminology Provision},rights={https://creativecommons.org/licenses/by/4.0/},url={https://www.researchsquare.com/article/rs-6992162/v1},doi={10.21203/rs.3.rs-6992162/v1},publisher={In Review},author={Wiedekopf, Joshua and Ohlsen, Tessa and Kock-Schoppenhauer, Ann-Kristin and Ingenerf, Josef},journal={Journal of Biomedical Semantics},abbr={J Biomed Semant},urldate={2025-08-13},date={2025-07-23},language={en}}
SHTI
Implementation of HL7 FHIR-Based Terminology Services for a National Federated Health Research Infrastructure
Editors: Rainer Röhrig, Thomas Ganslandt, Klaus Jung, Ann-Kristin Kock-Schoppenhauer, Jochem König, Ulrich Sax, Martin Sedlmayr, Cord Spreckelsen, and Antonia Zapf
Introduction: As part of the German Medical Informatics Initiative (MII) and Network University Medicine (NUM), a central research terminology service (TS) is provided by the Service Unit Terminology Services (SU-TermServ). This HL7 FHIR-based service depends on the timely and comprehensive availability of FHIR terminology resources to provide the necessary interactions for the distributed MII/NUM infrastructure. While German legislation has recently instituted a national terminology service for medical classifications and terminologies, the scope of the MII and NUM extends beyond routine patient care, encompassing the need for supplementary or specialized services and terminologies that are not commonly utilized elsewhere.
Methods: The SU-TermServ’s processes are based on established FHIR principles and the recently-proposed Canonical Resources Management Infrastructure Implementation Guide, which are outlined in this paper.
Results: The strategy and processes implemented within the project can deliver the needed resources both to the central FHIR terminology service, but also to the local data integration centers, in a transparent and consistent fashion. The service currently provides approximately 7000 resources to users via the standardized FHIR API.
Conclusion: The professionalized distribution and maintenance of these terminological resources and the provision of a powerful TS implementation aids both the development of the Core Data Set and the data integration centers, and ultimately biomedical researchers requesting access to this rich data.
@article{wiedekopf2025ImplementationHL7FHIRBaseda,title={Implementation of {{HL7 FHIR-Based Terminology Services}} for a {{National Federated Health Research Infrastructure}}},booktitle={Studies in {{Health Technology}} and {{Informatics}}},author={Wiedekopf, Joshua and Ohlsen, Tessa and Koops, Alan and Kock-Schoppenhauer, Ann-Kristin and Adnan, Muhammad and Ballout, Sarah and Philipzik, Nele and Beyan, Oya and Beyer, Andreas and Marschollek, Michael and Ingenerf, Josef},editor={Röhrig, Rainer and Ganslandt, Thomas and Jung, Klaus and Kock-Schoppenhauer, Ann-Kristin and König, Jochem and Sax, Ulrich and Sedlmayr, Martin and Spreckelsen, Cord and Zapf, Antonia},year={2025},month=sep,day={03},publisher={IOS Press},doi={10.3233/SHTI251396},abbr={SHTI},language={en},featured=true,slides={gmds2025/GMDS2025_SU-TermServ-DeliveringContent.pdf}}
SHTI
Mettertron ⎼ Bridging Metadata Repositories and Terminology Servers
To provide clinical data in distributed research architectures, a fundamental challenge involves defining and distributing suitable metadata within Metadata Repositories. Especially for structured data, data elements need to be bound against suitable terminologies; otherwise, other systems will only be able to interpret the data with complex and error-prone manual involvement. As current Metadata Repository implementations lack support for querying externally defined terminologies in FHIR terminology servers, we propose an intermediate solution that uses appropriate annotations on metadata elements to allow run-time Terminology Services mediated queries of that metadata. This allows a very clear separation of concerns between the two related systems, greatly simplifying terminological maintenance. The system performed well in a prototypical deployment.
@article{schladetzky_wiedekopf_mettertron_2023,title={{Mettertron ⎼ Bridging Metadata Repositories and Terminology Servers}},author={Schladetzky, Jan and Kock-Schoppenhauer, Ann-Kristin and Drenkhahn, Cora and Ingenerf, Josef and Wiedekopf, Joshua},journal={Studies in Health Informatics and Technology},conference={GMDS 2023},inpress={1},year={2023},month=sep,abbr={SHTI},language={en},doi={10.3233/SHTI230721},slides={ gmds2023/schladetzky-mettertron.pdf }}
SHTI
TermiCron – Bridging the Gap Between FHIR Terminology Servers and Metadata Repositories
The large variability of data models, specifications, and interpretations of data elements is particular to the healthcare domain. Achieving semantic interoperability is the first step to enable reuse of healthcare data. To ensure interoperability, metadata repositories (MDR) are increasingly used to manage data elements on a structural level, while terminology servers (TS) manage the ontologies, terminologies, coding systems and value sets on a semantic level. In practice, however, this strict separation is not always followed; instead, semantical information is stored and maintained directly in the MDR, as a link between both systems is missing. This may be reasonable up to a certain level of complexity, but it quickly reaches its limitations with increasing complexity. The goal of this approach is to combine both components in a compatible manner. We present TermiCron, a synchronization engine that provides synchronized value sets from TS in MDRs, including versioning and annotations. Prototypical results were shown for the terminology server Ontoserver and two established MDR systems. Bridging the semantic and structural gap between the two infrastructure components, this approach enables shared use of metadata and reuse of corresponding health information by establishing a clear separation of the two systems and thus serves to strengthen reuse as well as to increase quality.
@article{wiedekopf_termicron_2022,author={Wiedekopf, Joshua and Ulrich, Hannes and Drenkhahn, Cora and Kock-Schoppenhauer, Ann-Kristin and Ingenerf, Josef},journal={Studies in Health Technology and Informatics},conference={{MEDINFO} 2021},publisher={{IOS} Press},title={{TermiCron} {\textendash} Bridging the Gap Between {FHIR} Terminology Servers and Metadata Repositories},year={2022},month=jun,doi={10.3233/shti220034},slides={medinfo2021/TermiCron_v1.pdf},recording={https://www.youtube.com/watch?v=7L08Sh-1XxY},language={en},abbr={SHTI}}
SHTI
TerminoDiff – Detecting Semantic Differences in HL7 FHIR CodeSystems
While HL7 FHIR and its terminology package have seen a rapid uptake by the research community, in no small part due to the wide availability of tooling and resources, there are some areas where tool availability is still lacking. In particular, the comparison of terminological resources, which supports the work of terminologists and implementers alike, has not yet been sufficiently addressed. Hence, we present TerminoDiff, an application to semantically compare FHIR R4 CodeSystem resources. Our tool considers differences across all levels required, i.e. metadata and concept differences, as well as differences in the edge graph, and surfaces them in a visually digestible fashion.
@article{wiedekopf_terminodiff_2022,author={Wiedekopf, Joshua and Drenkhahn, Cora and Rosenau, Lorenz and Ulrich, Hannes and Kock-Schoppenhauer, Ann-Kristin and Ingenerf, Josef},journal={Studies in Health Technology and Informatics},conference={Medical Informatics Europe 2022},publisher={{IOS} Press},title={{TerminoDiff} {\textendash} Detecting Semantic Differences in {HL}7 {FHIR} {CodeSystems}},year={2022},month=may,doi={10.3233/shti220475},language={en},slides={mie2022/TerminoDiff-MIE-2022-JoshuaWiedekopf-1.1.pdf},abbr={SHTI}}
Data integration and exchange are becoming more crucial with the increasing amount of distributed systems and ever-growing amounts of data. This need is also widely known in medical research and not yet comprehensively solved. Practical implementation steps will demonstrate the different challenges in the context of the National Medical Informatics Initiative in Germany. Top-down versus bottom-up approaches as general methods of standard-based data integration in healthcare will be discussed and illustrated in the process of building up Medical Data Integration Centers. As practical examples, the use cases Infection Control, Cardiology, and Molecular Tumor Board, will be presented. Finally, limitations that prevent the use of theoretically recommended data integration methods in the particular field of medical informatics are illustrated.
@article{kockschopp_medical_2021,location={Cham},title={Medical Data Engineering - Theory and Practice},volume={1481},isbn={978-3-030-87656-2 978-3-030-87657-9},url={https://link.springer.com/10.1007/978-3-030-87657-9_21},pages={269--284},journal={Advances in Model and Data Engineering in the Digitalization Era},publisher={Springer International Publishing},author={Kock-Schoppenhauer, Ann-Kristin and Schreiweis, Björn and Ulrich, Hannes and Reimer, Niklas and Wiedekopf, Joshua and Kinast, Benjamin and Busch, Hauke and Bergh, Björn and Ingenerf, Josef},editor={Bellatreche, Ladjel and Chernishev, George and Corral, Antonio and Ouchani, Samir and Vain, Jüri},year={2021},month=oct,langid={english},doi={10.1007/978-3-030-87657-9_21},note={Series Title: Communications in Computer and Information Science},language={en}}
SHTI
Providing ART-DECOR ValueSets via FHIR Terminology Servers - A Technical Report
To ensure semantic interoperability within healthcare systems, using common, curated terminological systems to identify relevant concepts is of fundamental importance. The HL7 FHIR standard specifies means of modelling terminological systems and appropriate ways of accessing and querying these artefacts within a terminology server. Hence, initiatives towards healthcare interoperability like IHE specify not only software interfaces, but also common codes in the form of value sets and code systems. The way in which these coding tables are provided is not necessarily compatible to the current version of the HL7 FHIR specification and therefore cannot be used with current HL7 FHIR-based terminology servers. This work demonstrates a conversion of terminological resources specified by the Integrating the Healthcare Initiative in the ART-DECOR platform, partly available in HL7 FHIR, to ensure that they can be used within a HL7 FHIR-based terminological server. The approach itself can be used for other terminological resources specified within ART-DECOR but can also be used as the basis for other code-driven conversions of proprietary coding schemes.
@article{wiedekopf_artdecor_2021,title={Providing {ART}-{DECOR} {ValueSets} via {FHIR} Terminology Servers - A Technical Report},isbn={978-1-64368-206-8 978-1-64368-207-5},url={https://ebooks.iospress.nl/doi/10.3233/SHTI210550},journal={Studies in Health Technology and Informatics},conference={GMDS 2021},publisher={{IOS} Press},author={Wiedekopf, Joshua and Drenkhahn, Cora and Ulrich, Hannes and Kock-Schoppenhauer, Ann-Kristin and Ingenerf, Josef},editor={Röhrig, Rainer and Beißbarth, Tim and König, Jochem and Ose, Claudia and Rauch, Geraldine and Sax, Ulrich and Schreiweis, Björn and Sedlmayr, Martin},year={2021},month=sep,doi={10.3233/SHTI210550},slides={gmds2021/artdecor-gmds2021.pdf},language={en},abbr={SHTI}}
SHTI
Desiderata for a Synthetic Clinical Data Generator
The current movement in Medical Informatics towards comprehensive Electronic Health Records (EHRs) has enabled a wide range of secondary use cases for this data. However, due to a number of well-justified concerns and barriers, especially with regards to information privacy, access to real medical records by researchers is often not possible, and indeed not always required. An appealing alternative to the use of real patient data is the employment of a generator for realistic, yet synthetic, EHRs. However, we have identified a number of shortcomings in prior works, especially with regards to the adaptability of the projects to the requirements of the German healthcare system. Based on three case studies, we define a non-exhaustive list of requirements for an ideal generator project that can be used in a wide range of localities and settings, to address and enable future work in this regard.
@article{wiedekopf_desiderata_2021,doi={10.3233/shti210122},url={https://doi.org/10.3233/shti210122},year={2021},month=may,publisher={{IOS} Press},author={Wiedekopf, Joshua and Ulrich, Hannes and Essenwanger, Andrea and Kiel, Alexander and Kock-Schoppenhauer, Ann-Kristin and Ingenerf, Josef},title={Desiderata for a Synthetic Clinical Data Generator},booktitle={Studies in Health Technology and Informatics},recording={https://www.youtube.com/watch?v=pBsV9mvya88},conference={Medical Informatics Europe 2021},language={en},abbr={SHTI}}