Skip to content

Latest commit

 

History

History
77 lines (60 loc) · 5.94 KB

erp_fhirversion_changes.adoc

File metadata and controls

77 lines (60 loc) · 5.94 KB
Raw

E-Rezept FHIR-Package Änderungen bei Versionsübergängen gematik logo

Zielgruppe: KIS C30059 AVS E30615 FdV green

Methodik

Um Änderungen der FHIR Ressourcen nach Versionsübergängen zu ermitteln und zu visualisieren, bietet der HAPI Validator eine hilfreiche Funktionalität. Der Hapi Validator kann Profile miteinander vergleichen.

ℹ️
 Bis zur Version 5.6.88 ist die Vergleichsfunktion fehlerhaft. Ab Version 5.6.89 kann diese wie folgt benutzt werden: 
java -jar validator_cli.jar -compare -dest compare_results -version 4.0.1 \
-ig de.gematik.erezept-workflow.r4#1.2.1 \
-ig de.gematik.erezept-workflow.r4#1.1.1 \
-left https://gematik.de/fhir/StructureDefinition/ErxTask|1.1.1 \
-right https://gematik.de/fhir/erp/StructureDefinition/GEM_ERP_PR_Task|1.2.1

Das Ergebnis eines solchen Abgleichs ist ein Ordner mit vielen (Bild-)dateien und einer index.html die als Einstiegspunkt für den erfolgten Vergleiche dient. Darüber hinaus enthalten die Verzeichnisse die 'union'- und 'intersection'-FHIR Strukturen die für eine vereinfachte Integration verwendet werden können.

ℹ️
 Die CompareFunktion kann nur für Definitionen von Profilen und Extensions aufgerufen werden. 'OperationDefinition', 'CodeSystem','NamingSystem' und 'ValueSet’werden nicht direkt miteinander verglichen. Wenn Profile oder Extensions 'OperationDefinition', 'CodeSystem','NamingSystem' oder 'ValueSet' beinhalten, werden diese aber indirekt verglichen.
ℹ️
 Da durch Änderung der Canonicals die Profilnamen (wie im obigen Beispiel) nicht immer identisch geblieben sind, ist ein automatisierter Aufruf der Vergleichsfunktionalität nicht ohne weiteres möglich. Um das problem zu lösen können "Transitionfiles" verwendet werden.

Transitionfiles

Um die Umbenennung von Profilen oder deren Umlagerung in neue Profile festzuhalten wurden "Transitionfiles" erstellt, diese geben Auskunft über

  • Abhängigkeiten die für den Vergleich der Profile notwendig sind

  • Neue Profile seit dem Versionsübergang

  • Ausgeschiedene Profile mit dem Versionsübergang

  • Profiländerungen mit den Versionsübergang

Generierte Vergleichs Ergebnisse

ℹ️
 Die Artefakte der jeweils abhängigen Pakete wurden nicht erzeugt und werden hier nicht zur Verfügung gestellt. Diese Abhängigkeiten können auf Simplifier unter dem Tab "Dependencies" eingesehen werden. Zum Beispiel können Sie die Abhängigkeiten des E-Rezept-Workflows Paketes unter https://simplifier.net/erezept-workflow/~dependencies einsehen. Für Änderungen innerhalb der Abhängigkeiten empfehlen wir Ihnen, die Releasenotes der Pakete zu analysieren. Beispielsweise finden Sie eine Liste der Releasenotes für das Paket "de.basisprofil.r4" in Version 1.3.2 unter https://simplifier.net/packages/de.basisprofil.r4/1.3.2.

Die Ergebnisse des Abgleichs der betroffenen Pakete (ohne deren direkte und indirekte Abhängigkeiten) können hier eingesehen werden:

ℹ️
 Die html-Dateien können auch als komprimiertes Verzeichnis heruntergeladen werden und lokal im Browser betrachtet werden.