Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Die Anwendung und das Verständnis der Funktionsweise der Schematron-Validierungen setzt Kenntnisse von Schematron und der den verwendeten Techniken voraus (XPath, XSLT).

...

Die Schematron-Validierungen der Fachstelle Bibliothek setzen pro Datensatz genau eine Datei voraus. Ein Datensatz muss das jeweilige Wurzelelement enthalten (z. B. <mets:mets>), welches optional in weitere Elemente (z. B. "OAI-Wrapper") eingebettet sein kann.
Die Fachstelle stellt die Validierungen jeweils als Schematron-Datei und als mit der Skeleton Implementierung kompilierte XSL-Datei zur Verfügung. Letztere verwendet sie zusammen mit Saxon-HE zur Erzeugung des Analysereports.

Alle Dateien sowie eine Übersicht der Änderungen stellt die Fachstelle über das GitHub Repository der Deutschen Digitalen Bibliothek zur Verfügung.

Anwendungsprofil für DDB-METS/MODS

...

v2021-08-06T14:45:36

...

METS/MODS-Anwendungsprofil für Zeitungen

v2021-08-06T14:45:44

...

Diese Validierung prüft Datensätze auf die Anforderungen aus dem Anwendungsprofil für DDB-METS/MODS. Sie ist für Datensätze ausgelegt, die einteilige Dokumente, Teile von mehrteiligen Dokumenten oder Ankersätze beschreiben.

 Anwendungsprofil für DDB-METS/MODS - Aufbau für Zeitungsausgaben

Diese Validierung prüft Datensätze auf die Anforderungen aus dem Anwendungsprofil für DDB-METS/MODS - Aufbau für Zeitungsausgaben.
Die Validierung ist nur für Datensätze zu Ausgaben ("issue") bzw. Beilagen ("additional") einer Zeitung ausgelegt. Sie kann daher keine Datensätze zu übergeordneten Strukturen (Bände, Zeitungen) prüfen. 

DDB EDM Anwendungsprofil

  • in Vorbereitung

DDB MARC 21 (XML)

...

Anwendungsprofil

  • in Vorbereitung

Bestandteile der Schematron-Dateien

Die Schematron-Dateien enthalten Informationen zur Auswertung und Analyse der Fehlergenauen technischen Prüfung und Auswertung. Sie werden im Folgenden beschrieben und stellen - soweit möglich - Bezüge zum Analysereport her.

...

Bezeichnung

Die Bezeichnung eines Fehler einer Meldung befindet sich in einem Kommentar über dem Element "sch:assert" bzw. "sch:report".
Sie dient im Analysereport als "Titel" des FehlersMeldung.

Code Block
languagexml
themeEclipse
titleBeispiel
collapsetrue
...
<sch:pattern>
   <sch:rule context="mets:xmlData/mods:mods/mods:titleInfo[@type]">
      <!-- Falsche Attributwerte inUngültiger Wert im Attribut type von mods:titleInfo -->
      <sch:assert 
         id="titleInfo_04"
         ...
      >
    ...

...

Meldungstext und Hinweis auf das Anwendungsprofil

Die Fehlermeldung Meldung mit dem Hinweis auf die entsprechende Stelle im Anwendungsprofil befindet sich im Elementtext des Elements "sch:assert" bzw. "sch:report".
Beides wird im Analysereport direkt nach dem Titel angezeigtBeide Elemente können zusätzlich das Unterelement "sch:span" mit dem Attribut "class" mit folgenden Werten enthalten:

  • monotype
    • Festbreitenschriftart
  • italic
    • kursiv
  • bold
    • fett

Diese Angaben verwendet der Analysrerepot für entsprechende Textformatierungen.

Der Hinweis auf das Anwendungsprofil ist in Abhängigkeit vom Fehler von der Meldung ein Text oder eine URL.

Code Block
languagexml
themeEclipse
titleBeispiel
collapsetrue
...
<sch:assert
   id="titleInfo_04"
   ...
   >
   Das Attribut <sch:span class="monotype">type</sch:span> im Element 
   In mods:titleInfo dürfen in dem Attribut type <sch:span class="monotype">mods:titleInfo</sch:span> darf nur die im MODS-Anwendungsprofil genanntenfolgenden Werte verwendet werden. enthalten:
   Diese* Werte sind<sch:span class="abbreviated", "translated", "alternative", "uniform". Werden andere Werte verwendet, wird mods:titleInfo bei der Bereinigung der Daten entfernt. monotype">abbreviated</sch:span>
   Weitere* Informationen zu diesem Element s. MODS-Anwendungsprofil Kapitel 2.1.1
<<sch:span class="monotype">translated</sch:assert>
...
<sch:assert 
   id="originInfo_10"span>
   * <sch:span class="monotype">alternative</sch:span>
   ...
   >
   Der Wert in mods:dateIssued muss einem Tagesdatum nach dem ISO 8601 Standard entsprechen. * <sch:span class="monotype">uniform</sch:span>
  Ist dies nicht der Fall, kannwird die Ausgabe nicht dem 
   richtigen Datum im Kalender des Zeitungsportals zugeordnet werden und kann daher nicht in das Zeitungsportal übernommen werden. Weitere Informationen 
   zu diesem Element s. <sch:span class="monotype">mods:titleInfo</sch:span> bei der Bereinigung des Datensatzes entfernt.Weitere Informationen zu diesem Attribut finden Sie im DDB-METS/MODS-Anwendungsprofil auf der Seite mods:titleInfo (https://wiki.deutsche-digitale-bibliothek.de/display/DFD/Ausgabe+Zeitung+1.0#AusgabeZeitung1.0-ErscheinungsdatumderAusgabe
x/xcIeB). </sch:assert>
...

Verweise auf Beispiele

Ein Verweis auf die Best Practice-Beispiele zu den für den Fehler Meldung relevanten Elementen befindet sich im Attribut "see" des Elements "sch:assert" bzw. "sch:report".
Im Analysereport dient der Verweis als Link für den Text "Beispiele für dieses Element" unterhalb der FehlermeldungMeldung.

Code Block
languagexml
themeEclipse
titleBeispiel
collapsetrue
...
<sch:assert
   id="titleInfo_04"
   ...
   see="https://wiki.deutsche-digitale-bibliothek.de/display/DFD/titleInfo"
   >         
   ...
</sch:assert>
...

...

Meldungs-ID

Die FehlerMeldungs-ID befindet sich im Attribut "id" des Elements "sch:assert" bzw. "sch:report".
Sie dient in der Fehlerlistentabelle Meldungslistentabelle als Bezeichnung für das entsprechende Tabellenblatt, auf das der Analysereport verweist (z. B. "Die vollständige Liste der Fehler Meldungen finden Sie in der Fehlerlistentabelle Meldungslistentabelle im TabellenblatttitleInfo_04").

Code Block
languagexml
themeEclipse
titleBeispiel
collapsetrue
...
<sch:assert
   id="titleInfo_04"
   ...
   >         
   ...
</sch:assert>
...

...

Meldungs-Level

Das FehlerMeldungs-Level befindet sich im Attribut "role" des Elements "sch:assert" bzw. "sch:report".
Es dient zur Einordnung der Schwere des FehlersMeldung. Der Analysereport ordnet dem FehlerMeldungs-Level eine Farbe und Texte für die Grafik in der Übersicht und den Hinweis am Ende der einzelnen Fehlermeldungen Meldungen zu.

Die Validierungen verwenden die folgenden Werte:

  • info
    • blau
    • Datensätze mit Elementen, die in der DDB nicht berücksichtigt werden. (Grafik)
    • Diese Elemente werden in der DDB nicht berücksichtigt. (FehlermeldungMeldung)
  • warn
    • gelb
    • Fehlerhafte Datensätze, die unverändert eingespielt werden. (Grafik)
    • Dieser Fehler verhindert nicht das Einspielen der Datensätze. (Fehlermeldung (Meldung)
  • caution
    • grau
    • Datensätze, bei denen ein Verdacht auf Fehler vorliegt (Grafik)
    • Bei diesen Elementen besteht ein Verdacht auf Fehler (Meldung)
  • error
    • orange
    • Fehlerhafte Datensätze, die von der Fachstelle korrigiert werden. (Grafik)
    • Dieser Fehler wird von der Fachstelle Bibliothek bereinigt. (FehlermeldungMeldung)
  • fatal
    • rot
    • Fehlerhafte Datensätze, die nicht eingespielt werden. (Grafik)
    • Dieser Fehler verhindert das Einspielen der Datensätze. (FehlermeldungMeldung)
Code Block
languagexml
themeEclipse
titleBeispiel
collapsetrue
...
<sch:assert
   id="titleInfo_04"
   role="error"
   ...
   >         
   ...
</sch:assert>
...

...

Die Schematron-Validierungen verwenden in einigen Prüfungen Schematron-Properties (im Attribut "properties" des Elements "sch:assert" bzw. "sch:report").
Sie dienen dazu, Fehler relevante Elemente in den Datensätzen einfacher zu lokalisieren (Beispieldatensätze im Analysereport, Spalte "B" in der FehlerlistentabelleMeldungslistentabelle) bzw. im Analysereport Übersichten mit ungültigen Werten zu erzeugen.
Es gibt sowohl allgemeine als auch formatspezifische Properties, die im Folgenden beschrieben sind.

...

  • text
    • Der Elementinhalt (text()) des relevanten Elements
  • local_name

    • Der Name des relevanten Elements ohne Präfix (local-name())
  • name
    • Der Name des relevanten Elements mit Präfix (name())

...