SRU im Überblick
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 (Common / 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 eine HTTP- oder HTTPS-Schnittstelle und das SRU-Protokoll eine Anfragemöglichkeit auf ihre Daten.
Weitere Informationen auch im Dialog mit Bibliotheken Ausgabe 2010,2.
- Standards der SRU-Schnittstelle
- SRU-Funktionen
- Über SRU verfügbare Kataloge der Deutschen Nationalbibliothek
- Formate
- Testzugang / Zugangsvoraussetzungen
- Konditionen und Kosten
- Ansprechpartner / Kontakt
- Praktische Beispiele
- Einschränkung nach Entitäten im Katalog "authorities"
- URL-Kodierung
- Anzahl der gelieferten Datensätze pro Anfrage
- SRU / Z39.50
SRU - häufig gestellte Fragen (FAQ) / Fehlerbehebung
Standards der SRU-Schnittstelle
Protokoll SRU: Version 1.1
Retrievalsprache CQL: Version 1.1, 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 (Common / 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
| Katalogauswahl | Selbstbeschreibung in XML-Standardformat |
|---|---|
| Katalog der Deutschen Nationalbibliothek (DNB) ohne Gemeinsame Normdatei 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:
| MARC21-XML Beispiel | XML-Variante von MARC 21 | http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd |
| MABxml-1 Beispiel | XML-Variante von MAB2 nur für Titeldaten, Auslieferung endet am 30. Juni 2013 | mabxml-1.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 Service | http://www.w3.org/2000/07/rdf.xsd |
Testzugang / Zugangsvoraussetzungen
In einer 4-wöchigen Testphase können Sie 100 Datensätze kostenlos beziehen.
Senden Sie uns dazu bitte eine kurze Nachricht an Schnittstellen-Service mit Ihren Kontaktdaten, ggf. der Angabe einer festen IP-Adresse bzw. IP-Bereich, dem gewünschten Katalog und das Datenformat. Alternativ ist der Zugriff über einen individuellen Zugangscode (access token) möglich. Wir melden uns schnellstmöglich bei Ihnen, um offene Fragen zu klären und alle eventuell zusätzlich erforderlichen Daten zu erfragen.
Nach einem erfolgreichen Testverlauf erhalten Sie auf Wunsch die Vertragsunterlagen für den Bezug kostenpflichtiger Formate.
Konditionen und Kosten
In der Testphase ist die Nutzung von bis zu 100 Datensätzen über die SRU-Schnittstelle kostenfrei.
Danach ist die Nutzung abhängig von der Datenbank und dem gewünschten Datenformat teilweise kostenpflichtig.
Der Bezug von Normdaten ist generell kostenfrei. Ebenfalls kostenfrei ist die Nutzung aller Daten im Format RDFxml und von Titeldaten im Format DNB Casual (oai_dc) (Stand: Oktober 2011) (PDF, 26KB, Datei ist nicht barrierefrei), siehe auch das Geschäftsmodell für die Nutzung von Datendiensten der Deutschen Nationalbibliothek. Alle weiteren Formate sind bei Bezug von Titeldaten des laufenden und vorausgegangenen Jahres kostenpflichtig. Für den Bezug kostenpflichtiger Daten ist der Abschluss eines Vertrages erforderlich.
Um Datensätze beziehen zu können, müssen auf Ihrem Konto ausreichend viele Einheiten aufgebucht sein.
Jeder Datensatz entspricht einer Einheit. Je nach individuellem Nutzungsvolumen kann eine der folgenden Preisstufen gewählt werden:
| Datensätze | EUR | Preisstufe |
|---|---|---|
| bis 100 | 13,00 | Preisstufe 1 |
| bis 500 | 62,00 | Preisstufe 2 |
| bis 1.000 | 119,00 | Preisstufe 3 |
| bis 2.500 | 281,00 | Preisstufe 4 |
| bis 5.000 | 535,00 | Preisstufe 5 |
| bis 10.000 | 1.013,00 | Preisstufe 6 |
| bis 20.000 | 1.913,00 | Preisstufe 7 |
Die kommerzielle Nutzung kostenpflichtiger Titeldaten (außerhalb CC0-Bedingungen) bedarf gesonderter Vereinbarungen.
Ansprechpartner / Kontakt
| Schnittstellen-Service | Montag - Freitag von 9.00 -15.00 Uhr |
| Nicole von der Hude | Tel.: +49-69-1525-1632 |
| Heike Eichenauer | Tel.: +49-69-1525-1074 |
Praktische Beispiele
Syntax einer SRU-Anfrage
| Beispiel | Erklärung |
|---|---|
| http://services.dnb.de/sru https://services.dnb.de/sru | Anfrage an SRU-Server der DNB |
| /dnb | Festlegen des Kataloges (z. B. DNB, GND ...) |
| ?version=1.1 | Angabe der SRU-Version, Standard |
| &operation=searchRetrieve | Befehl an den Server |
| &query= | Anfrage formulieren |
| WOE%3DGoethe | WOE ist die Indexbezeichnung, %3D ist die URL-Kodierung für =, Suchbegriff hier: Goethe |
| &recordSchema=MARC21-xml | gewünschtes Format der SRU-Antwort |
Einschränkung nach Entitäten im Katalog "authorities"
Folgende Einschränkungen sind möglich:
| Entitäten | Bibliografische Gattung |
|---|---|
| Geografikum | Tg* |
| Kongress | Tf* |
| Körperschaft | Tb* |
| Name | Tn* |
| Person | Tp* |
| Sachbegriff | Ts* |
| Werk | Tu* |
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.
| Ä | = | %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:
- Retrievalsprache CQL
- Umfangreiche Katalogauswahl
- Größere Formatauswahl in XML
Letzte Änderung: 31.1.2013
