Voraussetzungen für die Integration von Datenbanken in die Suchmaschine der Digitalen Bibliothek via HTTP

Transkript

1 Voraussetzungen für die Integration von Datenbanken in die Suchmaschine der Digitalen Bibliothek via HTTP Inhaltsverzeichnis 1 Suche Kurztitelliste Formatbeschreibung Beispiel Unterstützte Felder Langanzeige Unterstützte Felder Fehlermeldungen Allgemeines Suche Die Suchmaske der Digibib verfügt derzeit über 9 Eingabefelder, die mit den Operatoren UND, ODER, UND NICHT verknüpft werden können: Titel Autor Körperschaft Schlagwort Verlag ISSN ISBN Erscheinungsjahr Zusätzlich wäre folgende Suchoptionen hilfreich: Suche nach Datensatz-ID mit dem betreffenden Datensatz als Ergebnis sowie - wenn derartige Strukturen in der Datenbank vorhanden sind - Suche nach Datensatz-ID mit allen diesem Datensatz untergeordneten Datensätzen als Ergebnis (also z.b. Suche nach ID einer Serie und als Ergebnis alle Stücktitel der Serie). Übergeben werden pro Feld entweder eine Phrase oder ein oder mehrere Stichworte. Die Zieldatenbank sollte beides unterstützen. Die DigiBib unterstützt außerdem eine Rechtstrunkierung (gesondert je Stichwort bzw. einmalig für die Phrase). Falls die Datenbank erweiterte Funktionalitäten anbietet, die eine Obermenge der genannten Optionen darstellen (z.b. Suche nach Bereichen von Erscheinungsjahren), stellt dies i.d.r. kein Problem dar. Nach Abschicken einer Suchanfrage über die Digibib werden die Werte dieser Felder ausgelesen und in die Suchsyntax der jeweiligen Zieldatenbank übersetzt, z.b.: &STI_KOR=AND&...&start=1&num=10&page=1&Format=digibib 1 / 5

2 Dazu werden folgende Informationen benötigt: Über welche URL wird die Datenbank angesprochen? z.b.: Welche Felder sind in der Datenbank suchbar und wie werden sie benannt? z.b.: Autor (PER), Titel (STI), Körperschaft (KOR) etc. Welche Verknüpfungsoperatoren existieren und welche Werte können diese annehmen? z.b.: Autor-Titel (PER_STI) etc. ; mögliche Werte: AND, OR, NOT Welche Parameter legen den Bereich der anzuzeigenden Treffer fest? z.b.: &start=11&numbers=10 für die Treffer 11 bis 20 Welches Zeichen wird für die (Rechts-) Trunkierung verwendet? z.b.: * oder? 2 Kurztitelliste Nach Abfrage der Zieldatenbank wird die an die Digibib zurückgelieferte Kurztitelliste ausgelesen und in die Trefferanzeige der Digibib eingepasst. Das Ausgabeformat der Datenbank ist dabei weitgehend beliebig. Wenn die Datenbank die Möglichkeit bietet, verschiedene Ausgabeformate zu definieren, sollte das nachstehend vorgestellte Format umgesetzt werden. Andernfalls sollte es sich um ein möglichst fein granulares und maschinenlesbares (d.h. strukturiertes) Format handeln (z.b. MAB, UNIMARC, MAB-XML oder ein eigenes dokumentiertes Format). 2.1 Formatbeschreibung Die Grundstruktur ist wie folgt definiert: <LI> DB=[DigiBib Datenbank-ID] <LI> HITS=[HITCOUNT] [ [<LI> [FELDCODE]=[FELDINHALT]]+ ]+ 2 / 5

3 2.2 Beispiel <LI> HITS=1456 <LI> QUERY= <LI> AU=Yngvesson, Jenny <LI> TI=Cannibalism in laying hens <LI> YR=1997 <LI> URL=anfrage-id=213cv322&format=digibib-lang&hit=1 <LI> LO=98: 988/464 <LI> AU=Covington, Edward C. [Hrsg.] <LI> TI=Review Course in Pain <LI> YR=1996 <LI> URL=anfrage-id=213cv322&format=digibib-lang&hit=2 <LI> LO=38M: Zs A 4580 <LI> LNK1= 2.3 Unterstützte Felder Folgende Felder werden von der DigiBib unterstützt: Feld-ID Kurzbeschr. Beschreibung AU Autor der 1. Autor in Ansetzungsform TI Titel [Hauptsachtitel] : [Zusatz zum Sachtitel] BD Band-Titel Band-Titel / Band-Zählung CO Körperschaft die 1. Körperschaft in Ansetzungsform YR Erscheinungsjahr Erscheinungsjahr LO Besitznachweise Signaturen, Zweigstellen etc. LNK1 Volltext-Link URL zum Aufruf des Volltextes (z.b. zur PDF-Version der Dipl.-Arb.) LNK2 LNK3 ID Versch. ID-Angaben Verschiedene IDs zu diesem Titel; zum einen die ID innerhalb der jeweiligen Datenbank (möglichst in der Form <DB-ID>:<Datensatz-ID>, z.b. also UBDO: ); zusätzlich sind definiert: HBZ-ID ( HBZ:[BHT]T[0-9]+ ) und ZDB-ID ( ZDB:[0-9]+ ); alle IDs sind nicht wiederholbar; wenn mehrere vorkommen, werden sie durch getrennt Kann eines der Felder nicht gefüllt werden, sollte es nicht ausgegeben werden. Die Felder DB und URL sind gesondert zu betrachten. DB enthält die Kennung der Datenbank, wie sie von der DigiBib intern vergeben wird. Der Wert ist also mit dem HBZ zu vereinbaren. URL enthält die zum Aufruf der Langanzeige des jeweiligen Treffers notwendigen Daten (z.b. eine Anfrage- ID, die Nummer des Treffers innerhalb der Ergebnismenge der Anfrage und eine Formatangabe). 3 / 5

4 3 Langanzeige Das Format der Langanzeige ist prinzipiell unabhängig vom Format der Kurzanzeige, sollte in seiner Struktur aber natürlich möglichst ähnlich sein. Auch hier besteht die Möglichkeit, entweder ein eigenes Datenformat oder das für die DigiBib vorgegebene Format zu liefern. Letzteres entspricht dem Kurzanzeigen-Format mit den Unterschieden, dass a) der META -Block entfallen kann und b) weitere Felder unterstützt werden. 3.1 Unterstützte Felder Feld-ID Kurzbeschr. Beschreibung AU Autor alle Autoren in Ansetzungsform; Einträge durch ; getrennt ; 1. Autor zuerst, Rest prinzipiell in beliebiger- RE Responsibility Reihenfolge Autorenvermerk in Vorlageform: bearb. und erg. von T. Test TI Titel [Hauptsachtitel] : [Zusatz zum Sachtitel] GT Gesamttitel GTID Gesamttitel-ID HBZ-ID des Gesamttitels BD Band-Titel Band-Titel / Band-Zählung EST Einheitssachtitel Einheitssachtitel CO Körperschaft alle Körperschaften in Ansetzungsform; Einträge durch ; getrennt ; 1. Körperschaft zuerst, Rest prinzipiell AB Abstract in beliebiger Reihenfolge Abstract (Original-Felder in <li>...</li> eingepackt; ohne umgebendes <ol> oder <ul> AG Ausgabe Ausgabe-Vermerk PB Publisher [Verlagsort(e)] : [Verlag] UM Umfang Umfang, Begleitmaterialien, Illustrationsvermerke, Karten etc. SE Serie Angaben zur Serie; derzeit nur das erste auftretende Feld; Formatierung wäre noch abzustimmen SEID Serien-ID HBZ-ID der Serie ZT Zeitschrift Titel der Zeitschrift, in der das vorliegende Werk erschienen ist CT Zitatangabe kumulierte Zitatangabe CTY CT-Year CT / Jahr CTV CT-Volume CT / Jahrgang CTI CT-Issue CT / Ausgabe bzw. Heft CTP CT-Pages CT / Seitenzählung SO Source Quellenangabe: Selbständiges Werk (nicht Zeitschrift) zu vorliegendem unselbständigem Werk SOID Source-ID HBZ-ID der Source IB ISBN ISBN (weitere ISBN und Preisangaben ggf. durch ; getrennt angehängt) IS ISSN ISSN (weitere ISSN und Preisangaben ggf. durch ; getrennt angehängt) KY Schlagwörter Kettenglieder durch / getrennt; Ketten bleiben erhalten und werden jeweils in <li> und </li> eingefaßt; FN Fußnote(n) kein umgebendes <ul> oder <ol>; SWD-Nummern etc. werden entfernt Eigentlich die Fußnoten ; in der DigiBib auch Asylstelle für alle interessanten Informationen, die nicht in YR Erscheinungsjahr eigene Felder kommen; einzelne Einträge in <li> und </li> ; kein umgebendes <ul> oder <ol> Erscheinungsjahr LO Besitznachweise Formatierung wäre noch Abzustimmen LO_MAB LNK1 Volltext-Link Besitznachweise im MAB-Format zum späteren Parsing durch Fernleih-Skripte; ggf. anzupassen? URL zum Aufruf des Volltextes (Dipl.-Arb. als PDF...) LNK2 LNK3 BDV Bände vorhanden? Indikator (Wert true ); gibt an, ob es sich bei dem Datensatz um eine Überordnung handelt TYP Typ Für Fernleihe ID Versch. ID-Angaben Verschiedene IDs zu diesem Titel; zum einen die ID innerhalb der jeweiligen Datenbank (möglichst in der Form <DB-ID>:<Datensatz-ID>, z.b. also UBDO: ); zusätzlich sind definiert: HBZ-ID ( HBZ: [BHT]T[0-9]+ ) und ZDB-ID ( ZDB:[0-9]+ ); alle IDs sind nicht wiederholbar; wenn mehrere vorkommen, werden sie durch getrennt 4 / 5

5 4 Fehlermeldungen Wie Kurz- und Langanzeige können Fehlermeldungen beliebig (aber in sich einheitlich) formatiert oder in einem DigiBib-Format ausgegeben werden. Das DigiBib-Format ist wie folgt definiert: <LI> DB=[Datenbank-ID] <LI> ERROR=[ERRORCODE] <LI> ERRORTEXT=[beliebiger Text] Die Errorcodes sind mit dem HBZ abzustimmen. Der ERRORTEXT gelangt nicht zur Ausgabe an den Nutzer, sondern dient nur zu Logging-Zwecken. 5 Allgemeines Die Ausgabe erfolgt in einem bestimmten Character Set. Welches Charset gewählt wird, ist prinzipiell beliebig, muß aber mit dem HBZ abgestimmt bzw. dem HBZ zumindest mitgeteilt werden. Wenn möglich, wird UTF- 8 bevorzugt. Auf eine Verschlüsselung von Sonderzeichen über HTML-Entitäten (z.b. ä ist zu verzichten). Sollen weitere Daten ausgegeben werden, die nicht einem bestehenden Feld zuzuordnen sind, können mit dem HBZ zusätzliche Felder vereinbart werden (die DigiBib ist hier beliebig anpassbar). Der Inhalt eines Feldes sollte (muß allerdings nicht) in einer Zeile stehen. Die Ausgabe von HTML-Tags ist möglich; auf diese Weise können z.b. Links in die Oberfläche der DigiBib transportiert werden. 5 / 5