🔥 4 Möglichkeiten, IGs in Aidbox hochzuladen: Vor- und Nachteile

Die FHIR-Spezifikation v5.0.0 bietet ein breites Spektrum an FHIR-Ressourcen (genau 157), APIs und Frameworks, enthält jedoch kaum verbindliche Anforderungen. So sind beispielsweise alle Elemente der Patient-Ressource optional. Das bedeutet im Grunde, dass Sie eine Patient-Ressource ohne jegliche Daten erstellen können. In der Praxis ist das jedoch vollkommen unbrauchbar.

Daher muss die Spezifikation häufig eingeschränkt und erweitert werden. Dies geschieht mithilfe von Implementation Guides (IGs), die APIs, Ressourcen und Terminologien einschränken und erweitern, um spezifische Anwendungsfälle zu unterstützen.

Neben regionalen oder nationalen IGs wie dem US Core IG für die USA und dem NHS FHIR IG für das Vereinigte Königreich gibt es auch domänenspezifische IGs, die Orientierung für die Nutzung von FHIR-Ressourcen in bestimmten Bereichen des Gesundheitswesens oder für spezifische Anwendungsfälle bieten – etwa mCODE für die Onkologie, Argonaut Project IGs für den Datenaustausch zwischen Leistungserbringern und Kostenträgern, QI Core IG zur Darstellung von Qualitätsmessungen mit FHIR, DAF IGs zur Ermöglichung des Patientenzugriffs auf Gesundheitsdaten, IHE Mobile Access to Health Documents (MHD) IG für den unternehmensübergreifenden Dokumentenaustausch und viele weitere. Darüber hinaus können Gesundheitsorganisationen eigene IGs erstellen, um spezifische Anforderungen oder Arbeitsabläufe abzudecken.

Mit über 700 verfügbaren IGs spielen sie eine entscheidende Rolle bei der Definition des Verhaltens Ihres FHIR-Servers. Doch wie laden Sie einen IG in einen FHIR-Server und bringen ihn zum Laufen? Genau hier wird es knifflig!

In diesem Blogbeitrag untersuchen wir 4 mögliche Wege zur Konfiguration von IGs in der Aidbox FHIR-Plattform. Dazu gehört das Hochladen eines IG:

Aus der Aidbox Paketregistrierung
Als FHIR NPM-Paket
Mithilfe der FHIR CRUD API
Mithilfe des UploadFIG-Dienstprogramms

Lassen Sie uns erkunden, was, wie und warum jede Methode Ihren Anforderungen entsprechen kann.

Die Herausforderung

Das Hochladen von IGs auf einen FHIR-Server kann oft komplex erscheinen, da die FHIR-Spezifikation noch keine konkreten Anweisungen dazu liefert. Implementierende stehen vor verschiedenen Herausforderungen, wie etwa:

Welche Paketregistrierung sollte ich verwenden?
Kann ich der Qualität des FHIR-npm-Pakets und seines Manifests vertrauen?
Wie löse ich Paketabhängigkeiten auf?
Und was tue ich bei kanonischen Konflikten?

Auf der Anwenderseite variieren die Methoden zum Hochladen von IGs je nach Server – von der Referenzierung eines Pakets aus einer Registrierung bis hin zur manuellen Erstellung von Ressourcen. In der Regel unterstützen Server nur eine Methode, und diese Methoden schließen sich häufig gegenseitig aus.

Es gibt Bemühungen innerhalb der FHIR-Community, diesen Prozess zu standardisieren, beispielsweise das UploadFIG-Dienstprogramm von Brian Postlethwaite, Senior Software Engineer bei Microsoft. Diese Bemühungen stecken jedoch noch in den Kinderschuhen, und nicht alle FHIR-Server unterstützen sie.

In diesem Aidbox-Release stellen wir alle möglichen Wege vor, um diese Herausforderungen zu bewältigen. Lassen Sie uns jede davon besprechen und die Vor- und Nachteile untersuchen.

Zunächst aktivieren wir das neue UI-Design, das ebenfalls in diesem Release verfügbar ist. Weitere Informationen zur neuen Benutzeroberfläche erhalten Sie in diesem Video auf unserem YouTube-Kanal.

1. Einen IG aus der Aidbox-Paketregistrierung hochladen

Dies ist die einfachste Methode, um einen bestimmten IG in Aidbox zu aktivieren. Suchen Sie einfach in der Benutzeroberfläche nach dem gewünschten IG und wählen Sie ihn aus. Aidbox lädt dann den IG und seine Abhängigkeiten herunter und aktiviert ihn. Der zugrunde liegende Implementation Guide-Inhalt stammt aus unserer Paketregistrierung, die packages2.fhir.org spiegelt und täglich synchronisiert wird, um sicherzustellen, dass die Pakete verarbeitet, normalisiert und für die Verwendung durch Aidbox optimiert sind. Weitere Informationen zu den in der Aidbox-Registrierung verfügbaren Paketen finden Sie auf dieser Seite.

Vorteile: Sie können einfach den benötigten IG auswählen, und alle Abhängigkeiten werden automatisch geladen.

Nachteile: Wenn der benötigte IG nicht auf packages2.fhir.org verfügbar ist, fehlt er auch in unserer Registrierung, was problematisch sein kann.

👉 Klicken Sie hier, um mehr in der Aidbox-Dokumentation zu lesen.

Was ist, wenn der benötigte IG in der Aidbox-Paketregistrierung fehlt? Kein Problem – hier sind alternative Methoden zum Hochladen eines IG in Aidbox.

Um diese Methode direkt auszuprobieren, testen Sie die kostenlose Version von Aidbox. Sie bietet eine umfassende Umgebung zum Testen aller Funktionen ohne Einschränkungen und ist ideal für Entwicklung und Experimente.

2. Einen IG als FHIR NPM-Paket hochladen

Für diesen Ansatz benötigen Sie zunächst ein gültiges FHIR NPM-Paket im Format tar.gz (Tarball). Sie können dieses Artefakt von Simplifier.net beziehen, es mit SUSHI Build/IG Publisher Build erstellen oder manuell anfertigen, indem Sie ein Paketmanifest zu Ihren Konformitätsressourcen hinzufügen und diese in einem tar.gz-Archiv ablegen. Weitere Informationen zu FHIR NPM-Paketen und Paketmanifesten finden Sie in der FHIR NPM-Paket-Spezifikation.

Um beispielsweise das FHIR NPM-Paket für den US Core Implementation Guide zu erhalten, führen Sie folgenden Befehl aus:

npm --registry https://packages.simplifier.net view 
hl7.fhir.us.core@6.1.0

Die Ausgabe enthält einen Link zu einer Tarball-Datei. Sie können diesen Link an Aidbox übergeben oder die heruntergeladene Tarball-Datei hochladen. Aidbox verarbeitet den angegebenen Link oder das Archiv, bezieht die Pakete, von denen das hochgeladene Paket abhängt, aus der Aidbox-Paketregistrierung und aktiviert diesen IG in Aidbox.

Sie fragen sich vielleicht: „Was ist, wenn mein IG einen anderen IG als Abhängigkeit referenziert, der ebenfalls nicht in der Aidbox-Paketregistrierung vorhanden ist?" Kein Problem – Sie können mehrere FHIR NPM-Pakete gleichzeitig hochladen, indem Sie mehrere Links oder Archivdateien angeben.

Vorteile: Wenn ein IG (oder mehrere IGs) nicht in öffentlichen Registrierungen veröffentlicht ist, können Sie ihn dennoch mit einem unkomplizierten Ansatz und etwas Vorbereitung laden.

Nachteile: Erfordert einige Vorbereitung, einschließlich der Beschaffung des FHIR NPM-Paket-Artefakts.

👉 Klicken Sie hier, um mehr in der Aidbox-Dokumentation zu lesen.

Eine weitere Option besteht darin, IG-Inhalte wie StructureDefinitions und SearchParameters manuell zu erstellen.

3. Einen IG mithilfe der FHIR CRUD API hochladen

Sie können Ihre StructureDefinitions oder SearchParameters ganz einfach über die Aidbox FHIR CRUD API hochladen. Dieses Tutorial enthält anschauliche Beispiele zur Verwendung dieser Methode. Es ist wichtig zu beachten, dass Sie, wenn Ihr Profil externe Profile referenziert – beispielsweise us-core-patient als Basis –, us-core zuerst in Aidbox vorladen müssen. Ebenso müssen Sie bei einer Kette voneinander abhängiger StructureDefinition-Ressourcen sicherstellen, dass diese in der richtigen Reihenfolge übergeben werden.

Vorteile: Einfache Nutzung der FHIR CRUD API zum Hochladen.

Nachteile: Externe IGs müssen vorgeladen werden, wenn Ihre Profile von ihnen abhängen.

👉 Klicken Sie hier, um mehr in der Aidbox-Dokumentation zu lesen.

Dies führt zu einem interessanten Effekt: Wenn ein FHIR-Server die Echtzeit-Erstellung von Konformitätsressourcen unterstützt, unterstützt er automatisch auch das UploadFIG-Dienstprogramm. Dies ist die letzte IG-Upload-Methode, die wir besprechen möchten.

4. Einen IG mithilfe des UploadFIG-Dienstprogramms hochladen

UploadFIG, entwickelt von Brian Postlethwaite, verwendet die FHIR CRUD API für Konformitätsressourcen. Es bereitet Pakete vor, beschafft Abhängigkeiten, führt eine Vorvalidierung von Konformitätsressourcen durch und vieles mehr, bevor diese an den FHIR-Server übermittelt werden. Anweisungen zur Verwendung dieses Dienstprogramms finden Sie in diesem Tutorial in unserer Dokumentation.

Vorteile: UploadFIG übernimmt einen Großteil der Hintergrundarbeit und ermöglicht es Ihnen, einfach die Paket-ID anzugeben, um sie in den FHIR-Server zu laden.

Nachteile: Noch in der frühen Entwicklungsphase, noch nicht weit verbreitet und erfordert die Installation der .NET-Plattform.

Beherrschen Sie die Best Practices der IG-Konfiguration mit Aidbox

In diesem Blogbeitrag haben wir 4 effektive Wege zur Konfiguration von IGs in Aidbox untersucht. Diese Methoden umfassen das Hochladen eines IG aus der Aidbox-Paketregistrierung, als FHIR NPM-Paket, über die FHIR CRUD API sowie mithilfe des UploadFIG-Dienstprogramms. Jeder Ansatz hat seine eigenen Vor- und Nachteile und bietet Flexibilität für unterschiedliche Anforderungen.

Tipps:

Verwenden Sie die Aidbox-Paketregistrierung für die einfachste und am stärksten automatisierte Methode.
Laden Sie FHIR NPM-Pakete für mehr Kontrolle und Flexibilität hoch.
Nutzen Sie die FHIR CRUD API zur manuellen Erstellung von IG-Inhalten.
Probieren Sie das UploadFIG-Dienstprogramm für eine umfassende Paketverwaltung aus.

Sie haben nun einen Plan – der nächste Schritt besteht darin, ihn in die Praxis umzusetzen. Probieren Sie diese Methoden in der Aidbox FHIR-Plattform aus und optimieren Sie Ihren IG-Implementierungsprozess.

Bereit, die IG-Konfiguration zu meistern? Probieren Sie es noch heute in Aidbox aus!

Autor: Evgeny Mukha, Full-Stack Software Engineer bei Health Samurai