Referenzvalidator

Über den Referenzvalidator

Der Referenzvalidator ermöglicht eine erweiterte Validierung von FHIR-Ressourcen, wie sie beispielsweise in den Anwendungen der Telematikinfrastruktur (TI) verwendet werden. Er liefert autoritative Antworten zur Validität von übertragenen Datensätzen und bildet eine Referenz für andere FHIR-Validatoren. Systeme, die FHIR-Profile im Rahmen einer Anwendung implementieren, können mit dem Referenzvalidator die Korrektheit der Umsetzung überprüfen.

Der Referenzvalidator hilft, die Qualität der übertragenen FHIR-Daten zu erhöhen, unterstützt den Prozess der Spezifikationserstellung und reduziert die Aufwände bei Fehleranalysen und Korrekturen.

Funktionsumfang

• Validierung von FHIR-Ressourcen anhand der referenzierten Profile
• Der Prüfumfang entspricht dem Umfang des HL7 Java Validators:
  • Struktur: Alle Elemente einer Instanz MÜSSEN in dem referenzierten Profil definiert sein
  • Kardinalität: Die Min/Max-Angaben aller Eigenschaften sind berücksichtigt
  • Wertebereiche: Die Wertebereiche von Eigenschaften werden berücksichtigt (einschließlich aufgelisteter Codes)
  • Coding/CodeableConcept bindings: Die Code-Angaben in einer Instanz entsprechen der Definition des Kodierungssystems aus dem Profil
  • Constraints/Invariants: Die für die Eigenschaften im Profil definierten Regeln sind eingehalten
• Prüfung der Gültigkeitszeiträume der in den Instanzen referenzierten Profile
• Nutzung der FHIR-Package-Abhängigkeiten in Abhängigkeit von dem Instanz-Erstellungszeitpunkt (bspw. der datumsabhängigen KBV-Schlüsseltabellen)

Weitere Informationen über den Funktionsumfang können dem technischen Konzept auf der GitHub-Projektseite entnommen werden.

Unterstützte Anwendungen

Folgende Anwendungen werden unter anderem durch entsprechende Validierungsmodule unterstützt:

• E-Rezept
• Elektronische Arbeitsunfähigkeitsbescheinigung
• FHIR Core
• Informationstechnische Systeme im Krankenhaus (ISiK)
• VSDM-Ersatzbeschenigung

Mittels eines Erweiterungsmechanismus können weitere Validierungsmodule (genannt Plugins) unabhängig von dem Referenzvalidator erstellt und verteilt werden. Download und eine Übersicht der verfügbaren Plugins bietet die entsprechende GitHub-Projektseite. 

Installation und Verwendung

Der Referenzvalidator wird als Java-basierte Konsolenanwendung und als eine Bibliothek zur Integration in Java-Anwendungen verteilt. Weitere Informationen zur Installation und Verwendung finden sich auf der GitHub-Projektwebseite. 

Sie haben Fragen zum Referenzvalidator?

Für die Klärung technischer Fragen ist das Expertenteam des gematik Referenzvalidators Ihr kompetenter Ansprechpartner.

Gern beantwortet die gematik Ihre Fragen. Anfragen bzgl. der Funktionalität oder Fehlerberichte können über die GitHub-Projektseite gemeldet werden. Zukünftige Weiterentwicklung kann auch auf dem entsprechenden Kanal unter chat.fhir.org diskutiert werden. Für alle Fragen stehen wir auch unter der E-Mail-Adresse referenzvalidator[at]gematik(dot)de zur Verfügung. 

Um Ihnen bei ihren Fragen oder Störungen am schnellsten weiterhelfen zu können, bitten wir Sie (falls möglich), folgende Informationen in der E-Mail zu hinterlegen:

• Welche Version des Referenzvalidators ist im Einsatz?
• Welches Validierungsmodul wird genutzt?
• Kurze Problembeschreibung.
• Falls möglich, direkt Screenshots und/oder die Konsolenausgabe des Referenzvalidators in der Mail anhängen.

Kontakt

Fragen, Anregungen, Bug Reports und Feature Requests sind willkommen und können gerne über die GitHub Issues oder über referenzvalidator[at]gematik(dot)de eingereicht werden. Zudem steht für interessierte im internationalen FHIR Chat ein Forum zum Austausch mit der Community zur Verfügung.

Newsletter

Über unseren Newsletter informieren wir bedarfsgerecht bei Updates, kritischen Bugs und Weiterentwicklungen. Wir empfehlen daher insbesondere den Nutzern des Validators in einem produktiven Einsatz das Abonnement.