Adlib-Bestandsdatenbanken

Aus DIF Filmographie Wiki
Version vom 26. September 2018, 19:02 Uhr von Mfreiberg (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

Auf dieser Wiki-Seite sollen in Zukunft Informationen zu den Bestandsdatenbanken gesammelt werden, die mit der Sammlungsverwaltungssoftware Adlib von Axiell ALM gepflegt werden. Momentan wird Adlib nur im Filmarchiv des DIF eingesetzt.

Dokumentation

XML-Export der Daten

Die den XML-Export definierende Konfigurationsdatei adlibweb.xml liegt im DIF unter C:\inetpub\wwwopacx auf dem Adlib-Server. In ihr wird der Pfad zu Adlib hinterlegt (<globalConfiguration>) und außerdem definiert, welche Datenbank angesprochen werden soll (<databaseConfiguration database="collect.inf">). Nach diesen allgemeinen Angaben werden die Struktur des Exports und die auszugebenden Felder definiert. Eine Dokumentation der adlibweb.xml ist auf http://api.adlibsoft.com/site/documentation/the-adlibweb-xml-file zugänglich.

Damit die Änderung durch das System erkannt wird muss der IIS (Internet Information Server) beendet und neu gestartet werden. Dies erfolgt über den Server-Manager->IIS -> Rechtsklick auf DIFADLIBSRV -> Internetinformationsdienste (IIS)-Manager -> Rechtsklick auf DIFADLIBSRV -> beenden und dann starten.

Der XML-Export kann über den Webserver von Adlib (wwwopacx) abgerufen werden. Die das XML ausgebende URL lautet http://192.168.42.173/wwwopacx/wwwopac.ashx ergänzt um die Parameter database (abzufragende Datenbank) und search (die Abfrage selbst). Eine Beispiel für eine Abfrage ist der XML-Export für den Bestandskatalog.

XML-Export für den Bestandskatalog

Die URL lautet

http://192.168.42.173/wwwopacx/wwwopac.ashx?database=bkkv&search=copy_status=*+and+part_of_reference-%3Epart_of_reference-%3Eexternal_identifier_domain=filmportal&limit=0

Sie sollte nicht in einem Browser, sondern mit einem Tool zum Herunterladen von Dateien aus dem Netz (z.B. wget) angesprochen werden. Als Bordmittel unter Windows ist auch die Windows Power Shell geeignet. Folgender Befehl ist dazu aufzurufen:

(ab Powershell 3.0)

Invoke-WebRequest -Uri "http://192.168.42.173/wwwopacx/wwwopac.ashx?database=bkkv&search=copy_status=*+and+part_of_reference-%3Epart_of_reference-%3Eexternal_identifier_domain=filmportal&limit=0" -OutFile "<Pfad zur Ausgabedatei>" -TimeoutSec 1000

Der Parameter Uri legt die abzurufende Adresse fest und OutFile definiert den Pfad, in dem die Export-Datei abgelegt wird (bspw. C:\adlib_dif\Exporte\DIF-adlib-export.xml). Wichtig ist auch der Parameter TimeoutSec, der bei einer ungefähren Dauer des Abrufs von 10 Minuten mindestens bei 600 (Sekunden) liegen sollte.

Kommandos/Parameter des Adlib WWW-Servers

Siehe auch Datei wwwopac commands.txt im Wurzelverzeichnis (wwwopacx) des Servers.

search = adlib search statement
database = database name (default is the database that has the default attribute set in adlibweb.xml)
startfrom = offset in the result set, the default is 1
limit = number of records to be returned, the default is 10 (cannot exceed the maxlimit settings in adlibweb.xml)
xmltype = raw|unstructured|structured|grouped determines the xml type that will be output
fields = comma separated list of fields
output = json|xml
callback = callback function name
highlight = true|false|highlight tag


scan = field that you want to perform the scan on
database = database name
scanval = value to begin the scan with
startfrom = offset in the result set, the default is 1
limit = number of records to be returned, the default is 10 (cannot exceed the maxlimit settings in adlibweb.xml)
output json|xml
callback = callback function name
language = iso language to return keys from

command = listpointerfiles
database = database name
startfrom = offset in the result set, the default is 1
limit = number of records to be returned, the default is 10 (cannot exceed the maxlimit settings in adlibweb.xml)
output json|xml
callback = callback function name
fields = comma separated list of fields
users = comma separated list of users

command = getpointerfile