{"id":18985550,"url":"https://github.com/gematik/app-referencevalidator-plugins","last_synced_at":"2026-03-04T16:03:27.738Z","repository":{"id":222893347,"uuid":"728711109","full_name":"gematik/app-referencevalidator-plugins","owner":"gematik","description":"The repository contains plugins for gematik reference validator and a plugin development kit.","archived":false,"fork":false,"pushed_at":"2026-02-17T14:12:23.000Z","size":3769,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-02-17T19:17:49.594Z","etag":null,"topics":["data","fhir","reference-implementation","reference-validator"],"latest_commit_sha":null,"homepage":"https://fachportal.gematik.de/hersteller-anbieter/primaersysteme/referenzvalidator","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gematik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-12-07T14:25:46.000Z","updated_at":"2026-02-17T14:12:19.000Z","dependencies_parsed_at":"2025-04-12T23:42:44.086Z","dependency_job_id":"a694d761-1478-4135-a4cc-bae0240f7d6f","html_url":"https://github.com/gematik/app-referencevalidator-plugins","commit_stats":null,"previous_names":["gematik/app-referencevalidator-plugins"],"tags_count":65,"template":false,"template_full_name":null,"purl":"pkg:github/gematik/app-referencevalidator-plugins","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gematik%2Fapp-referencevalidator-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gematik%2Fapp-referencevalidator-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gematik%2Fapp-referencevalidator-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gematik%2Fapp-referencevalidator-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gematik","download_url":"https://codeload.github.com/gematik/app-referencevalidator-plugins/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gematik%2Fapp-referencevalidator-plugins/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30085838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T15:40:14.053Z","status":"ssl_error","status_checked_at":"2026-03-04T15:40:13.655Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","fhir","reference-implementation","reference-validator"],"created_at":"2024-11-08T16:27:11.302Z","updated_at":"2026-03-04T16:03:27.725Z","avatar_url":"https://github.com/gematik.png","language":"Java","readme":"\u003cimg align=\"right\" width=\"250\" height=\"47\" src=\"docs/Gematik_Logo_Flag.png\"/\u003e \u003cbr/\u003e \n\n# gematik Referenzvalidator Plugins\n\n\u003cdetails\u003e\n \u003csummary\u003eInhaltsverzeichnis\u003c/summary\u003e\n \u003col\u003e\n \u003cli\u003e\u003ca href=\"#über-das-projekt\"\u003eÜber das Projekt\u003c/a\u003e\u003c/li\u003e\n \u003cli\u003e\u003ca href=\"#verfügbare-plugins\"\u003eVerfügbare Plugins\u003c/a\u003e\u003c/li\u003e\n \u003cli\u003e\u003ca href=\"#nutzung-mit-dem-referenzvalidator\"\u003eNutzung mit dem Referenzvalidator\u003c/a\u003e\u003c/li\u003e\n \u003cli\u003e\u003ca href=\"#erstellung-von-plugins-mittels-plugin-builders\"\u003eErstellung von Plugins mittels Plugin-Builders\u003c/a\u003e\u003c/li\u003e\n \u003cli\u003e\u003ca href=\"#beiträge-zum-projekt\"\u003eBeiträge zum Projekt\u003c/a\u003e\u003c/li\u003e\n \u003cli\u003e\u003ca href=\"#lizenz\"\u003eLizenz\u003c/a\u003e\u003c/li\u003e\n \u003cli\u003e\u003ca href=\"#kontakt\"\u003eKontakt\u003c/a\u003e\u003c/li\u003e\n \u003c/ol\u003e\n\u003c/details\u003e\n\n## Über das Projekt\n\nIn diesem Projekt sind Plugins für den [gematik Referenzvalidator](https://github.com/gematik/app-referencevalidator)\nund ein Werkzeug (PluginBuilder) enthalten, mit dem eigene Plugins erstellt werden können.\n\n### Release Notes\n\nSiehe [ReleaseNotes.md](./ReleaseNotes.md)\n\n## Verfügbare Plugins\n\nDie Plugins können unter [Releases](https://github.com/gematik/app-referencevalidator-plugins/releases) heruntergeladen\nwerden.\n\n| **Plugin** | **Version** | **ID** |\n|--------------------------------------------------------------------------------------------------|-------------|---------------------------|\n| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Basis) | 1.1.1 | isik3-basismodul |\n| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Terminplanung) | 1.2.0 | isik3-terminplanung |\n| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Vitalparameter) | 1.1.0 | isik3-vitalparameter |\n| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Medikation) | 1.1.0 | isik3-medikation |\n| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 3 (Modul Dokumentenaustausch) | 2.1.0 | isik3-dokumentenaustausch |\n| Informationstechnische Systeme in Krankenhäusern (ISIK) Stufe 5 (Unified) | 1.0.1 | isik5 |\n| Informationstechnische Systeme in der Pflege (ISIP) Stufe 1 | 1.1 | isip1 |\n| DiGA Toolkit | 0.10 | diga |\n| VSDM-Ersatzbescheinigung | 1.0 | eeb |\n| Elektronische Patientenakte Basisfunktionalitäten 3.1.3-1 | 1.2.0 | epa3-basic |\n| Elektronische Patientenakte Medication 3.1.3-1 | 1.5.0 | epa3-medication |\n| Elektronische Rezept für die EU (ERP-EU) | 1.0.1 | erp-eu |\n| [KIM-Nachrichten für das E-Rezept](https://gemspec.gematik.de/ig/fhir/erp-servicerequest/1.2.0/) | 1.2.0 | erp-servicerequest |\n\nDie Bezeichnung in der Spalte `ID` dient dem Aufruf des Plugins aus der Referenzvalidator-Konsolenanwendung.\n\n### Besonderheiten der Plugins\n\n#### EPA-Medication\n\nAbweichend vom allgemeinen Prüfumfang verhält sich das EPA-Medication-Plugin wie folgt:\n\n- Codes aus den folgenden Codesystemen werden nicht validiert:\n - `http://fhir.de/CodeSystem/bfarm/atc`\n - `http://fhir.de/CodeSystem/ask`\n - `http://fhir.de/CodeSystem/ifa/pzn`\n - \"http://snomed.info/sct\"\n - \"https://terminologieserver.bfarm.de/fhir/CodeSystem/arzneimittel-referenzdaten-pharmazeutisches-produkt\"\n\n_Zusatzinformation:_ Das Plugin lädt derzeit zwei große HL7-Terminologiepakete (je ~5 MB), was die Paketgröße und damit\ndie Validierungsdauer deutlich erhöht, obwohl vermutlich nur wenige enthaltene ValueSets/CodeSystems tatsächlich\nbenötigt werden; eine Lösung ist geplant, hat aber aktuell keine Priorität.\n\n#### ISIK5\n\nAbweichend vom allgemeinen Prüfumfang verhaltet sich das Plugin wie folgt:\n\n- Codes aus den CodeSystemen `http://snomed.info/sct`, `http://fhir.de/CodeSystem/bfarm/icd-10-gm`,\n `http://fhir.de/CodeSystem/bfarm/atc`, `http://fhir.de/CodeSystem/ifa/pzn`, `http://fhir.de/CodeSystem/bfarm/ops` und\n `http://dvmd.de/fhir/CodeSystem/kdl` werden nicht validiert\n- Folgende ValueSets werden nicht validiert: `https://gematik.de/fhir/isik/ValueSet/ProzedurenCodesSCT`,\n `https://gematik.de/fhir/isik/ValueSet/DiagnosesSCT`,\n `https://gematik.de/fhir/isik/ValueSet/ProzedurenKategorieSCT`,\n `https://gematik.de/fhir/isik/ValueSet/ISiKTerminPriority`,\n `https://gematik.de/fhir/isik/ValueSet/SctRouteOfAdministration`, `http://fhir.de/ValueSet/bfarm/ops` und\n `http://dvmd.de/fhir/ValueSet/kdl`\n\n#### ISIK3\n\nAbweichend vom allgemeinen Prüfumfang verhalten sich die ISIK3-Plugins wie folgt:\n\n- Codes aus den CodeSystemen `http://snomed.info/sct`, `http://fhir.de/CodeSystem/bfarm/icd-10-gm`,\n `http://fhir.de/CodeSystem/bfarm/atc`, `http://fhir.de/CodeSystem/ifa/pzn` und `http://fhir.de/CodeSystem/bfarm/ops`\n werden nicht validiert\n- Folgende ValueSets werden nicht validiert: `https://gematik.de/fhir/isik/v3/Basismodul/ValueSet/ProzedurenCodesSCT`,\n `https://gematik.de/fhir/isik/v3/Basismodul/ValueSet/DiagnosesSCT`,\n `https://gematik.de/fhir/isik/v3/Basismodul/ValueSet/ProzedurenKategorieSCT`,\n `https://gematik.de/fhir/isik/v3/Terminplanung/ValueSet/ISiKTerminPriority`,\n `https://gematik.de/fhir/isik/v3/Medikation/ValueSet/SctRouteOfAdministration` und `http://fhir.de/ValueSet/bfarm/ops`\n- Validierung ausgewählter [KBV-Schlüsseltabellen](https://applications.kbv.de/overview.xhtml), siehe Package\n gematik.kbv.sfhir.cs.vs im Plugin\n- Dokumentenaustausch: Aus Performancegründen werden derzeit keine Codes und ValueSets aus dem Terminologiepackage\n `hl7.terminology.r4` validiert\n\n#### DIGA\n\nAbweichend vom allgemeinen Prüfumfang verhält sich das DIGA-Plugin wie folgt:\n\n- Codes aus den CodeSystemen `http://fhir.de/CodeSystem/ifa/pzn` und `http://fhir.de/CodeSystem/dimdi/atc` werden nicht\n validiert\n- Instanzen mit unbekannten Profilen führen zum invaliden Ergebnis\n- Instanzen mit unbekannten Extensions führen zum invaliden Ergebnis\n\n#### VSDM-Ersatzbescheinigung\n\nMit dem Modul können sowohl die Instanzen\nder [1.0](https://simplifier.net/packages/de.gematik.elektronische-versicherungsbescheinigung/1.0.1)- als auch\nder [1.1-Spezifikation](https://simplifier.net/packages/de.gematik.elektronische-versicherungsbescheinigung/1.1.0/)\nvalidiert werden.\nDie [Übergangszeiträume für die Gültigkeit der Spezifikationen](https://simplifier.net/guide/Implementierungsleitfaden-VSDM-Ersatzbescheinigung/Einfuehrung/Interoperabilitaetsvorgaben?version=current)\nwerden vom Plugin berücksichtigt.\n\nAnpassungen der Packages:\n\n- ValueSet-versicherungsart-de-basis.json in de.basisprofil.r4-1.3.2 korrigiert\n\n#### KIM-Nachrichten für das E-Rezept\n\nAbweichend vom allgemeinen Prüfumfang verhält sich das Plugin wie folgt:\n\n- Codes aus den folgenden Codesystemen werden nicht validiert:\n - `http://fhir.de/CodeSystem/bfarm/atc`\n - `http://fhir.de/CodeSystem/ask`\n - `http://fhir.de/CodeSystem/ifa/pzn`\n - \"http://snomed.info/sct\"\n - \"https://terminologieserver.bfarm.de/fhir/CodeSystem/arzneimittel-referenzdaten-pharmazeutisches-produkt\"\n\nZur erfolgreichen Validierung muss zusätzlich die Abgängikeit `kbv.all.st#1.24.0` eingebunden werden.\n\n#### E-Rezept für die EU (ERP-EU)\n\nbweichend vom allgemeinen Prüfumfang verhält sich das EPA-Medication-Plugin wie folgt:\n\n- Codes aus den folgenden Codesystemen werden nicht validiert:\n - `http://fhir.de/CodeSystem/bfarm/atc`\n - `http://fhir.de/CodeSystem/ifa/pzn`\n\n_Zusatzinformation:_ Das Plugin lädt derzeit große HL7-Terminologiepakete (je ~5 MB), was die Paketgröße und damit\ndie Validierungsdauer deutlich erhöht, obwohl vermutlich nur wenige enthaltene ValueSets/CodeSystems tatsächlich\nbenötigt werden; eine Lösung ist geplant, hat aber aktuell keine Priorität.\n\n## Nutzung mit dem Referenzvalidator\n\nSiehe Dokumentation vom [gematik Referenzvalidator](https://github.com/gematik/app-referencevalidator).\n\n## Erstellung von Plugins mittels Plugin-Builders\n\n### Vorbereitungen\n\n1. [Die letzte Version](https://github.com/gematik/app-referencevalidator-plugins/releases/latest) vom PluginBuilder\n herunterladen\n2. Die Ordnerstruktur für das neue Plugin (z.B. mit dem Namen `my-plugin`) vorbereiten:\n\n```\nmy-plugin/\n├── test-files/\n│ ├── valid/ \n│ └── invalid/\n├── src-packages/\n├── patches/\n└── config.yaml\n```\n\n3. Die Plugin-Definitionsdatei erstellen (siehe [Plugin-Definitionsdatei](#plugin-definitionsdatei-configyaml)).\n4. Test-Instanzen vorbereiten (siehe [Test-Instanzen](#testinstanzen))\n5. (optional) Quell-FHIR-Packages ablegen (siehe [Quell-FHIR-Packages](#quell-fhir-packages))\n6. (optional) Patches für die Ressourcen in den Quell-FHIR-Packages ablegen (\n siehe [Patches für die Quell-FHIR-Packages](#patches-für-die-quell-fhir-packages))\n\n#### Plugin-Definitionsdatei (`config.yaml`)\n\n\u003e **Warning**\n\u003e Seit der Version 2.x des PluginBuilders wird ausschließlich die Version 2.0 der Plugin-Definitionsdatei unterstützt.\n\u003e Die Version 1.x (siehe git-History der README.md für weitere Informationen) wird nicht mehr unterstützt.\n\u003e Mit der Version 2.0 der Plugin-Definitionsdatei ist es möglich, mehrere FHIR-Packagelisten zu definieren, die von\n\u003e einem Plugin validiert werden können.\n\n| Eigenschaft | Bezeichnung in config.yaml | Pflichtangabe | Beschreibung | Beispiel |\n|---------------------------------------------------------------------------|----------------------------------------------------------------|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Version der Definition-Beschreibungssprache | configSpecVersion | Ja | Derzeit fest auf 2.0 | 1.0 |\n| Name | id | Ja | Identifikator des Plugins. Wird für die Paketierung und den Aufruf im Referenzvalidator verwendet | isik3-terminplanung |\n| Version | version | Ja | Version des Plugins | 1.0.0 |\n| Author | author | Ja | Author des Plugins. | gematik |\n| Beschreibung | description | Ja | Eine kurze Beschreibung des Plugins und seines Validierungsumfangs. | Dies ist eine Beispielbeschreibung des Plugins. |\n| 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 |\n| Paketlisten zur Validierung | validation.dependencyLists | Ja | Eine Paketliste besteht mindestens aus einem Hauptpackage, dessen Profile validiert werden sollen. | |\n| Paketname | validation.dependencyLists[x].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 |\n| Validierungsabhängigkeiten | validation.dependencyLists[x].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 Haupt-Packages unter `fhirPackage` und falls das Package *nicht* im `src-packages`-Ordner abgelegt wurde) | - \"kbv.basis#1.3.1\"\u003cbr/\u003e- \"kbv.ita.for#1.3.1\" |\n| Gültigkeitsdatum Von | validation.dependencyLists[x].validFrom | Nein | Starddatum der Gültigkeit der Paketliste (MEZ) | \"2023-01-01\" |\n| Gültigkeitsdatum Bis | validation.dependencyLists[x].validTill | Nein | Enddatum der Gültigkeit der Paketliste (MEZ) | \"2023-01-31\" |\n| Selektionsausdrücke für Instanzerstellungsdatum | validation.dependencyLists[x].creationDateLocators | Nein | Mit den Selektionsausdrücke für Instanzerstellungsdatum kann das Plugin prüfen, ob die zu validierende FHIR-Ressource während der Gültigkeitsperiode der entsprechenden Packagesliste erstellt wurde | |\n| Profil für den Selektionsausdruck | validation.dependencyLists[x].creationDateLocators[x].profile | Nein | Wenn das Profil-CanonicalUrl in einer FHIR-Ressource referenziert wird, prüft das Plugin mittels des angegebenen fhirPath-Ausdrucks, ob das Erstellungsdatum dieser Ressource in der Gültigkeitsperiode der entsprechenden Packagesliste liegt | \"https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKTermin\" |\n| [FHIRPath](https://hl7.org/fhirpath/)-Ausdruck für den Selektionsausdruck | validation.dependencyLists[x].creationDateLocators[x].fhirPath | Nein | Mit dem FHIRPath-Ausdruck wird ein Ausdruck angegeben oder ein Element der zu validierenden FHIR-Ressource selektiert, an dem das Erstellungsdatum dieser Ressource abgelesen werden kann | \"Appointment.start\" |\n| Kritikalitätsbewertung der Validierungsausgaben | validation.dependencyLists[x].validationMessageTransformations | Nein | Veränderung der Kritikalitätsstufe der Ausgaben des Validators. | transformation1:\u003cbr\u003e- severityLevelFrom: \"error\"\u003cbr\u003e- severityLevelTo: \"information\"\u003cbr\u003e- locatorString: \"Appointment.participant:AkteurPatient\"\u003cbr\u003e- messageId: \"Validation_VAL_Profile_Minimum\" |\n| 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\" |\n| Zu ignorierende ValueSets | validation.ignoredValueSets | Nein | ValueSets, die im Rahmen der Validierung nicht überprüft werden sollen | \"http://fhir.de/ValueSet/bfarm/ops\" |\n| Unbekannte Extensions führen zu Fehlern | validation.anyExtensionsAllowed | Nein | Festlegung, ob unbekannte Extensions in den Instanzen zu Fehlern führen sollen | false |\n| 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 |\n| Akzeptierte Dateiformate | validation.acceptedEncodings | Nein | Festlegung, welche Dateiformate bei Validierung ausschließlich akzeptiert werden sollen | xml |\n| Snapshot-Abhängigkeiten | snapshotDependencies | Nein | Liste von zusätzlichen FHIR-Packages (Format abc#X.Y.Z), die nur für die Snapshot-Generierung benötigt werden. Wenn die Packages nicht im Abhängigkeitsbaum der Validierungspackages, dann werden sie heruntergeladen und beim Snapshot-Generierung verwendet. Wenn die Packages in dem Abhängigkeitsbaum der Validierungspackages auftauchen, dann werden sie aus dem finalen Abhängigkeitsbaum entfernt. | \"ein-nur-fuer-snapshot-generierung-benoetigtes-package#x.y.z\" |\n\nBeispiel einer `config.yaml`-Datei:\n\n```yaml\nconfigSpecVersion: \"2.0\"\nid: \"isik3-terminplanung\"\nversion: \"1.0.0\"\nauthor: \"gematik\"\ndescription: \"Dies ist eine Beispielbeschreibung des Plugins.\"\nspecUrl: \"https://simplifier.net/packages/de.gematik.isik-terminplanung/3.0.0\"\nvalidation:\n dependencyLists:\n - fhirPackage: \"de.gematik.isik-terminplanung#3.0.0\"\n dependencies:\n - \"kbv.basis#1.3.1\"\n - \"kbv.ita.for#1.3.1\"\n validFrom: \"2023-01-01\"\n validTill: \"2023-01-31\"\n creationDateLocators:\n - profile: \"https://gematik.de/fhir/isik/v3/Terminplanung/StructureDefinition/ISiKTermin\"\n fhirPath: \"Appointment.start\"\n validationMessageTransformations:\n transformation1:\n severityLevelFrom: \"error\"\n severityLevelTo: \"information\"\n locatorString: \"Appointment.participant:AkteurPatient\"\n messageId: \"Validation_VAL_Profile_Minimum\"\n errorOnUnknownProfile: \"true\"\n anyExtensionsAllowed: \"false\"\n acceptedEncodings:\n - \"xml\"\n ignoredCodeSystems:\n - \"http://snomed.info/sct\"\n ignoredValueSets:\n - \"http://fhir.de/ValueSet/bfarm/ops\"\nsnapshotDependencies:\n - \"ein-nur-fuer-snapshot-generierung-benoetigtes-package#x.y.z\"\n```\n\n#### Testinstanzen\n\nIm Ordner `test-files` müssen mindestens eine valide (im Unterordner `valid`) sowie eine invalide (im Unterordner\n`invalid`) FHIR-Ressource als Testinstanz von einem Profil aus `validation.fhirPackage` hinterlegt werden, um\nsicherzustellen, dass die Validierung mit dem gebauten Plugin auch funktioniert. Im besten Fall sollte für jedes\nenthaltene Profil aus `validation.dependencyLists[x].fhirPackage` jeweils eine valide und eine invalide FHIR-Ressource\nals Testinstanz hinterlegt werden. Der PluginBuilder weist in seiner Konsolenausgabe auf die Profile mit fehlenden\nTestinstanzen hin.\n\n#### Quell-FHIR-Packages\n\nIm Ordner `src-packages` können FHIR-Packages\nim [FHIR Package Standard](https://confluence.hl7.org/display/FHIR/NPM+Package+Specification) hinterlegt werden. Die\nhier hinterlegten FHIR-Packages werden zusätzlich zu den Abhängigkeiten des Plugin-Pakets (siehe\n`validation.fhirPackage`) für die Validierung von FHIR-Ressourcen verwendet.\n\n#### Patches für die Quell-FHIR-Packages\n\nHier können einzelne FHIR-Ressourcen hinterlegt werden, die die FHIR-Ressourcen in originellen FHIR-Packages ergänzen\noder ersetzen sollten (z.B. für den Fall wenn in einem Profil eines bereits veröffentlichten Quell-FHIR-Package ein\nFehler vorliegt, der die Validierung verhindert).\n\n** Warning **\n\u003e Die Dateien müssen exakt denselben Namen haben, wie die fehlerhaften Dateien im Quell-FHIR-Package. Sie müssen im\n\u003e Unterordner abgelegt werden, dessen Name im Format [FHIR-Package-Name]-[FHIR-Package-Version] dem Quell-FHIR-Package\n\u003e entspricht\n\nBeispiel:\n\n```\nmy-plugin/\n└── patches/\n └── package1-1.0.0/\n └── some-profile-with-fixes.json\n```\n\n### Aufruf des Plugin-Builders zur Erstellung von Plugins\n\n\u003e **Warning**\n\u003e Um Abhängigkeiten der FHIR-Pakages zu herunterladen, erfordert der Plugin-Builder direkte Verbindung zum Internet.\n\u003e Derzeit ist keine Proxy-Server-Konfiguration möglich\n\nBeispielaufrufe des Plugin-Builders (build):\n\n`java -jar plugin-builder-cli-X.Y.Z.jar build C:\\user\\plugindefinitions\\my-plugin`\n\n`java -jar plugin-builder-cli-X.Y.Z.jar build C:\\user\\plugindefinitions\\my-plugin -t C:\\output`\n\nDas erste Argument ('build') gibt an, dass der build-Prozess gestartet werden soll. Das zweite Argument ist\nverpflichtend und gibt den Pfad zum Ordner mit Plugin-Ressourcen an. Optional gibt es folgende Parameter:\n\n| Parameter | Beschreibung |\n|--------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| `-t` oder\u003cbr/\u003e`--targetFolderPath` | Ausgabeverzeichnis. Standardmäßig wird das Parent-Verzeichnis vom Plugin-Ressourcen-Ordner als Ausgabeverzeichnis verwendet |\n| `-url` oder\u003cbr/\u003e`--packageServerUrl` | URL eines alternativen FHIR Package Servers. Standardmäßig werden http://packages.fhir.org und https://packages2.fhir.org/packages verwendet |\n\nNeben Konsolenausgabe schreibt der Plugin-Builder während der Ausführung ein Protokoll mit WARN- und ERROR-Meldungen,\ndie von der zugrundeliegenden HAPI-Bibliothek während der Snapshot-Generierung produziert wurden (`warn.log`).\n\n### Testen von Plugins mittels des Plugin-Builders\n\nMithilfe des Plugin-Builders können auch bereits gebaute Plugins getestet werden.\n\nBeispielaufrufe des Plugin-Builders (test):\n\n`java -jar plugin-builder-cli-X.Y.Z.jar test C:\\user\\plugindefinitions\\my-plugin.zip C:\\user\\test-files`\n\nDas erste Argument ('test') gibt an, dass der test-Prozess gestartet werden soll. Hier sind auch die beiden folgenden\nArgumente verpflichtend. Das zweite gibt den Pfad zum zu testenden Plugin an und das dritte ist der Pfad zum Ordner, der\ndie Testinstanzen enthält.\n\n### Bauen von Plugins mit Hilfe von Maven\n\nVor dem Bauen der Plugins muss zuerst das PluginBuilder-Projekt gebaut werden. Dazu wird der Befehl\n`mvn clean package -pl :plugin-builder` im Hauptverzeichnis des PluginBuilder-Projekts aufgerufen.\n\nAlle bereits integrierten Plugins können anschließend mit dem Aufruf `mvn clean install -Pbuild-plugins` gebaut werden.\nUm ein einzelnes, spezielles Plugin zu bauen wird folgender Aufruf benötigt:\n`mvn clean install -pl :valmodule-eeb -Pbuild-plugins`. Dieser Aufruf würde das `valmodule-eeb` einzeln bauen.\n\n## Beiträge zum Projekt\n\nFür Beiträge zum PluginBuilder oder den Plugins siehe [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n## License\n\nCopyright 2025-2026 gematik GmbH\n\nApache License, Version 2.0\n\nSee the [LICENSE](./LICENSE) for the specific language governing permissions and limitations under the License.\n\n## Additional Notes and Disclaimer from gematik GmbH\n\n1. Copyright notice: Each published work result is accompanied by an explicit statement of the license conditions for\n use. These are regularly typical conditions in connection with open source or free software. Programs\n described/provided/linked here are free software, unless otherwise stated.\n2. Permission notice: Permission is hereby granted, free of charge, to any person obtaining a copy of this software and\n associated documentation files (the \"Software\"), to deal in the Software without restriction, including without\n limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the\n Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n1. The copyright notice (Item 1) and the permission notice (Item 2) shall be included in all copies or substantial\n portions of the Software.\n2. The software is provided \"as is\" without warranty of any kind, either express or implied, including, but not limited\n to, the warranties of fitness for a particular purpose, merchantability, and/or non-infringement. The authors or\n copyright holders shall not be liable in any manner whatsoever for any damages or other claims arising from, out of\n or in connection with the software or the use or other dealings with the software, whether in an action of contract,\n tort, or otherwise.\n3. The software is the result of research and development activities, therefore not necessarily quality assured and\n without the character of a liable product. For this reason, gematik does not provide any support or other user\n assistance (unless otherwise stated in individual cases and without justification of a legal obligation).\n Furthermore, there is no claim to further development and adaptation of the results to a more current state of the\n art.\n3. Gematik may remove published results temporarily or permanently from the place of publication at any time without\n prior notice or justification.\n4. Please note: Parts of this code may have been generated using AI-supported technology. Please take this into account,\n especially when troubleshooting, for security analyses and possible adjustments.\n\n## Kontakt\n\nFragen, Anregungen, Bug Reports und Feature requests sind willkommen und können gerne über\ndie [GitHub Issues](https://github.com/gematik/app-referencevalidator-plugins/issues) oder\nüber [referenzvalidator\u0026commat;gematik.de](mailto:referenzvalidator\u0026commat;gematik.de) eingereicht werden.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgematik%2Fapp-referencevalidator-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgematik%2Fapp-referencevalidator-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgematik%2Fapp-referencevalidator-plugins/lists"}