Automatische Paginierung auf Basis der Dateinamen

Einführung
Die vorliegende Dokumentation beschreibt die Installation, Konfiguration und den Einsatz des Plugins. Mit Hilfe dieses Plugins können METS-Dateien automatisch aufbereitet, eine Grundstruktur erzeugt sowie eine Paginierung gesetzt werden.
Details
​
Identifier
intranda_step_imagename_analyse
Source code
​https://github.com/intranda/goobi-plugin-step-analyse-imagenames​
Lizenz
GPL 2.0 oder neuer
Kompatibilität
Goobi workflow 3.0.10
Dokumentationsdatum
14.08.2019
Voraussetzung
Voraussetzung für die Verwendung des Plugins ist der Einsatz von Goobi mindestens in der Version 3.0.10, die korrekte Installation und Konfiguration des Plugins sowie die korrekte Einbindung des Plugins in die gewünschten Arbeitsschritte der Workflows.
Installation und Konfiguration
Das Plugin besteht aus zwei Dateien:
1
plugin_intranda_step-imagename-analyse.jar
2
plugin_intranda_step_imagename_analyse.xml
Copied!
Die Datei plugin_intranda_step-imagename-analyse.jar enthält die Programmlogik und muss für den tomcat-Nutzer lesbar in folgendes Verzeichnis installiert werden:
1
/opt/digiverso/goobi/plugins/step/
Copied!
Die Datei plugin_intranda_step_imagename_analyse.xml muss ebenfalls für den tomcat-Nutzer lesbar sein und in folgendes Verzeichnis installiert werden:
1
/opt/digiverso/goobi/config/
Copied!
Diese Datei dient zur Konfiguration des Plugins und muss wie folgt aufgebaut sein:
plugin_intranda_step_imagename_analyse.xml
1
<?xml version="1.0" encoding="UTF-8"?>
2
<config>
3
    <skipWhenDataExists>false</skipWhenDataExists>
4
​
5
    <paginationRegex>.*_(\d+\w?[rv]\w?)\.\w+</paginationRegex>
6
​
7
    <structureList>
8
        <item filepart="ER" docstruct="RearCover" />
9
        <item filepart="SV" docstruct="FrontSection" />
10
        <item filepart="VD" docstruct="FrontCover" />
11
        <item filepart="HD" docstruct="BackCover" />
12
        <item filepart="VS" docstruct="Endsheet" />
13
        <item filepart="NS" docstruct="Postscript" />
14
        <item filepart="FR" docstruct="Fragment" />
15
        <item filepart="Fragm" docstruct="Fragment" />
16
    </structureList>
17
</config>
Copied!
Im Element skipWhenDataExists wird definiert, wie sich das Plugin verhält, wenn bereits eine Paginierung vorhanden ist. Bei dem Wert true wird die Ausführung übersprungen, bei false wird die vorhandene Struktur und Paginierung entfernt und eine neue erzeugt.
Das Element paginationRegex enthält einen regulären Ausdruck, mit dem versucht wird, die logische Seitenzahl aus dem Dateinamen zu extrahieren. Dabei wird der Wert aus der ersten Gruppe in die METS-Datei übernommen.
Falls der reguläre Ausdruck nicht erfolgreich war, wird im Anschluß geprüft, ob der Dateiname eine besondere Struktur wie Cover, Titlepage oder Contents beschreibt. Diese Struktur wird innerhalb von structureList definiert. Dabei wird innerhalb von dem Element item im Attribut filepart ein (Teil-) String definiert, der im Dateinamen vorkommen muss. Im Attribut docstruct wird das Strukturelement definiert, das in diesem Fall erzeugt werden soll.
Einstellungen in Goobi
Nachdem das Plugin installiert und konfiguriert wurde, kann es innerhalb eines Arbeitsschrittes von Goobi genutzt werden.
Dazu muss innerhalb der gewünschten Aufgabe das Plugin intranda_step_imagename_analyse ausgewählt werden. Des Weiteren muss die Checkbox Automatische Aufgabe gesetzt sein.
Arbeitsweise
Die Arbeitsweise des Plugins innerhalb des korrekt konfigurierten Workflows sieht folgendermaßen aus:
Wenn das Plugin innerhalb des Workflows aufgerufen wurde, öffnet es die METS-Datei und prüft als erstes, ob bereits eine Paginierung existiert.
Wenn dies der Fall ist, wird basierend auf dem konfigurierten Wert in skipWhenDataExists der Schritt entweder ohne weitere Änderungen abgeschlossen, oder die vorhandene Paginierung und Strukturierung aus der METS Datei entfernt.
Anschließend werden die Dateien aus dem master Ordner gelesen und alphanumerisch sortiert.
Für jede Datei wird nun geprüft, ob sie dem konfigurierten regulären Ausdruck entspricht.
Ist dies der Fall, wird eine neue Page erstellt. Die physische Reihenfolge entspricht der Sortierung im Dateisystem, die logische Seitennummer wird aus der ersten Gruppe des regulären Ausdrucks geholt.
Wenn der reguläre Ausdruck nicht zutrifft, wird im Anschluss die Liste der konfigurierten item durchlaufen und geprüft, ob der Dateiname mit dem Ausdruck, gefolgt von einer optionalen Zahl und einer optionalen recto-verso Angabe (r oder v) endet. Wenn dies der Fall ist, wird das konfigurierte Strukturelement erzeugt und die Seite wird diesem Element zugewiesen. Durch die Angabe einer Zählung können neue Stukturelemente des selben Typs definiert werden. Haben zwei oder mehr Dateien keine oder die gleiche Zählung, werden sie dem gleichen Strukturelement zugewiesen.
Wenn weder der reguläre Ausdruck noch die Liste der Strukturelemente auf den Dateinamen zutreffen, wird eine Page mit der logischen Sortierung "uncounted" erzeugt und ein Eintrag in das Vorgangslog geschrieben.
Beispiele
Die folgenden Beispiele basieren auf der oben definierten Konfiguration:
Dateiname
Ausgabe
BxSem-A02_010v.tif
Seite 010v
BxSem-A02_146r.tif
Seite 146r
BxSem-A02_NSr.tif
erste Seite des Strukturelements Postscript
BxSem-A02_NSv.tif
zweite Seite des Strukturelements Postscript
BxSem-B04_Farbkarte_Einband.jpg
nicht konfiguriert, daher keine Zuordnung möglich, wird in als "uncounted" übernommen
BxSem-A22_VS1r.jpg
erstes Endsheet, erste Seite
BxSem-A22_VS1v.jpg
erstes Endsheet, zweite Seite
BxSem-A22_VS2.jpg
zweites Endsheet
BxSem-B08_SV.jpg
einziges Bild der FrontSection

Step Plugins - Previous

Anzeige von Metadaten in einer Aufgabe

Next - Step Plugins

EWIG Langzeitarchivierung

Last modified 1yr ago

Copy link

Contents

Einführung

Voraussetzung

Installation und Konfiguration

Einstellungen in Goobi

Arbeitsweise

Beispiele