Soutron Import
OPAC Plugin für die Datenübernahme von Soutron Datensätzen
Übersicht
Identifier
intranda_opac_soutron
Lizenz
GPL 2.0 oder neuer
Letzte Änderung
25.07.2024 12:01:54
Einführung
Die vorliegende Dokumentation beschreibt die Installation, Konfiguration und den Einsatz des Plugins. Mit Hilfe dieses Plugins können Daten aus einem Soutron-System abgefragt und in Goobi übernommen werden. Hierfür muss der Zugriff auf den Soutron-Katalog gewährleistet sein.
Installation
Das Plugin besteht aus zwei Dateien:
Die Datei plugin_intranda_opac_soutron-base.jar
enthält die Programmlogik und muss für den Nutzer tomcat
lesbar an folgendem Pfad installiert werden:
Die Datei plugin_intranda_opac_soutron.xml
muss ebenfalls für den Nutzer tomcat
lesbar sein und unter folgendem Pfad liegen:
Überblick und Funktionsweise
Wenn in Goobi nach einem Identifier gesucht wird, wird im Hintergrund eine Anfrage an die konfigurierte URL gestellt:
Sofern hier ein gültiger Datensatz gefunden wird, wird der Datensatz nach dem Feld /soutron/catalogs_view/ct/cat/rt/@name
durchsucht. Der Wert wird mit der konfigurierten <docstructs>
Liste verglichen. Wenn es eine Entsprechung gibt, wird das gewünschte Strukturelement erzeugt.
Im Anschluß werden die konfigurierten XPath-Ausdrücke ausgewertet, die für <metadata>
und <person>
konfiguriert wurden.
Die Ausdrücke gelten für das Element /soutron/catalogs_view/ct/
. Sofern mit einem Ausdruck Daten gefunden werden, wird das entsprechend angegebene Metadatum erzeugt. Bei Personen wird geprüft, ob der Wert ein Komma enthält. In dem Fall werden Vor- und Nachname am Komma getrennt, ansonsten wird der Wert als Nachname interpretiert.
Konfiguration
Die Konfiguration des Plugins erfolgt in den folgenden Dateien, die sich im Verzeichnis /opt/digiverso/goobi/config/
befinden.
In der Datei goobi_opac.xml
muss die Schnittstelle zum gewünschten Katalogsystem bekannt gemacht werden. Dies geschieht durch einen Eintrag, der wie folgt aussieht:
Das Attribut title
enthält den Namen, unter dem der Katalog in der Nutzeroberfläche ausgewählt werden kann, address
die URL zum GetCatalogue-Endpoint und opacType
das zu nutzende Plugin. In diesem Fall muss der Eintrag plugin_intranda_opac_soutron
lauten.
Es ist nur eine Suche nach einem Identifier möglich, daher können die anderen Suchoptionen ausgeblendet werden. Dies geschieht innerhalb des <searchFields>
Blocks.
Das Mapping der Inhalte des Soutron Datensatzes zu den Metadaten in Goobi geschieht in der Datei plugin_intranda_opac_soutron.xml
:
Im Bereich <docstructs>
wird das Mapping der einzelnen Dokumententypen festgelegt. Für jeden Wert, der in soutron vorkommen kann, muss ein <docstruct>
existieren. Im Attribut soutron
wird der Name eingetragen, der im soutron record enthalten ist, in ruleset
steht das entsprechende Strukturelement aus dem Regelsatz.
Anschließend wird das Mapping für Personen und Metadaten in <metadata>
und <person>
konfiguriert. Hier gibt es jeweils eine Liste von <element>
mit den beiden Attributen xpath
und metadata
. In xpath
wird ein XPath-Ausdruck konfiguriert, der beschreibt, in welchem Teil des XML-Dokuments der Inhalt erwartet wird, in metadata
wird der Name des Metadatums definiert, in das der Inhalt anschließend geschrieben werden soll.
Last updated