Summary und Fundstellen: unterschiedliche Validatoren, eine gemeinsame Sicht

Die einzelnen Validatoren arbeiten mit unterschiedlichen Report-Formaten. Für die Oberfläche werden diese Ergebnisse normalisiert und in einer gemeinsamen "Summary" zusammengeführt. Damit entsteht eine einheitliche Schnittstelle für Anzeige, Navigation und Auswertung.

  1. Normalisierung der Ergebnisse
  2. Die Summary als Detailansicht
  3. Vom Fehler direkt ins Dokument
  4. Ergebnisse bleiben beim OCF

1. Normalisierung der Ergebnisse

  • Schema-Validator,
  • Schematron,
  • Linkchecker,
  • FShape
  • und KI 

können technisch unterschiedliche Ausgaben erzeugen. Die Normalisierung führt diese Ergebnisse in ein gemeinsames Modell über. Ein Fund kann dadurch unabhängig vom ursprünglichen Validator mit Schweregrad, Meldung, Datei und Location beschrieben werden.

2. Die Summary als Detailansicht

Die Summary fasst die Gesamtzahl der Fehler und Warnungen sowie die Ergebnisse einzelner Prüfverfahren zusammen. Darunter folgt die Liste der konkreten Issues mit Quelle, Schweregrad, Meldung, Datei und Fundstelle.

Validerungsansicht mit Summary und Fehlerliste

Abbildung 6: Das Validerungs-Menü mit kurzer Summary und Auflistung aller Fehlerstellen.

3. Vom Fehler direkt ins Dokument

Die XML-Location verbindet das normalisierte Issue mit dem eigentlichen Dokument. Ein XPath wird verwendet, um die betroffene Stelle im Viewer zu lokalisieren und im strukturellen Kontext anzuzeigen.

Viewer-Menü mit Fehlernavigation und markierter Fundstelle im XML

Abbildung 7: Das Viewer-Menü zeigt die Fehler-Fundstelle im Dokument an.

So wird aus einem technischen Report eine navigierbare Qualitätssicherung: 

  1. Fehler auswählen
  2. Fundstelle anzeigen
  3. Kontext verstehen
  4. und gezielt korrigieren.

4. Ergebnisse bleiben beim OCF

Die Validierungsreports können im Bereich processing/validation/ des OCF abgelegt und im Manifest registriert werden. Damit bleibt die Prüfhistorie mit dem Paket verbunden und kann von nachfolgenden Prozessen weiterverwendet werden.