Inhaltsverzeichnis
In diesem Projekt sind Plugins für den gematik Referenzvalidator und ein Werkzeug (PluginBuilder) enthalten, mit dem eigene Plugins erstellt werden können.
Siehe ReleaseNotes.md
Die Plugins können unter Releases heruntergeladen werden.
| Plugin | Version | ID |
|---|---|---|
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 1 (Modul Basis) | 2.1 | isik1 |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 2 (Modul Basis) | 2.1 | isik2-basismodul |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 2 (Modul Terminplanung) | 1.3 | isik2-terminplanung |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 2 (Modul Vitalparameter) | 1.1 | isik2-vitalparameter |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 2 (Modul Medikation) | 2.0 | isik2-medikation |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Basis) | 0.5 | isik3-basismodul |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Terminplanung) | 0.3 | isik3-terminplanung |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Vitalparameter) | 0.3 | isik3-vitalparameter |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Medikation) | 0.4 | isik3-medikation |
| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Dokumentenaustausch) | 0.4 | isik3-dokumentenaustausch |
| Informationstechnische Systeme in der Pflege (ISIP) Stufe 1 | 1.1 | isip1 |
| DiGA Toolkit | 0.10 | diga |
| VSDM-Ersatzbescheinigung | 0.1 | eeb |
| Elektronische Patientenakte Basisfunktionalitäten | 1.1.0 | epa3-basic |
| Elektronische Patientenakte Medication | 1.1.0 | epa3-medication |
Die Bezeichnung in der Spalte ID dient dem Aufruf des Plugins aus der Referenzvalidator-Konsolenanwendung.
Abweichend vom allgemeinen Prüfumfang verhält sich das EPA-Medication-Plugin wie folgt:
- Codes aus den Codesystemen
http://fhir.de/CodeSystem/bfarm/atc,http://fhir.de/CodeSystem/ask,http://fhir.de/CodeSystem/ifa/pznwerden nicht validiert
Abweichend vom allgemeinen Prüfumfang verhalten sich die ISIK3-Plugins wie folgt:
- Codes aus den CodeSystemen
http://snomed.info/sct,http://fhir.de/CodeSystem/bfarm/icd-10-gm,http://fhir.de/CodeSystem/bfarm/atc,http://fhir.de/CodeSystem/ifa/pznundhttp://fhir.de/CodeSystem/bfarm/opswerden nicht validiert - Folgende ValueSets werden nicht validiert:
https://gematik.de/fhir/isik/v3/Basismodul/ValueSet/ProzedurenCodesSCT,https://gematik.de/fhir/isik/v3/Basismodul/ValueSet/DiagnosesSCT,https://gematik.de/fhir/isik/v3/Basismodul/ValueSet/ProzedurenKategorieSCT,https://gematik.de/fhir/isik/v3/Terminplanung/ValueSet/ISiKTerminPriority,https://gematik.de/fhir/isik/v3/Medikation/ValueSet/SctRouteOfAdministrationundhttp://fhir.de/ValueSet/bfarm/ops - Validierung ausgewählter KBV-Schlüsseltabellen, siehe Package gematik.kbv.sfhir.cs.vs im Plugin
Abweichend vom allgemeinen Prüfumfang verhalten sich die ISIK2-Plugins wie folgt:
- Codes aus den CodeSystemen
http://snomed.info/sct,http://fhir.de/CodeSystem/bfarm/icd-10-gm,http://fhir.de/CodeSystem/bfarm/atc,http://fhir.de/CodeSystem/ifa/pznundhttp://fhir.de/CodeSystem/bfarm/opswerden nicht validiert - Folgende ValueSets werden nicht validiert:
https://gematik.de/fhir/isik/v2/Basismodul/ValueSet/ProzedurenCodesSCT,https://gematik.de/fhir/isik/v2/Basismodul/ValueSet/DiagnosesSCT,https://gematik.de/fhir/isik/v2/Basismodul/ValueSet/ProzedurenKategorieSCT,https://gematik.de/fhir/isik/v2/Terminplanung/ValueSet/ISiKTerminPriority,https://gematik.de/fhir/isik/v2/Medikation/ValueSet/SctRouteOfAdministrationundhttp://fhir.de/ValueSet/bfarm/ops - Validierung ausgewählter KBV-Schlüsseltabellen, siehe Package gematik.kbv.sfhir.cs.vs im Plugin
Abweichend vom allgemeinen Prüfumfang verhält sich das ISIK1-Plugin wie folgt:
- Codes aus den CodeSystemen
http://snomed.info/sct,http://fhir.de/CodeSystem/bfarm/icd-10-gmundhttp://fhir.de/CodeSystem/bfarm/opswerden nicht validiert - Folgende ValueSets werden nicht validiert:
https://gematik.de/fhir/isik/v2/Basismodul/ValueSet/ProzedurenCodesSCT,https://gematik.de/fhir/isik/v2/Basismodul/ValueSet/DiagnosesSCT,https://gematik.de/fhir/isik/v2/Basismodul/ValueSet/ProzedurenKategorieSCTundhttp://fhir.de/ValueSet/bfarm/ops - Validierung ausgewählter KBV-Schlüsseltabellen, siehe Package gematik.kbv.sfhir.cs.vs im Plugin
Abweichend vom allgemeinen Prüfumfang verhält sich das DIGA-Plugin wie folgt:
- Codes aus den CodeSystemen
http://fhir.de/CodeSystem/ifa/pznundhttp://fhir.de/CodeSystem/dimdi/atcwerden nicht validiert - Instanzen mit unbekannten Profilen führen zum invaliden Ergebnis
- Instanzen mit unbekannten Extensions führen zum invaliden Ergebnis
Anpassungen der Packages:
- ValueSet-versicherungsart-de-basis.json in de.basisprofil.r4-1.3.2 korrigiert
Siehe Dokumentation vom gematik Referenzvalidator.
- Die letzte Version vom PluginBuilder herunterladen
- Die Ordnerstruktur für das neue Plugin (z.B. mit dem Namen
my-plugin) vorbereiten:
my-plugin/
├── test-files/
│ ├── valid/
│ └── invalid/
├── src-packages/
├── patches/
└── config.yaml
- Die Plugin-Definitionsdatei erstellen (siehe Plugin-Definitionsdatei).
- Test-Instanzen vorbereiten (siehe Test-Instanzen)
- (optional) Quell-FHIR-Packages ablegen (siehe Quell-FHIR-Packages)
- (optional) Patches für die Ressourcen in den Quell-FHIR-Packages ablegen (siehe Patches für die Quell-FHIR-Packages)
| Eigenschaft | Bezeichnung in config.yaml | Pflichtangabe | Beschreibung | Beispiel |
|---|---|---|---|---|
| Version der Definition-Beschreibungssprache | configSpecVersion | Ja | Derzeit fest auf 1.0 | 1.0 |
| Name | id | Ja | Identifikator des Plugins. Wird für die Paketierung und den Aufruf im Referenzvalidator verwendet | isik3-terminplanung |
| Version | version | Ja | Version des Plugins | 1.0.0 |
| Author | author | Ja | Author des Plugins. | gematik |
| Beschreibung | description | Ja | Eine kurze Beschreibung des Plugins und seines Validierungsumfangs. | Dies ist eine Beispielbeschreibung des Plugins. |
| Link zur Spezifikation | specUrl | Nein | Link zur Spezifikation des validation FHIR-Packages (validation.fhirPackage) | https://simplifier.net/packages/de.gematik.isik-terminplanung/3.0.0 |
| Paketname | validation.fhirPackage | Ja | Name und Version des FHIR-Packages, dessen Profile vom Plugin validiert werden sollen (Format abc#X.Y.Z) | kbv.ita.erp#1.1.0 |
| Validierungsabhängigkeiten | validation.dependencies | Nein | Liste von FHIR-Packages (Format abc#X.Y.Z), die aus dem Package-Server heruntergeladen werden sollen und die später für die Validierung benötigt werden (falls abweichend von der package.json des Packages unter validation.fhirPackage und falls das Package nicht im src-packages-Ordner abgelegt wurde) |
- "kbv.basis#1.3.1" - "kbv.ita.for#1.3.1" |
| Zu ignorierende Codesysteme | validation.ignoredCodeSystems | Nein | CodeSysteme, die im Rahmen der Validierung nicht überprüft werden sollen | "http://fhir.de/CodeSystem/bfarm/icd-10-gm" |
| Zu ignorierende ValueSets | validation.ignoredValueSets | Nein | ValueSets, die im Rahmen der Validierung nicht überprüft werden sollen | "http://fhir.de/ValueSet/bfarm/ops" |
| Unbekannte Extensions führen zu Fehlern | validation.anyExtensionsAllowed | Nein | Festlegung, ob unbekannte Extensions in den Instanzen zu Fehlern führen sollen | false |
| Unbekannte Profile führen zu Fehlern | validation.errorForUnknownProfiles | Nein | Festlegung, ob unbekannte Profile bei meta.profile-Angaben in den Instanzen zu Fehlern führen sollen | true |
| Akzeptierte Dateiformate | validation.acceptedEncodings | Nein | Festlegung, welche Dateiformate bei Validierung ausschließlich akzeptiert werden sollen | xml |
| Kritikalitätsbewertung der Validierungsausgaben | validation.validationMessageTransformations | Nein | Veränderung der Kritikalitätsstufe der Ausgaben des Validators. | transformation1: - severityLevelFrom: "error" - severityLevelTo: "information" - locatorString: "Appointment.participant:AkteurPatient" - messageId: "Validation_VAL_Profile_Minimum" |
| Snapshot-Abhängigkeiten | snapshotDependencies | Nein | Liste von zusätzlichen FHIR-Packages (Format abc#X.Y.Z), die für die Snapshot-Generierung benötigt werden. Die Packages werden von öffentlichen Package-Servern heruntergeladen | "ein-nur-fuer-snapshot-generierung-benoetigtes-package#x.y.z" |
Beispiel einer config.yaml-Datei:
configSpecVersion: "1.0"
id: "isik3-terminplanung"
version: "1.0.0"
author: "gematik"
description: "Dies ist eine Beispielbeschreibung des Plugins."
specUrl: "https://simplifier.net/packages/de.gematik.isik-terminplanung/3.0.0"
validation:
fhirPackage: "de.gematik.isik-terminplanung#3.0.0"
dependencies:
- "kbv.basis#1.3.1"
- "kbv.ita.for#1.3.1"
errorOnUnknownProfile: "true"
anyExtensionsAllowed: "false"
acceptedEncodings:
- "xml"
validationMessageTransformations:
transformation1:
severityLevelFrom: "error"
severityLevelTo: "information"
locatorString: "Appointment.participant:AkteurPatient"
messageId: "Validation_VAL_Profile_Minimum"
ignoredCodeSystems:
- "http://snomed.info/sct"
ignoredValueSets:
- "http://fhir.de/ValueSet/bfarm/ops"
snapshotDependencies:
- "ein-nur-fuer-snapshot-generierung-benoetigtes-package#x.y.z"Im Ordner test-files müssen mindestens eine valide (im Unterordner valid) sowie eine invalide (im Unterordner invalid) FHIR-Ressource als Testinstanz von einem Profil aus validation.fhirPackage hinterlegt werden, um sicherzustellen, dass die Validierung mit dem gebauten Plugin auch funktioniert. Im besten Fall sollte für jedes enthaltene Profil aus validation.fhirPackage jeweils eine valide und eine invalide FHIR-Ressource als Testinstanz hinterlegt werden. Der PluginBuilder weist in seiner Konsolenausgabe auf die Profile mit fehlenden Testinstanzen hin.
Im Ordner src-packages können FHIR-Packages im FHIR Package Standard hinterlegt werden. Die hier hinterlegten FHIR-Packages werden zusätzlich zu den Abhängigkeiten des Plugin-Pakets (siehe validation.fhirPackage) für die Validaierung von FHIR-Ressourcen verwendet.
Hier können einzelne FHIR-Ressourcen hinterlegt werden, die die FHIR-Ressourcen in originellen FHIR-Packages ergänzen oder ersetzen sollten (z.B. für den Fall wenn in einem Profil eines bereits veröffentlichten Quell-FHIR-Package ein Fehler vorliegt, der die Validierung verhindert).
** Warning **
Die Dateien müssen exakt denselben Namen haben, wie die fehlerhaften Dateien im Quell-FHIR-Package. Sie müssen im Unterordner abgelegt werden, dessen Name im Format [FHIR-Package-Name]-[FHIR-Package-Version] dem Quell-FHIR-Package entspricht
Beispiel:
my-plugin/
└── patches/
└── package1-1.0.0/
└── some-profile-with-fixes.json
Warning Um Abhängigkeiten der FHIR-Pakages zu herunterladen, erfordert der Plugin-Builder direkte Verbindung zum Internet. Derzeit ist keine Proxy-Server-Konfiguration möglich
Beispielaufrufe des Plugin-Builders (build):
java -jar plugin-builder-cli-X.Y.Z.jar build C:\user\plugindefinitions\my-plugin
java -jar plugin-builder-cli-X.Y.Z.jar build C:\user\plugindefinitions\my-plugin -t C:\output
Das erste Argument ('build') gibt an, dass der build-Prozess gestartet werden soll. Das zweite Argument ist verpflichtend und gibt den Pfad zum Ordner mit Plugin-Ressourcen an. Optional gibt es folgende Parameter:
| Parameter | Beschreibung |
|---|---|
-t oder--targetFolderPath |
Ausgabeverzeichnis. Standardmäßig wird das Parent-Verzeichnis vom Plugin-Ressourcen-Ordner als Ausgabeverzeichnis verwendet |
-url oder--packageServerUrl |
URL eines alternativen FHIR Package Servers. Standardmäßig werden http://packages.fhir.org und https://packages2.fhir.org/packages verwendet |
Neben Konsolenausgabe schreibt der Plugin-Builder während der Ausführung ein Protokoll mit Warnungen (warn.log).
Mithilfe des Plugin-Builders können auch bereits gebaute Plugins getestet werden.
Beispielaufrufe des Plugin-Builders (test):
java -jar plugin-builder-cli-X.Y.Z.jar test C:\user\plugindefinitions\my-plugin.zip C:\user\test-files
Das erste Argument ('test') gibt an, dass der test-Prozess gestartet werden soll. Hier sind auch die beiden folgenden Argumente verpflichtend. Das zweite gibt den Pfad zum zu testenden Plugin an und das dritte ist der Pfad zum Ordner, der die Testinstanzen enthält.
Alle bereits integrierten Plugins können mit dem Aufruf mvn clean install -Pbuild-plugins gebaut werden. Um ein einzelnes, spezielles Plugin zu bauen wird folgender Aufruf benötigt: mvn clean install -pl :valmodule-eeb -Pbuild-plugins. Dieser Aufruf würde das valmodule-eeb einzeln bauen.
Für Beiträge zum PluginBuilder oder den Plugins siehe CONTRIBUTING.md.
Siehe LICENSE.
Fragen, Anregungen, Bug Reports und Feature requests sind willkommen und können gerne über die GitHub Issues oder über referenzvalidator@gematik.de eingereicht werden.