Import von Sisis SunRise Dateien
Dies ist die technische Dokumentation für das Plugin zum Import von Sisis SunRise-Dateien als Vorgänge in Goobi workflow.
Übersicht
Identifier
intranda_import_sisis_sunrise_files
Repository
Lizenz
GPL 2.0 oder neuer
Letzte Änderung
25.07.2024 12:03:00
Einführung
Diese Dokumentation beschreibt die Installation, Konfiguration und Verwendung des Plugins zum Importieren von Sisis SunRise-Dateien.
Installation
Das Plugin muss in folgendem Ordner installiert werden:
Es gibt auch eine Konfigurationsdatei, die sich an folgendem Ort befinden muss:
Zusätzlich gibt es eine tags
-Datei, deren Speicherort in der Konfigurationsdatei angegeben wird:
Überblick und Funktionsweise
Um den Import zu nutzen, muss in den Produktionsvorlagen der Bereich "Massenimport" geöffnet werden und im Reiter "Datei-Upload-Import" das Plugin "intranda_import_sisis_sunrise_file" ausgewählt werden. Anschließend kann eine Sisis SunRise-Datei hochgeladen und importiert werden.
Der Import findet in mehreren Schritten statt. Zunächst wird die gesamte Datei eingelesen, und die Maps child-parent und parent-children werden erstellt und (als JSON-Dateien) im Goobi temp
Ordner für den aktuellen Benutzer gespeichert. Diese Maps werden im nächsten Schritt zur Erstellung von Ankerdateien verwendet.
Die Sisis SunRise-Datei wird dann in einzelne Datensätze zerlegt. Für jeden Datensatz wird aus dem Katalog-Identifier (und einem eventuell in der Konfigurationsdatei angegebenen Präfix) der Prozesstitel generiert und geprüft, ob der Prozess bereits in Goobi existiert. Ist dies nicht der Fall, wird der Prozess angelegt und die konfigurierten Metadaten für Anchor
und Volume
in einem Ordner in dem in der Konfiguration angegebenen Ausgabepfad zwischengespeichert. Eventuelle Bilder werden in einen Unterordner images
kopiert.
Im nächsten Schritt werden alle diese Ordner, die die MetsMods-Dateien und die Bilder enthalten, als Vorgänge in Goobi workflow importiert und in die entsprechenden Ordner in Goobi verschoben.
Konfiguration
Die Konfiguration erfolgt über die Konfigurationsdatei plugin_intranda_import_sisis_sunrise_file.xml
und kann im laufenden Betrieb angepasst werden.
Die Konfiguration erlaubt unterschiedliche Konfigurationen für verschiedene Produktionsvorlagen. Dazu muss im Feld Template
nur der Name des gewünschten Vorlage eingetragen werden. Der Eintrag mit dem Wert *
wird für alle Vorlagen verwendet, für die keine eigene Konfiguration existiert.
rulesetPath
Dies ist der Pfad zum Regelsatz für die MetsMods-Dateien.
imagePathFile
Dieser Parameter definiert den Pfad zu den Bilddateien, die sich entweder im Ordner selbst oder in Unterordnern mit dem Namen der Katalogkennung befinden.
tags
Dieser Parameter definiert die Übersetzungsdatei, die die Codes in Metadaten übersetzt.
withSGML
Wenn dieser Parameter auf true
gesetzt ist, dann werden SGML-Dateien verwendet. Beachten Sie, dass dies derzeit nicht verwendet wird, sondern für eine spätere Version vorgesehen ist.
sgmlPath
Wenn SGML-Dateien verwendet werden, ist dies der Ordner, in dem sie sich befinden.
defaultPublicationType
Mit diesem Parameter wird der Typ des Dokuments definiert, wenn es keine Kinder oder Eltern hat. Ein Dokument mit Kindern wird als MultiVolumeWork importiert, die Kinder werden als Volumes importiert.
collection
Dies gibt die Metadaten singleDigCollection
für die MetsMods-Dateien an, den Namen der Sammlung, zu der die Werke gehören.
listIDs
Hier definieren Sie den Pfad zu einer Textdatei, die eine Liste von Katalogkennungen enthält. Wenn dieses Feld nicht leer ist, dann werden nur Datensätze mit diesen Katalogkennungen aus der Sisis SunRise-Datei importiert.
Tags
Eine Tag-Datei kann etwa so aussehen:
Jede Zeile enthält einen Code, gefolgt von dem Namen der Metadaten, in die er übersetzt werden soll. Jeder Metadatentyp in der Liste muss in dem Regelsatz definiert sein, der für das Projekt verwendet wird, in das die Datei importiert werden soll, und die CatalogIDDigital
muss definiert sein, da sie zur Erstellung der Prozess-ID verwendet wird.
Last updated