METS-Validierung im Rosetta-Kontext

Digitale Ressourcen können über verschiedene Verfahren in Rosetta eingeliefert werden, s. Einlieferung. Unabhängig vom gewählten Ingest-Verfahren werden innerhalb von Rosetta alle geinsteten Metadaten in eine METS-Datei geschrieben, die dem Rosetta-eigenen METS-Profil entspricht. Dabei beschreibt eine METS-Datei in Rosetta immer jeweils eine Intellectual Entity, s. Das METS-Metadatenaustauschformat in Rosetta.

Bei der Durchführung eines METS-Ingests, s. METS können innerhalb von Rosetta Fehlermeldungen auftreten, sobald eine geingestete METS-Datei in Rosetta nicht problemlos in eine Rosetta-METS-Datei umgewandelt werden kann. Zur frühzeitigen Fehlervermeidung bzw. -behebung kann es daher sinnvoll sein, bereits vor dem Ingest der Daten in Rosetta METS-Dateien gegen das Rosetta-METS-Profil zu validieren. Man spricht in diesem Kontext auch von Pre-Ingest-Validierung.

Die Pre-Ingest-Validierung einer für den Ingest vorgesehenen METS-Datei erfolgt auf Grundlage von zwei Rosetta-eigenen XML-Schema-Definitionen (XSD), welche die Struktur von METS-Dateien innerhalb von Rosetta definieren.  Dabei gibt die mets_rosetta.xsd  die Gesamtstruktur einer Rosetta-METS-Datei vor, s. Das METS-Metadatenaustauschformat in Rosetta. Die Schema-Definition des DNX-SIP-Profils  dnx_sip.xsd gibt konkret die Struktur für administrative Metadaten eines Submission Information Package vor, s. Administrative Metadaten in Rosetta. 

Validierung des Rosetta-METS mit Xerces XSD11-validator.jar

Die mets_rosetta.xsd, gegen die eine für den Ingest vorgesehene METS-Datei validiert werden muss, liegt in der XSD Version 1.1 vor, die von manchen Programmen wie Notepad++ nicht unterstützt wird. Daher muss die Pre-Ingest-Validierung über Tools erfolgen, welche XSD Version 1.1 unterstützen. 

Ein geeignetes Tool zur Validierung von METS-Dateien gegen die mets_rosetta.xsd ist zum Beispiel der Xerces XML Schema 1.1 validator. Dabei handelt es sich um eine Java-Anwendungsdatei zur XSD-Validierung mittels Kommandozeile. Im Folgenden wird beschrieben, wie eine METS-Datei mittels Xerces gegen die Schema-Definitionen mets_rosetta.xsd und dnx_sip.xsd validiert werden kann.

Voraussetzungen

• Herunterladen der Datei xsd11-validator.jar
• Herunterladen der Dateien mets_rosetta.xsd und dnx_sip.xsd vom Ex Libris Developer Network
• Vorhandensein eines METS-Files, das validiert werden soll. Zum Beispiel die Datei ie.xml
• Die beiden Dateien mets_rosetta.xsd und dnx_sip.xsd müssen in demselben Ordner auf dem Rechner gespeichert sein. Beispiel: C:/Users/Username/Desktop
• Das Programm xsd11-validator.jar wird über einen Befehl in der Kommandozeile ausgeführt. Voraussetzung hierfür ist, dass das Programm über die Kommandozeile aus dem Verzeichnis heraus gestartet wird, in dem die Datei xsd11-validator.jar liegt, z.B. C:/Users/Username/Downloads

Kommandozeilenbefehl

Befindet sich die Datei xsd11-validator.jar im Ordner C:/Users/Username/Downloads und die Dateien mets_rosetta.xsd und dnx_sip.xsd sowie die zu validierende Datei ie.xml im Verzeichnis C:/Users/Username/Desktop, muss der Befehl aus dem Verzeichnis C:/Users/hbz-User/Download heraus ausgeführt werden und auf die auf dem Desktop liegenden XSD-Dateien verweisen.

Der Befehl lautet in diesem Fall:

java -jar xsd11-validator.jar -if C:/Users/Username/Desktop/ie.xml -sf C:/Users/Username/Desktop/mets_rosetta.xsd

Fehlermeldungen allgemein

Ist die Datei ie.xml bereits valide im Sinne des Rosetta-METS-Profils, erscheint keine Meldung in der Kommandozeile. Sollten Validierungsfehler auftreten, werden diese in der Kommandozeile ausgegeben. Dabei werden auch die Zeile und Position des jeweiligen Fehlers in der Rosetta-METS-Datei aufgeführt.

Beispiele für mögliche Fehlermeldungen bei der Pre-Ingest-Validierung

• Falscher Namensraum deklariert: "Cannot find the declaration of element 'mets:mets'" 
  • Fehlerursache:
    • Bei den meisten METS-Files stimmt der im Header der Datei aufgeführte Namespace (mets:mets xmlns:mets="http://www.loc.gov/METS/") nicht mit dem Namespace des Rosetta-METS-Profils (mets:mets xmlns:mets="https://developers.exlibrisgroup.com/wp-content/uploads/2022/06/mets_rosetta.xsd") überein. Dadurch kann die METS-Datei nicht validiert werden und es erscheint folgende Fehlermeldung in der Kommandozeile:

    • [Error] file:///C:/Users/Username/Desktop/ie.xml:2:51: cvc-elt.1.a: Cannot find the declaration of element 'mets:mets'.

• • • Solange dieser Fehler nicht behoben wird, kann keine weitere Pre-Ingest-Validierung stattfinden, bei der ggf. weitere Fehlermeldungen auftreten.
    • Screenshot anzeigen

      

• • Fehlerbehebung:
    • Der Fehler kann behoben werden, indem der im Header angegebene Namespace (zum Beispiel: xmlns:mets="http://www.loc.gov/METS/") durch den Namespace für das Rosetta-METS ersetzt wird (<mets:mets xmlns:mets="https://developers.exlibrisgroup.com/wp-content/uploads/2022/06/mets_rosetta.xsd">). Danach kann die METS-Datei weiter gegen die mets_rosetta.xsd und dnx_sip.xsd validiert werden und die Kommandozeile gibt etwaige weitere Fehlermeldungen aus.
    • Screenshot anzeigen

      

• Fehler in XML-Syntax: "dc:creator must be terminated by the matching end-tag“ 
  • Fehlerursache:
    • Bei der Pre-Ingest-Validierung einer METS-Datei werden auch etwaige Syntax-Fehler in der METS-XML-Datei festgestellt und deren Zeile und Position angegeben. Fehlt zum Beispiel ein schließendes XML-Tag </>, erfolgt in der Kommandozeile eine Fehlermeldung wie diese: 

    • [Error] file:///C:/Users/Username/Desktop/ie.xml:18:8: The element type "dc:creator" must be terminated by the matching end-tag "</dc:creator>".

       
    • Screenshot anzeigen

      

• • Fehlerbehebung:
    • Syntax-Fehler müssen über eine entsprechende Korrektur in der METS-Datei behoben werden, in diesem Beispiel muss <dc:creator> durch </dc:creator> ersetzt werden.