Soutron Import
OPAC Plugin für die Datenübernahme von Soutron Datensätzen
Übersicht
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