Dokumentation PICA Import-Plugin

Transkript

1 DOKUMENTATION PICA IMPORT PLUGIN 1 Dokumentation PICA Import-Plugin Technische Dokumentation für das PICA Import-Plugin für die Staatsbibliothek zu Berlin Revision Datum Goobi Änderungen Initaler Entwurf

2 DOKUMENTATION PICA IMPORT PLUGIN 2 Inhaltsverzeichnis 1 Einführung Voraussetzung und Installation Konfiguration Nutzung in Goobi Konventionen Zusätzliche Details... 6

3 DOKUMENTATION PICA IMPORT PLUGIN 3 1 Einführung Das vorliegende Dokument beschreibt eine Entwicklung der intranda GmbH für die Abfrage von und den Import von PPN Listen in Goobi. Der Import findet durch Nutzung der Oberfläche für den Plugin-basierten Massenimport statt und wird im Folgenden erläutert. 2 Voraussetzung und Installation Vorausgesetzt wird der Einsatz der Goobi Version intranda edition. Außerdem muss das neu implementierte Plugin in folgendem Ordner installiert werden: /opt/digiverso/goobi/plugins/import/intrandapicaimport.jar 3 Konfiguration In der zentralen Goobi-Konfigurationsdatei müssen einige Einstellungen sichergestellt sein. Diese Datei ist unter folgendem Pfad zu finden: /var/lib/tomcat6/webapps/goobi/web-inf/classes/goobi_config.properties Um die Importschnittstelle zu aktivieren, muss der Schalter massimportallowed auf true gesetzt werden. Außerdem muss für den Schalter pluginfolder ein Ordner für die Plugins festgelegt werden. massimportallowed=true pluginfolder=/opt/digiverso/goobi/plugins/

4 DOKUMENTATION PICA IMPORT PLUGIN 4 4 Nutzung in Goobi Das Import-Plugin wird über die Maske Massenimport aufgerufen, die mittels der oben angegebenen Konfiguration in den Produktionsvorlagen freigeschaltet wurde. Abbildung 1: Aktivierter Massenimport in der Liste der Produktionsvorlagen Der Massenimport erlaubt grundsätzlich vier unterschiedliche Szenarien: Auflistung von Identifiern, die von einem Katalog abzufragen sind Upload einer Datei Einfügen eines oder mehrerer Records über das Formular Auswahl einer oder mehrerer Dateien aus einem Verzeichnis Das entwickelte Plugin erlaubt die Nutzung des Upload-Mechanismus. Innerhalb dieses Reiters gibt es drei Eingabefelder: 1. Im oberen Feld kann eine oder mehrere Kollektionen hinzugefügt werden, die dem Goobi- Vorgang hinzugefügt werden. Die Liste der Kollektionen ist hierbei dieselbe, wie in der Maske zum Anlegen einzelner Vorgänge. 2. Als zweites kann dasjenige Plugin ausgewählt werden, mit dem der Datenimport durchgeführt werden soll. 3. Im dritten Feld kann eine Excel-Datei ausgewählt und hochgeladen werden. Diese Excel- Datei enthält die Liste der zu importierenden PPNs.

5 DOKUMENTATION PICA IMPORT PLUGIN 5 Abbildung 2: Auswahl einer Datei beim Import-Plugin Nachdem die Excel-Datei hochgeladen wurde, erfolgt durch das Klicken auf Speichern der Import der Daten aus dem Katalog. Die entsprechenden Goobi-Vorgänge werden angelegt. Zu beachten ist hierbei, dass lediglich Datensätze angelegt werden können, zu denen sämtliche relevanten Daten vollständig und automatisch aus dem Katalog bezogen werden können. Für Datensätze, die z.b. Zeitschriftenbände erzeugen sollen, wären manuelle Eingaben durch den Benutzer notwendig (z.b. für die Bandnummer und Jahreszahl sowie für die geänderte PPN), so dass solche Datensätze nicht Gegenstand der Entwicklung waren und daher durch das Import-Plugin nicht erfasst werden. 5 Konventionen Aus den Excel-Daten werden nur diejenigen Inhalte übernommen, auf die folgende Beschreibung zutrifft: Die ersten Zeichen sind Zahlen Das letzte Zeichen ist eine Zahl oder ein X Die Zeichenfolge hat eine Länge von mindestens 7 Zeichen Andere Zeichenfolgen in der Excel-Datei werden ignoriert. Die Import-Datei muss im Binary Interchange File Format (BIFF) als XLS oder in dem auf OpenXML basierenden Format XLSX vorliegen. Andere Formate werden nicht unterstützt.

6 DOKUMENTATION PICA IMPORT PLUGIN 6 6 Zusätzliche Details Für weitere Details stehen die Entwickler von Goobi und der Plugins jederzeit zur Verfügung. Bitte wenden Sie sich an folgende Ansprechpartner: Ansprechpartner: Steffen Hankiewicz Robert Sehr Entwickelnde Firma: intranda GmbH Bertha-von-Suttner Str. 9 D Göttingen goobi@intranda.com