Automatisches Setzen des Repräsentanten
Dies ist eine technische Dokumentation für das Plugin zum automatischen Setzen des Repräsentanten für die Deutsche Zentralbibliothek für Wirtschaftswissenschaften Kiel.
Übersicht
Identifier
RepresentativeCreation
Repository
Lizenz
GPL 2.0 oder neuer
Letzte Änderung
15.08.2024 10:58:54
Einführung
Die vorliegende Dokumentation beschreibt die Installation, Konfiguration und den Einsatz eines Plugins zum Setzen des Repräsentanten innerhalb von METS-Dateien in Goobi.
Mit Hilfe dieses Plugins können METS Dateien automatisch aufbereitet und der Repräsentant eines Werkes gesetzt werden.
Voraussetzung
Voraussetzung für die Verwendung des Plugins ist der Einsatz von Goobi mindestens in der Version 2.2, 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:
Die Datei plugin-intranda-step-representative-creator-base.jar enthält die Programmlogik und muss für den tomcat-Nutzer lesbar in folgendes Verzeichnis installiert werden:
Die Datei plugin_RepresentativeCreationPlugin.xml muss ebenfalls für den tomcat-Nutzer lesbar sein und in folgendes Verzeichnis installiert werden:
Folgende Datei dient zur Konfiguration des Plugins und muss wie folgt aufgebaut sein:
Im Element <RepresentativeStructureElement> kann das Strukturelement definiert werden, dessen erste Seite als Repräsentant genutzt werden soll. Es handelt sich hierbei um den im Regelsatz definierten internen Namen des <DocStrctType> Elements.
Der Text aus <ErrorMessage> wird in das Vorgangslog des Prozesses geschrieben, falls in der METS-Datei kein Strukturelement mit diesem Namen gefunden wurde. Falls das Element fehlt oder leer ist, wird kein Eintrag vorgenommen.
Mit <StepName> kann definiert werden, zu welchem Schritt der Vorgang zurückgedreht werden soll, falls das definierte Strukturelement fehlt. Falls das Element fehlt oder leer ist, kann die Funktionalität zur Fehlerbehandlung deaktiviert werden. Dann findet keine Korrektur innerhalb des Prozesses statt und das erste Bild des Vorgangs wird im Goobi viewer als Repräsentant genutzt. Falls ein Schritt definiert wurde, der im Vorgang nicht existiert, bleibt das Plugin im aktuellen Vorgang stehen.
Überblick und Funktionsweise
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 RepresentativeCreation eingetragen werden. Des Weiteren muss die Checkbox Automatische Aufgabe gesetzt sein.
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 ein Repräsentant definiert wurde.
Wenn dies der Fall ist, wird der Schritt abgeschlossen.
Ist dies hingegen nicht der Fall, wird nach dem ersten Strukturelement gesucht, das dem konfigurierten Namen entspricht.
Von diesem Element wird das erste zugeordnete Bild als Repräsentant gesetzt.
Sollte kein Strukturelement mit diesem Namen gefunden werden oder der Datensatz enthält keine Stukturelemente, kann eine Fehlermeldung in das Vorgangslog geschrieben und der Workflow auf einen vorherigen Arbeitsschritt zurückgesetzt werden.
Dies ist jedoch nur dann möglich, wenn ein Text für die Fehlermeldung und der Name des Schrittes konfiguriert wurden.
Last updated
