Kopieren von Dateien aus Metadatenfeldern
Dies ist eine technische Dokumentation für das Plugin zum automatischen Anreichern des Prozesses mit Bildern basierend auf Metadaten mit den Dateinamen im Vorgang.
Übersicht
Identifier
intranda-step-fetch-images-from-metadata
Repository
Lizenz
GPL 2.0 oder neuer
Letzte Änderung
25.07.2024 11:59:06
Einführung
Die vorliegende Dokumentation beschreibt die Installation, Konfiguration und den Einsatz des Plugins. Mit Hilfe dieses Plugins können Bilder aus einem konfigurierten Ordner oder von bestimmten URLs anhand des im Vorgangs hinterlegten Dateinamens in den gewünschte Ordner des Vorgangs kopiert oder bewegt werden.
Installation
Das Plugin besteht aus zwei Dateien:
Die Datei plugin_intranda_step_fetch_images_from_metadata-base.jar
enthält die Programmlogik und muss für den tomcat
-Nutzer lesbar in folgendes Verzeichnis installiert werden:
Die Konfigurationsdatei plugin_intranda_step_fetch_images_from_metadata.xml
muss ebenfalls für den tomcat
-Nutzer lesbar sein und in folgendes Verzeichnis installiert werden:
Überblick und Funktionsweise
Dieses Plugin wird in den Workflow so integriert, dass es automatisch ausgeführt wird. Eine manuelle Interaktion mit dem Plugin ist nicht notwendig. Zur Verwendung innerhalb eines Arbeitsschrittes des Workflows sollte es wie im nachfolgenden Screenshot konfiguriert werden.
Das Plugin wird üblicherweise vollautomatisch innerhalb des Workflows ausgeführt. Es ermittelt zunächst, ob das in der Konfiguration spezifizierte Metadatum vorhanden ist und wertet dieses anschließend aus. Die in dem Metadatum angegebene Datei wird anschließend anhand ihres Namens und der Dateiendung in den media-Ordner des Vorgangs kopiert oder bewegt. Dabei prüft das Plugin die vorhandenen Bilder im media
-Ordner des Vorgangs, um zu sehen, ob das gewünschte Bild bereits importiert wurde, und wenn nicht:
In den beiden folgenden Fällen wird die Reihenfolge der importierten Bilder aktualisiert und in der Mets-Datei gespeichert:
wenn
useUrl
auftrue
gesetzt ist, wird das Plugin das Bild von der angegebenen URL herunterladenwenn
useUrl
auffalse
oder gar nicht gesetzt ist, wird der Name jeder Datei geprüft, um zu ermitteln, ob an sie als erste Datei des Verzeichnis behandelt werden soll, während die anderen Bilder einfach nach ihren Namen sortiert werden.
Konfiguration
Die Konfiguration des Plugins erfolgt über die Konfigurationsdatei plugin_intranda_step_fetch_images_from_metadata.xml
und kann im laufenden Betrieb angepasst werden. Im folgenden ist eine beispielhafte Konfigurationsdatei aufgeführt:
Die einzelnen Parameter haben die folgende Funktion:
project
Dieser Parameter legt fest, für welches Projekt der aktuelle Block <config>
gelten soll. Verwendet wird hierbei der Name des Projektes. Dieser Parameter kann mehrfach pro <config>
-Block vorkommen.
step
Dieser Parameter steuert, für welche Arbeitsschritte der Block <config>
gelten soll. Verwendet wird hier der Name des Arbeitsschritts. Dieser Parameter kann mehrfach pro <config>
-Block vorkommen.
useUrl
Dieser Parameter bestimmt den Quellort der abzurufenden Bilder. Wenn er auf true
gesetzt ist, werden die Bilder von den registrierten URLs in der mets-Datei geholt, wenn er auf false
oder gar nicht gesetzt ist, werden die Bilder aus dem folgenden konfigurierten Ordner geholt.
filenameMetadata
Hier ist der Name des Metadatenfeldes (üblicherweise aus der METS-Datei) angegeben, das den Dateinamen der zu importierenden Datei enthält.
fileHandling
Das Attribut @mode
definiert, ob die Bilder durch Kopieren oder Verschieben importiert werden sollen. Das Attribut @ignoreFileExtension
steuert, ob die Dateiendung für den Kopiervorgang ignoriert werden soll oder exakt stimmen muss. Das Attribut @folder
gibt den Ordner an, in dem sich die zu importierenden Dateien befinden.
export
Das Attribut @enabled
legt fest, ob der Vorgang exportiert werden soll oder nicht, während das Attribut @exportImages
definiert, ob hierbei die Bilder berücksichtig werden sollen.
Last updated