Die Beschreibung zur SRU/SRW-Schnittstelle für BSZ/SWB finden Sie hier: SRU/SRW
Inhalt:
Search/Retrieve via URL (SRU) ist ein technischer Standard für Bibliotheken, der im Rahmen der Initiative Z39.50 International Next Generation (ZING) entstanden ist, um eine moderne Weiterentwicklung des Z39.50-Protokolls zu schaffen. SRU ist ein auf HTTP basierendes Protokoll um Datenbankabfragen durchzuführen. Suchanfragen können dabei über einen URL in CQL (Contextual Query Language) übermittelt werden. Die zurückgelieferten Ergebnisse können per XML in verschiedenen bibliographischen Formaten ausgeliefert werden.
Weitere Informationen zu SRU finden Sie unter http://de.wikipedia.org/wiki/Search/Retrieve_via_URL und http://www.loc.gov/standards/sru/; Anfrage-Beispiele auf dieser Seite wurden mit dem yaz-client durchgeführt, Informationen dazu finden Sie unter http://www.indexdata.com/yaz/doc/yaz-client.html.
Verwendung
Sie erreichen den Dienst unter sru.k10plus.de - so können Sie beispielsweise den K10plus-Verbundkatalog über SRU abfragen, indem Sie die Adresse http://sru.k10plus.de/opac-de-627 als BaseURL verwenden. Welche Datenbanken, Suchattribute und Anzeigeformate verfügbar sind, erfahren Sie weiter unten.
Beispiel-URL für eine searchRetrieve-Operation; gesucht wird das Stichwort "McCarthyism" im Titelindex des K10plus-Verbundkataloges "opac-de-627", Anzeige von 10 Treffern im Format "mods":
http://sru.k10plus.de/opac-de-627?version=1.1&operation=searchRetrieve&query=pica.tit%3DMcCarthyism&maximumRecords=10&recordSchema=mods
Neu:
Es ist nun auch möglich, HTTPS für Ihre Anfragen zu verwenden, dazu können Sie das Protokoll http:// in den Beispielen einfach durch https:// austauschen. Bitte beachten Sie, dass Browser sich teilweise merken, dass für die Domain HTTPS verwendet wird ("HSTS"). Falls Sie anschließend dennoch einmal wieder zu HTTP zurück wechseln möchten, gibt es meist die Option, den Browser die Seiteneinstellungen für die Domain "vergessen" zu lassen.
Z> open http://sru.k10plus.de/opac-de-627 Connecting...OK. Z> find pica.tit=Nuklearwaffenkonvention Received SRW SearchRetrieve Response Number of hits: 5 Elapsed: 0.091077 Z> s 1 Received SRW SearchRetrieve Response Number of hits: 5 pos=1 schema= <?xml version="1.0" encoding="UTF-8"?> <record xmlns="http://www.loc.gov/MARC21/slim"> <leader> cam a22 4500</leader> <controlfield tag="001">341384666</controlfield> <controlfield tag="003">DE-627</controlfield> <controlfield tag="005">20180725111243.0</controlfield> <controlfield tag="007">tu</controlfield> <controlfield tag="008">040309s2000 xx ||||| 00| ||ger c</controlfield> <datafield tag="015" ind1=" " ind2=" "> <subfield code="a">02,B07,0325</subfield> <subfield code="2">dnb</subfield> </datafield> <datafield tag="016" ind1="7" ind2=" "> <subfield code="a">963553054</subfield> <subfield code="2">DE-101</subfield> </datafield> <datafield tag="020" ind1=" " ind2=" "> <subfield code="a">3000067434</subfield> <subfield code="c">kart.</subfield> <subfield code="9">3-00-006743-4</subfield> </datafield> <datafield tag="035" ind1=" " ind2=" "> <subfield code="a">(DE-627)341384666</subfield> </datafield> <datafield tag="035" ind1=" " ind2=" "> <subfield code="a">(DE-576)11027458X</subfield> </datafield> <datafield tag="035" ind1=" " ind2=" "> <subfield code="a">(DE-599)GBV341384666</subfield> </datafield> <datafield tag="035" ind1=" " ind2=" "> <subfield code="a">(OCoLC)76367678</subfield> </datafield> <datafield tag="035" ind1=" " ind2=" "> <subfield code="a">(DE-615)00577661</subfield> </datafield> <datafield tag="040" ind1=" " ind2=" "> <subfield code="a">DE-627</subfield> <subfield code="b">ger</subfield> <subfield code="c">DE-627</subfield> <subfield code="e">rakwb</subfield> </datafield> <datafield tag="041" ind1=" " ind2=" "> <subfield code="a">ger</subfield> </datafield> <datafield tag="044" ind1=" " ind2=" "> <subfield code="c">XA-DE</subfield> </datafield> <datafield tag="084" ind1=" " ind2=" "> <subfield code="a">19</subfield> <subfield code="a">16</subfield> <subfield code="a">21</subfield> <subfield code="2">sdnb</subfield> </datafield> <datafield tag="084" ind1=" " ind2=" "> <subfield code="a">MK 3600</subfield> <subfield code="2">rvk</subfield> <subfield code="0">(DE-625)rvk/123050:</subfield> </datafield> <datafield tag="084" ind1=" " ind2=" "> <subfield code="a">SC03</subfield> <subfield code="2">FIV</subfield> </datafield> <datafield tag="084" ind1=" " ind2=" "> <subfield code="a">RQ</subfield> <subfield code="2">FIV</subfield> </datafield> <datafield tag="084" ind1=" " ind2=" "> <subfield code="a">89.78</subfield> <subfield code="2">bkl</subfield> </datafield> <datafield tag="245" ind1="1" ind2="0"> <subfield code="a">Sicherheit und Überleben</subfield> <subfield code="b">Argumente für eine Nuklearwaffenkonvention; Modellentwurf eines Übereinkommens über das Verbot der Entwicklung, Erprobung, Herstellung, Lagerung, Weitergabe, des Einsatzes und der Drohung mit einem Einsatz von Atomwaffen sowie über deren Abschaffung; einschließlich Kommentare und Reaktionen</subfield> <subfield code="c">IPPNW, Deutsche Sektion der Internationalen Ärzte für die Verhütung des Atomkriegs. [Federführende Autorinnen: Merav Datan; Alyn Ware. Übers.: Regina Hagen]</subfield> </datafield> <datafield tag="264" ind1=" " ind2="1"> <subfield code="a">Berlin</subfield> <subfield code="b">IPPNW [u.a.]</subfield> <subfield code="c">c 2000</subfield> </datafield> <datafield tag="300" ind1=" " ind2=" "> <subfield code="a">352 S.</subfield> <subfield code="b">Ill.</subfield> <subfield code="c">21 cm</subfield> </datafield> <datafield tag="336" ind1=" " ind2=" "> <subfield code="a">Text</subfield> <subfield code="b">txt</subfield> <subfield code="2">rdacontent</subfield> </datafield> <datafield tag="337" ind1=" " ind2=" "> <subfield code="a">ohne Hilfsmittel zu benutzen</subfield> <subfield code="b">n</subfield> <subfield code="2">rdamedia</subfield> </datafield> <datafield tag="338" ind1=" " ind2=" "> <subfield code="a">Band</subfield> <subfield code="b">nc</subfield> <subfield code="2">rdacarrier</subfield> </datafield> <datafield tag="591" ind1=" " ind2=" "> <subfield code="a">580,720 ddsu/srm ; IMD-Felder und 1131 maschinell ergänzt (SWB)</subfield> </datafield> <datafield tag="650" ind1=" " ind2="4"> <subfield code="a">Global</subfield> <subfield code="x">Abrüstung</subfield> <subfield code="x">Nuklearwaffen</subfield> <subfield code="x">Massenvernichtungswaffen</subfield> <subfield code="x">Verifikation (Rüstungskontrolle)</subfield> <subfield code="x">Sicherheitspolitische Friedenssicherung</subfield> <subfield code="x">Initiativen/Absichtserklärungen zu Rüstungskontrolle</subfield> </datafield> <datafield tag="650" ind1=" " ind2="4"> <subfield code="a">Abschreckung/Abschreckungsstrategie</subfield> <subfield code="x">Ziele und Programme internationalen Akteurs</subfield> <subfield code="x">Durchsetzbarkeit von Entscheidungen/Rechtsnormen internationaler Akteure</subfield> <subfield code="x">International Physicians for the Prevention of Nuclear War</subfield> </datafield> <datafield tag="689" ind1="0" ind2="0"> <subfield code="D">s</subfield> <subfield code="0">(DE-588)4003434-3</subfield> <subfield code="0">(DE-627)106389599</subfield> <subfield code="0">(DE-576)208851577</subfield> <subfield code="a">Kernwaffe</subfield> <subfield code="2">gnd</subfield> </datafield> <datafield tag="689" ind1="0" ind2="1"> <subfield code="D">s</subfield> <subfield code="0">(DE-588)4000197-0</subfield> <subfield code="0">(DE-627)10640184X</subfield> <subfield code="0">(DE-576)208837302</subfield> <subfield code="a">Abrüstung</subfield> <subfield code="2">gnd</subfield> </datafield> <datafield tag="689" ind1="0" ind2=" "> <subfield code="5">(DE-627)</subfield> </datafield> <datafield tag="700" ind1="1" ind2=" "> <subfield code="a">Datan, Merav</subfield> </datafield> <datafield tag="700" ind1="1" ind2=" "> <subfield code="a">Ware, Alyn</subfield> </datafield> <datafield tag="700" ind1="1" ind2=" "> <subfield code="a">Hagen, Regina</subfield> <subfield code="e">Übers.</subfield> </datafield> <datafield tag="710" ind1="2" ind2=" "> <subfield code="a">Internationale Ärzte für die Verhütung des Atomkrieges</subfield> <subfield code="0">(DE-588)2084646-0</subfield> <subfield code="0">(DE-627)100187153</subfield> <subfield code="0">(DE-576)192521705</subfield> </datafield> <datafield tag="924" ind1="0" ind2=" "> <subfield code="a">552265535</subfield> <subfield code="b">DE-Hv14</subfield> <subfield code="9">Hv 14</subfield> <subfield code="c">GBV</subfield> <subfield code="d">c</subfield> <subfield code="g">2002.425</subfield> </datafield> <datafield tag="924" ind1="0" ind2=" "> <subfield code="a">3150302072</subfield> <subfield code="b">DE-14</subfield> <subfield code="9">14</subfield> <subfield code="c">BSZ</subfield> <subfield code="d">c</subfield> </datafield> <datafield tag="924" ind1="0" ind2=" "> <subfield code="a">3150302110</subfield> <subfield code="b">DE-24</subfield> <subfield code="9">24</subfield> <subfield code="c">BSZ</subfield> <subfield code="d">b</subfield> <subfield code="g">D 7921</subfield> </datafield> <datafield tag="924" ind1="0" ind2=" "> <subfield code="a">3150302196</subfield> <subfield code="b">DE-15</subfield> <subfield code="9">15</subfield> <subfield code="c">BSZ</subfield> <subfield code="d">c</subfield> </datafield> <datafield tag="924" ind1="0" ind2=" "> <subfield code="a">3150302250</subfield> <subfield code="b">DE-He79</subfield> <subfield code="9">He 79</subfield> <subfield code="c">BSZ</subfield> <subfield code="d">b</subfield> <subfield code="g">8532 Data</subfield> </datafield> <datafield tag="924" ind1="0" ind2=" "> <subfield code="a">3150302315</subfield> <subfield code="b">DE-Bol1</subfield> <subfield code="9">Bol 1</subfield> <subfield code="c">BSZ</subfield> <subfield code="d">b</subfield> <subfield code="g">I 1036</subfield> </datafield> <datafield tag="924" ind1="0" ind2=" "> <subfield code="a">3150302404</subfield> <subfield code="b">DE-615</subfield> <subfield code="9">615</subfield> <subfield code="c">BSZ</subfield> <subfield code="d">b</subfield> </datafield> <datafield tag="924" ind1="0" ind2=" "> <subfield code="a">3150302412</subfield> <subfield code="b">DE-2421</subfield> <subfield code="9">2421</subfield> <subfield code="c">BSZ</subfield> <subfield code="d">b</subfield> <subfield code="g">BI 01462</subfield> </datafield> <datafield tag="935" ind1=" " ind2=" "> <subfield code="i">Blocktest</subfield> </datafield> <datafield tag="936" ind1="b" ind2="k"> <subfield code="a">89.78</subfield> <subfield code="j">Friedensbewegung</subfield> <subfield code="0">(DE-627)106413724</subfield> </datafield> <datafield tag="951" ind1=" " ind2=" "> <subfield code="a">BO</subfield> </datafield> </record> Elapsed: 0.078286 Z>
Authentifizierung
Die Authentifizierung erfolgt automatisch per IP-Adresse oder mittels Zugangsdaten, die Sie von der Verbundzentrale des GBV oder vom Bibliotheksservice-Zentrum Baden-Württemberg erhalten.
Datenbanken
Eine Liste der abfragbaren Bestände ist unter Datenbanken verfügbar.
Suchattribute
Eine Liste der konfigurierten Suchattribute können Sie dem SRU-Explain-Record der Datenbank entnehmen, unter Datenbanken ist der jeweilige SRU-BaseURL verlinkt.
Formate
Format | Name | Typ | Beschreibung |
---|---|---|---|
dc | Dublin Core | application/xml | Dublin Core |
marcxml | MARC-XML | application/xml | MARC-Daten in XML |
mods | MODS | application/xml | Metadata Object Description Schema |
picaxml | Pica+ XML | application/xml | PICA+ in XML |
turbomarc | Turbomarc | application/xml | Turbomarc, faster XML for MARC records |
Zeichensätze
Suchanfragen und Darstellung erfolgen im Zeichensatz UTF-8.
Sortierung
Als Sortierung der Treffer werden "relevance", "year", "author" und "title" unterstützt, der Standardwert ist "year" (absteigend sortiert). Wird auf die Angabe der Sortierreihenfolge verzichtet, dann ist sie ansonsten immer aufsteigend. Die Sortierung kann entweder über URL-Parameter (v1.1) oder über CQL (v1.2) festgelegt werden.
Beispiel für SRU v1.1
Die Sortierreihenfolge mittels des dritten Wertes für sortKeys bestimmt werden: 1 = aufsteigend (Standardwert), 0 = absteigend:
http://sru.k10plus.de/gvk?version=1.1&operation=searchRetrieve&query=pica.all%3Dreformation&maximumRecords=5&sortKeys=year,,1
Beispiel für SRU v1.2
http://sru.k10plus.de/gvk?version=1.2&operation=searchRetrieve&query=pica.all%3Dreformation+sortby+year%2Fdescending&maximumRecords=5
Suche nach zugehörigen Publikationen (Bandsuche)
Die Suche nach verknüpften Titeln funktioniert über eine Kombination der Suchattribute 1001, 1045 und 1049 mittels booleschem Operator "AND".
Suchattribut | Bezeichnung |
---|---|
1001 | Record type |
1045 | Record-linking |
1049 | Control-number-linking |
Mögliche Werte für das Attribut 1001 sind:
Wert für 1001 | Bezeichnung |
---|---|
b | Titeldatensätze |
n | Normdatensätze |
Mögliche Werte für das Attribut 1045 sind:
Wert für 1045 | Bezeichnung | Entsprechung in PSI/CBS |
---|---|---|
fam | Finde gesamte Familie | /FAM?PPN=<ppn> |
rel-bt | Finde verknüpfte Eltern-Datensätze | /REL?PPN=<ppn>&RELTYPE=BT |
rel-nt | Finde verknüpfte Kinder-Datensätze | /REL?PPN=<ppn>&RELTYPE=NT |
rel-rt | Finde nicht-hierarchisch verknüpfte Datensätze | /REL?PPN=<ppn>&RELTYPE=RT |
rel-tt | Finde verknüpfte Datensätze für einen Thesaurus-Eintrag | /REL?PPN=<ppn>&RELTYPE=TT |
Z> open http://sru.k10plus.de/opac-de-627 Connecting...OK. Z> f pica.1001="b" and pica.1045="fam" and pica.1049="267838395" Received SRW SearchRetrieve Response Number of hits: 4 Elapsed: 0.050591 Z>
Beispiel für eine REL-NT-Suche:
http://sru.k10plus.de/opac-de-627?version=1.1&operation=searchRetrieve&query=pica.1049%3D267838395+and+pica.1045%3Drel-nt+and+pica.1001%3Db&maximumRecords=5&recordSchema=picaxml
Filter
Beispiel für die Einschränkung der Suchergebnisse im Gemeinsamen Verbundkatalog "gvk" auf Titeldatensätze (Standardeinstellung) :
http://sru.k10plus.de/gvk!rec=1?version=1.1&operation=searchRetrieve&query=pica.all%3Dhamburg&maximumRecords=10&recordSchema=marcxml
Beispiel für die Einschränkung der Suchergebnisse in der Datenbank "vd17" auf Normdatensätze:
http://sru.k10plus.de/vd17!rec=2?version=1.1&operation=searchRetrieve&query=pica.all%3Dhamburg&maximumRecords=10&recordSchema=marcxml
Beispiel für die Anzeige von Titel- und Normdatensätzen aus dem Katalogisierungsbestand "k10plus":
http://sru.k10plus.de/k10plus!rec=*?version=1.1&operation=searchRetrieve&query=pica.all%3Dhamburg&maximumRecords=10&recordSchema=marcxml
Beispiel zur Beschränkung der Datensatz-Anzeige in "gvk" auf die Titelebene (Ausblenden von Lokal- und Exemplardaten):
http://sru.k10plus.de/gvk!levels=0?version=1.1&operation=searchRetrieve&query=pica.all%3Dschifffahrt&maximumRecords=10&recordSchema=marcxml