Navigation und Service

SRU im Überblick

Kurz-URL: http://www.dnb.de/sru

SRU (Search / Retrieve via URL) ist ein standardisiertes Webservice-Protokoll, um Datenbanken im Internet abzufragen. Die Ergebnisse der Suche werden in einem definierten XML-Format zur Verfügung gestellt.
Das SRU-Protokoll ermöglicht die gezielte Suche mittels Suchindizes und Suchbegriffen und die Übernahme der entsprechenden Treffer in die eigene Umgebung. Die Anfragen werden in der Retrievalsprache CQL (Contextual Query Language) formuliert.
Der SRU-Standard wurde von der Library of Congress veröffentlicht und ist eine Weiterentwicklung des Z39.50-Protokolls.
Nach Anmeldung und Autorisierung bietet die Deutsche Nationalbibliothek über das HTTP- oder HTTPS-Protokoll und das SRU-Protokoll eine Anfragemöglichkeit auf ihre Daten.
Weitere Informationen auch im Dialog mit Bibliotheken Ausgabe 2010,2.

SRU - häufig gestellte Fragen (FAQ) / Fehlerbehebung

Standards der SRU-Schnittstelle

Protokoll SRU: Version 1.1
Retrievalsprache CQL Context Set Version 1.2, Conformance-Level 2

SRU-Funktionen

SRU umfasst die Basisfunktionen:

  • Explain: Selbstbeschreibung in XML-Standardformat, enthält Informationen über

    • Datenbank
    • Indizes
    • Datenformate
  • Search / Retrieve: Suchanfrage

    • Retrievalsprache: CQL (Contextual Query Language)
    • Boolesche Operatoren (and, or, not) werden unterstützt
      Aufbau einer Suchanfrage: ... Indexbezeichnung%3DSuchbegriff%20or%20Suchbegriff ...

Über SRU verfügbare Kataloge der Deutschen Nationalbibliothek

Über SRU verfügbare Kataloge der Deutschen Nationalbibliothek
KatalogauswahlSelbstbeschreibung in XML-Standardformat
Katalog der Deutschen Nationalbibliothek (DNB) ohne Gemeinsame Normdatei (GND)
Beispiel SRU-Antwort
http://services.dnb.de/sru/dnb?operation=explain&version=1.1
Katalog des Deutschen Musikarchivs (DMA)
Beispiel SRU-Antwort
http://services.dnb.de/sru/dnb.dma?operation=explain&version=1.1
Authorities: Katalog der Gemeinsamen Normdatei (GND)
Einschränkungen nach Entitäten
Beispiel SRU-Antwort
http://services.dnb.de/sru/authorities?operation=explain&version=1.1

Formate

Folgende Formate werden in der Kodierung UTF-8 decomposed ("zerlegt") angeboten:

Formate und Beipiel
MARC21-xml
Beispiel
XML-Variante von MARC 21http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
DNB Casual (oai_dc)
Beispiel
Auswahl von Dublin-Core-Elementen
nur für Titeldaten
http://www.openarchives.org/OAI/2.0/oai_dc.xsd
RDFxml
Beispiel
Linked Data Servicehttp://www.w3.org/2000/07/rdf.xsd

Zugangsvoraussetzungen

Für einen kostenfreien Zugang zur SRU-Schnittstelle senden Sie bitte eine E-Mail an den mit Ihren Kontaktdaten, dem gewünschten Katalog (Titel- o./u. Normdaten), dem Datenformat und ggf. der Angabe einer festen IP-Adresse bzw. IP-Bereich. Alternativ ist der Zugriff über einen individuellen Zugangscode (access token) möglich. Sie erhalten eine Nachricht von uns, sobald der Zugang für Sie freigeschaltet ist.

Nutzungs- und Bezugsbedingungen

Ab 1. Juli 2015 sind alle Titeldaten der Deutschen Nationalbibliothek und die Normdaten der Gemeinsamen Normdatei (GND) kostenfrei unter "Creative Commons Zero"-Bedingungen (CC0 1.0) zur freien Nachnutzung verfügbar.
Die Metadaten und Online-Schnittstellen werden ohne Gewähr dafür angeboten, dass sie ununterbrochen, pünktlich, fehlerfrei, vollständig sind und dass sie nicht Rechte Dritter (z. B. Persönlichkeits- oder Urheberrechte) verletzen.

Ansprechpartner / Kontakt

Ansprechpartner
Montag - Freitag von 9 - 15 Uhr
Nicole von der HudeTel.: +49-69-1525-1632
Heike Eichenauer Tel.: +49-69-1525-1074

Praktische Beispiele

Syntax einer SRU-Anfrage

Syntax einer SRU-Anfrage mit Beispiel und Erklärung
BeispielErklärung
http://services.dnb.de/sru
https://services.dnb.de/sru
Anfrage an SRU-Server der DNB
/dnbFestlegen des Kataloges (z. B. DNB, GND ...)
?version=1.1Angabe der SRU-Version, Standard
&operation=searchRetrieveBefehl an den Server
&query=Anfrage formulieren
WOE%3DGoetheWOE ist die Indexbezeichnung, %3D ist die URL-Kodierung für =, Suchbegriff hier: Goethe
&recordSchema=MARC21-xmlgewünschtes Format der SRU-Antwort

Einschränkung nach Entitäten im Katalog "authorities"

Folgende Einschränkungen sind möglich:

Einschränkung nach Entitäten
EntitätenBibliografische Gattung
GeografikumTg*
KongressTf*
KörperschaftTb*
NameTn*
PersonTp*
SachbegriffTs*
WerkTu*

Das Sternchen * (Asterisk) steht als Platzhalter für eine beliebige Anzahl von Zeichen und ist unbedingt direkt an den Wert anzufügen.

Beispiele für entsprechende SRU-Anfragen:

Tp* (Person):
http://services.dnb.de/sru/authorities?version=1.1&operation=searchRetrieve&query=WOE%3DRupp%20Elisabeth%20and%20BBG%3DTp*&recordSchema=MARC21-xml

Ts* (Sachbegriff):
http://services.dnb.de/sru/authorities?version=1.1&operation=searchRetrieve&query=WOE%3DMarketing%20and%20BBG%3DTs*&recordSchema=MARC21-xml

Schlagwörter erhalten Sie über die Einschränkung mittels "COD=s":
http://services.dnb.de/sru/authorities?version=1.1&operation=searchRetrieve&query=WOE%3Dsozialistenkongress%20and%20COD%3Ds&recordSchema=MARC21-xml

URL-Kodierung

In der URL-Kodierung werden Umlaute nach UTF-8 und mit vorangestelltem %-Zeichen kodiert (Prozentkodierung).
Beispiel: Kleinbuchstabe ö in UTF-8 = C3 B6 und mit vorangestellten %-Zeichen = %C3%B6.

URL-Kodierung
Ä=%C3%84
Ö=%C3%96
Ü=%C3%9C
ä=%C3%A4
ö=%C3%B6
ü=%C3%BC
ß=%C3%9F
(Leerschritt, Spatium)=%20
" (Anführungszeichen)=%22
/ (Slash)=%2F
\ (Backslash)=%5C
Liste weiterer Zeichen

Zur Verwendung von "=" in einer Anfrage (... query=dc.title=musik ...) empfehlen die Vorgaben die Ersetzung des 2. "=" durch "%3D" (... query=dc.title%3Dmusik ...) und die Ersetzung von Sonderzeichen (z. B. Diakritika durch UTF-8 hexadezimal) im Suchbegriff (siehe Standard).
Leerzeichen z. B. vor und nach booleschen Operatoren sind mit %20 (... KRAFTWERK%20not%20ROBOTER ...) zu ersetzen (abhängig vom Client).

Anzahl der gelieferten Datensätze pro Anfrage

Standard (default): 10 Datensätze pro Antwort
Maximal: 100 Datensätze pro Antwort bei Angabe von ...&maximumRecords=100 (mögliche Werte 1 bis 100)
Abruf weiterer Datensätze: ...&startRecord=101 (mögliche Werte 1 bis unendlich)

SRU / Z39.50

SRU bietet gegenüber Z39.50 folgende Vorteile:

Letzte Änderung: 30.7.2015

Diese Seite

Schriftbanner mit Deutscher Nationalbibliothek Leipzig, Frankfurt am Main