CQL zur Abfrage von ZDB-Daten

Zur Abfrage der ZDB-Daten über verschiedene ZDB-Schnittstellen wie SRU und die JSON-API wird die formale Abfragesprache CQL (Contextual Query Language) verwendet.

Indizes

ZDB-Daten sind auf verschiedene Indizes aufgeteilt und können somit dezidiert abgefragt werden. Folgende Indizes stehen zur Auswahl:

  • woe: Alle Begriffe [Default]
  • tit: Titel [Sortierkriterium]
  • tst: Vollständiger Titel
  • iss: ISSN
  • num: Nummer
  • zdbid: ZDB-ID
  • idn: Interner DNB-Idenitfier
  • ver: Verlag
  • koe: Koeperschaft/Organisation
  • isil: ISIL
  • sigel: Sigel der Bibliothek
  • fid: FID-Kennzeichen
  • sgn: Signatur
  • bbi: Bestandsbesitzende Institution
  • koeref: IDN der Koeperschaft
  • vort: Verlagsort
  • successorsof: Nachfolger
  • ejl: Erscheinungsjahr (letztes)
  • eje: Erscheinungsjahr (erstes) [Sortierkriterium]
  • maintitlesof: Beilage zu
  • evl: Erscheinungsverlauf
  • erf: Erscheinungsfrequenz
  • supplementsof: Enthaltene Beilagen
  • paralleleditionsof: Parallelausgaben
  • ssg: Sondersammelgebiet
  • predecessorsof: Vorgaenger
  • kfr: online kostenfrei verfügbar [feste Werte: 1]
  • spr: Sprachencode
  • frm: Medientyp [feste Werte: A, S, E, O, C, kt, nt, tt, mt, vi, wl]
  • dok: Dokumenttyp [feste Werte: Zeitschrift, Serie, Zeitung]
  • cpl: Codes für Paket- und Lizenzverwaltung [feste Werte: ad, al, nk, nl, pt]
  • psg: Produkt-ISIL/-sigel
  • vozref: IDN des Verbreitungsortes
  • voz: Verbreitungsort
  • dcz: DDC-Sachgruppe
  • per: Person
  • perref: IDN der Person
  • ela: Erscheinungsland
  • eid: Exemplar-ID
  • oa: Open Access-Verfügbarkeit [feste Werte: 0, 1]
  • isbn: International Standard Book Identifier
  • url: Uniform Resource Locator

Wird kein Index ausgewählt, dann wird der Default-Index durchsucht.

Relation Qualifier

Suchterme werden in der CQL-Syntax mit Hilfe eines Relation Qualifiers mit dem ausgewählten Index verglichen. Folgende Relation Qualifier stehen zur Verfügung:

  • =
    Reihenfolge der Suchbegriffe muss übereinstimmen
  • <
    Suchbegriff muss kleiner sein als der Indexwert (nur bei numerischen Indizes)
  • <=
    Suchbegriff muss kleiner sein oder gleich dem Indexwert (nur bei numerischen Indizes)
  • >
    Suchbegriff muss größer sein als der Indexwert (nur bei numerischen Indizes)
  • >=
    Suchbegriff muss größer sein oder gleich dem Indexwert (nur bei numerischen Indizes)
  • all
    Reihenfolge der Suchbegriffe muss nicht übereinsteimmen
  • any
    Mindestens ein Suchbegriff muss im Index vorkommen
  • within
    Suchbegriff kann Teil eines Wortes sein

Einfache Anfragen

Eine einfache Anfrage folgt dem Schema:

Index RelationQualifier Suchbegriff

Hinweis: enthält der Suchbegriff Leerzeichen oder einen Schrägstrich, muss er in Hochkommata eingefasst werden, da sonst nach den getrennten Bestandteilen gesucht wird:

Index RelationQualifier "Suchbegriff mit Leerzeichen"

Suchbegriffe Trunkieren

Standardmäßig werden alle Suchbegriffe ohne Rechtstrunkierung gesucht. Will man eine erweitere Suche durchführen, so muss man den Suchbegriff rechts mit einem Stern ("*") trunkieren.

Kombinierte Anfragen

Mehrere Indizes und Suchbegriffe können kombiniert werden. Siehe hierzu die Erläuterungen im ZDB-Katalog.

Sortierung der Ergebnisse

Ergebnisse können anhand der Daten in ausgewählten Indizes sortiert werden (Siehe Hinweis [Sortierkriterium] unter dem Punkt Indizes).

Sortiert werden kann aufsteigend (ascending) und absteigend (desscending). Folgende Syntax muss am Ende der Anfrage eingefügt werden, wenn sortiert werden soll:

sortby Index/sort.ascending

bzw.

sortby Index/sort.desscending

Letzte Änderung: 03.12.2021