Der Validator
Der Validator ist für die Prüfung von XZuFi-Dokumenten nach Schema-Konformität und PVOG-internen Regeln verantwortlich.
Was ist der Validator?
Der Validator prüft XZuFi-Dokumente auf Schema-Konformität und PVOG-spezifische Regeln. XZuFi-Dokumente werden von Bund und Ländern im XZuFi-Format bereitgestellt. Neben der Überprüfung des XML-Schemas gemäß des standardisierten XZuFi-Formats stellt der Validator sicher, dass die Dokumente auch den fachlichen Anforderungen des PVOG entsprechen. Diese fachliche Validierung wird nicht durch eine technische Schema-Validierung abgedeckt und muss separat erfolgen.
Bei Importen nach dem Pull-Verfahren wird die Validierung während des Importes durchgeführt. Technisch nicht valide Daten werden vom PVOG abgelehnt. Bei der Zusendung von einzelnen Geschäftsobjekten im Push-Verfahren wird in der nächtlichen Gesamtbestandvalidierung geprüft, ob Fehler vorliegen.
Der Validator wird auch als separater Dienst angeboten, um Redaktionssystemen die Erstellung korrekter Verwaltungsleistungsdaten zu erleichtern. Das Validierungsergebnis wird in einem verständlichen Bericht ausgegeben.
Wie funktioniert der Validator?
Der Validator führt zwei Arten von Prüfungen durch: technische und fachliche Validierung.
Technische Validierung
Die technische Validierung überprüft, ob das Dokument dem XZuFi-Schema entspricht.
Fachliche Validierung
Die fachliche Validierung stellt sicher, dass das Dokument den PVOG-spezifischen Regeln entspricht. Diese Prüfung erfolgt nur, wenn die technische Validierung erfolgreich war. Die Regeln basieren auf dem Sammlerdienst-Konzept und den Anforderungen des PVOG.
Validierungsergebnisse
Die Ergebnisse der Validierung werden in drei Kategorien eingeteilt:
- Fehler: Ein schwerwiegender Fehler, der die Verarbeitung verhindert.
- Warnung: Ein Fehler, der die Verarbeitung zukünftig verhindern könnte und behoben werden sollte.
- Hinweis: Ein Hinweis auf einen möglichen Mangel, der überprüft werden sollte, aber nicht zwingend behoben werden muss.
Technologie
Die Kernfunktionalität der technischen wie fachlichen Validierung wird durch eine in Java entwickelte Library bereitgestellt, die in den Sammlerdienst und den Validator-Dienst integriert ist.
Der Validator-Dienst ist eine auf Spring Boot basierende Web-Anwendung, die ebenfalls mit Java realisiert wird. Zur Datenhaltung wird eine relationale Datenbank (PostgreSQL) verwendet.
Kurzüberblick (Validator-Dienst):
- Java Spring Boot Web-Anwendung
- REST API
- Keycloak Authentifizierung Integration
- Relationale Datenbank (PostgreSQL)
- OpenAPI-konforme API-Beschreibung
- Logging mit EFK-Unterstützung
