Der Begriff "ImplementationGuide" führt im Kontext von FHIR immer wieder zu Missverständnissen.
Hier folgt der Versuch einer Klärung der häufigsten Fragen:
Was ist eigentlich ein Implementierungsleitfaden?
Wikipedia definiert den Begriff "Leitfaden" als "eine Handlungsvorschrift mit bindendem Charakter".
Im Kontext der Standardisierung kennen wir Implementierungsleitfäden als Anleitung für die Entwicklung kompatibler Softwarelösungen. Als solche präzisiert ein typischer Implementierungsleitfaden (z.B. von IHE) i.d.R. die Verwendung eines internationalen Standards im Kontext eines konkreten UseCases.
Beispiele:
- IHE-RAD beschreibt die konkrete Verwendung von (u.A.) HL7 Version 2 Nachrichten zur Implementierung des radiologischen Order-Entry-Workflows.
- Der Implementierungsleitfaden "Arztbrief 2014" beschreibt die Darstellung eines strukturierten Arztbriefes auf Basis von HL7 CDA
- Der "International Patient Summary" beschreibt die Vereinbarungen für eine internationale Patientenkurzakte auf Basis von FHIR.
Für Implementierungsleitfäden gibt es Standard-übergreifend kein einheitliches Format. In der Regel handelt es sich um menschenlesbare Dokumente (PDF, HTML), die auch auf maschinenlesbare Artefakte verweisen können, aber nicht müssen.
Was ist der Unterschied zwischen einem Implementierungsleitfaden und einem Profil?
Antwort 1: Es ist das gleiche!
Im Kontext von IHE-Spezifikationen beschreibt der Begriff "Profil" das Dokument, das beschreibt, wie ein internationaler Standard für einen bestimmten UseCase "profiliert" wurde, also den Implementierungsleitfaden.
Antwort 2: Es ist nicht das gleiche!
Im Kontext von FHIR versteht man unter einem "Profil" die Summe der Contraints, die beschreiben, wie ein konkreter FHIR-Ressourcentyp (z.B: "Condition") in einem konkreten Kontext (z.B. beim Datenaustausch zwischen Systemen in einem Krankenhaus) verwendet werden soll.
Die Aufgaben eines Profils sind unter anderem:
- die Festlegung der UseCase-spezifischen Pflichtfelder
- die Festlegung der darüber hinaus optional verwendeten Felder (mit rotem "S" gekennzeichnet)
- die Festlegung der verwendeten Extensions
- die Festlegung der verwendeten Terminologien (z.B. zur Codierung von Diagnosen)
- die Festlegung von Regeln, die erfüllt werden müssen (sog. "Invarianten")
Was ist der Unterschied zwischen einem ImplementationGuide und einem Implementierungsleitfaden?
Der ImplementationGuide ist eine Resource aus dem FHIR Conformance Framework (einer Gruppierung von verschiedenen Ressourcentypen, die im Kontext der Erstellung von FHIR-basierten Spezifikationen benötigt werden), also ein strukturiertes, maschinenlesbares Objekt, das wie jede andere FHIR-Ressource wahlweise in XML oder JSON serialisiert werden kann. Es dient dazu, die Einzelteile, die einen Implementierungsleitfaden ausmachen (HTML-Webseiten mit Erläuterungstexten und darin eingebetteten Grafiken, Beispieldaten, Profile, ValueSets, Extensions ...) zu einem Paket zu verschnüren, zu publizieren und zwischen verschiedenen Tools und Systemen austauschbar zu machen.
Für humanoide Konsumenten einer Spezifikation ist die ImplementationGuide-Ressource in der Regel uninteressant. Selbige wollen das HMTL-Dokument in seiner menschenlesbaren Form betrachten können, nicht die maschinenlesbare Auflistung seiner Einzelteile.
Während im Englischen höchstens die Anordnung der Majuskeln zur Unterscheidung von ersterem, dem "ImplementationGuide" und letzterem, dem "implementation guide" herangezogen werden kann, hat es sich hierzulande etabliert, die Ressource bei ihrem englischen Namen zu nennen, jedoch das HTML-Dokument zu "(Implementierungs-)Leitfaden" zu übersetzen.
Schwierig wird es, wenn man mit hartgesottenen FHIR-Nerds spricht, die aus ökonomischen Gründen beides unter dem Akronym "IG" zusammenfalten.
CAVE: In Simplifier, einer beliebten Plattform zur Erstellung und Publikation von FHIR-Spezifikationen, findet man in einem Projekt einerseits einen "ImplementationGuide" im Tab "Resources", andererseits aber auch das gerenderte Dokument als HTML-Seite(n) im Tab "Guides". Da hat man schnell mal daneben geklickt und wundert sich!
Vergleiche:
Wer darf Implementierungsleitfäden schreiben?
- der Beschreibung einer Implementierung im Sinne einer Richtlinie von Standardisierungsorganisationen an die Industrie oder
- der Beschreibung einer Impementierung im Sinne eines Pflichtenheftes im Rahmen einer Beschaffung/Beauftragung oder
- der Beschreibung einer Implementierung im Sinne einer Schnittstellendokumentation.
