Navigation und Service

Was ist die Online-Normschnittstelle?

Die Online-Normschnittstelle ermöglicht über den Standard „SRU (Search/Retrieve via URL) Record Update“ das Erfassen, Ändern und Löschen (vgl. CRUD von Normdaten in der Gemeinsamen Normdatei (GND). SRU Record Update ist ein auf dem Protokoll SOAP (Simple Object Access Protocol) basierender Web-Service, der über das Internetprotokoll HTTPS übertragen wird. Die Online-Normschnittstelle wird zumeist direkt im Datenbankverwaltungssystem von Bibliotheken, Museen und Archiven umgesetzt.

SRU Record Update – Standard und Funktionen

Die Online-Normschnittstelle arbeitet mit dem SRURecord-Update-Protokoll in der Version 1.0 basierend auf dem SRU-Standard der Library of Congress.

Funktionen von SRU Record Update

Ein mittels SRU-Record-Update-Protokoll an die Online-Normschnittstelle geschickter GND-Datensatz in einer XML-Struktur des Formats MARC 21 kann

  • erstmals in der Datenbank gespeichert werden (Create Action) oder
  • einen vorhandenen Datensatz aktualisieren (Replace Action).

Anfrage (Request) und Antwort (Response) in SRU-Record-Update basieren auf den Protokollen SOAP und HTTPS.

  • Create Action: Neuerfassung eines Datensatzes
  • Replace Action: Änderung eines vorhandenen Datensatzes
    Es muss zwingend ein vollständiger Datensatz geschickt werden, da der gelieferte Datensatz den vorhandenen Datensatz in der Datenbank komplett überschreibt.
  • Delete Action: nicht zugelassen. Löschungen, Umlenkungen und Aufspaltungen sind nur als „Replace Action“ möglich. Mehr dazu erfahren Sie in den GND-Redaktionsrichtlinien.
    Die Kennzeichnung erfolgt im Datensatz selbst und nicht auf Ebene des SRU-Protokolls. Dafür müssen die Kennzeichnungen, die im GND-Änderungsverfahren festgelegt wurden, beachtet werden (s. Details zum GND-Änderungsdienst).
  • Inkrementelle Änderungen (partielle Updates) werden derzeit nicht unterstützt.

Format der Online-Normschnittstelle

Die Online-Normschnittstelle nutzt das Austauschformat MARC 21 in der xml-Variante (MARC21-xml), Kodierung UTF-8 decomposed („zerlegt“).

Änderungen im UTF-8-Zeichensatz 33kB, PDF - Datei ist nicht barrierefrei

Zugangsvoraussetzungen

Voraussetzung ist die Bereitschaft zur kooperativen Mitarbeit als GND-Partner im Rahmen der GND-Redaktionsrichtlinien und ein International Standard Identifier for Libraries and Related Organizations (ISIL) oder MARC Organization Code zur eindeutigen Identifikation. Diese Identifikatoren des Urhebers (gegebenenfalls der Verbundredaktion) müssen zwingend in den Unterfeldern des MARC-21-Feldes 040 angegeben werden. Auf Nachfrage erhalten GND-Kooperationspartner eine individuelle Zugangskennung (authentificationToken) zur Nutzung der Schnittstelle.

Nutzungs- und Bezugsbedingungen

Alle Titeldaten der Deutschen Nationalbibliothek, der Zeitschriftendatenbank (ZDB), die Adressdaten des ISIL- und Sigelverzeichnisses und die Normdaten der Gemeinsamen Normdatei (GND) sind kostenfrei unter „Creative Commons Zero“-Bedingungen (CC0 1.0) zur freien Nutzung verfügbar.

Die Bestandsdaten der Zeitschriftendatenbank ZDB sind zum größten Teil ebenfalls frei nutzbar. Eine entsprechende Kennzeichnung erfolgt im Bestandsdatensatz, siehe auch Datenlizenzierung in der ZDB.
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 (zum Beispiel Persönlichkeits- oder Urheberrechte) verletzen.

Kontakt

schnittstellen-service@dnb.de

Häufig gestellte Fragen (FAQ)

Wie unterscheiden sich SRU und SRU Record Update?

SRU-Record-Update ermöglicht das Erfassen, Ändern und Löschen von Datensätzen in der GND, bietet also einen schreibenden Zugriff. Im Gegensatz dazu erlaubt die SRU-Schnittstelle nur einen lesenden Zugriff.

Wie kann ich die Schnittstelle SRU Record Update testen?

Nach Erhalt einer Zugangskennung können Tests im Testsystem z. B. mittels YAZ-Client, Advanced REST Client, Postman oder im Webbrowser Firefox mit einer Erweiterung (Add-on) z. B. Resting oder RESTer durchgeführt werden.

Wo muss die Angabe der Zugangsdaten erfolgen?

Die Angabe der Zugangsdaten (authentification token) muss bei jeder Transaktion im Element „extraRequestData“ am Ende des SOAP-Envelope erfolgen.

In welchen Formaten können neue oder geänderte Datensätze eingespielt werden?

Neuerfassungen und Updates von Normdatensätzen der GND via SRU-Record-Update-Protokoll müssen im Austauschformat MARC21-xml erfolgen.

In welchem Feld wird der Zeitstempel im Format MARC21-xml angegeben?

Der Zeitstempel wird im MARC-21-xml-Feld 005 hinterlegt und wird zum Vergleich mit dem aktuellen Zeitstempel des Datensatzes in der Datenbank herangezogen.

Was ist ein „recordIdentifier“ mit einem gnd-Präfix in der SRU-Antwort?

Dieser „recordIdentifier“ ist die eindeutige GND-Nummer. Sie setzt sich zusammen aus dem Namespace „gnd“ und der GND-Nummer in der Form: „gnd:gnd118512676“.
Zur Erläuterung: Die GND-Nummer wird im MARC-Feld 035 $a angegeben, zum Beispiel 035 $a(DE-588)118512676.
Für den „recordIdentifier“ wird der ISIL/MARC Organization Code der GNDDE-588“ als Präfix „gnd“ aufgelöst. Siehe dazu auch Deutsche ISIL-Agentur und Sigelstelle.

Was ist ein „recordIdentifier“ mit ppn-Präfix in der SRU-Antwort?

Dieser „recordIdentifier“ ist die interne Identifikationsnummer der Deutschen Nationalbibliothek. Sie setzt sich zusammen aus dem Namespace „ppn“ und der Identifikationsnummer in der Form: „ppn:118512676“.
Zur Erläuterung: Die PPN/IDN wird in MARC-Feld 001 geliefert, zum Beispiel 129602434.
Da die Schnittstelle allgemein ausgerichtet ist, wird in der SRU-Antwort (Response) immer die interne Identifikationsnummer der Deutschen Nationalbibliothek zurückgemeldet – unabhängig davon, welcher Identifier in der SRU-Anfrage (Request) gesendet wurde.


Letzte Änderung: 24.04.2023
Kurz-URL: https://www.dnb.de/ons
Kontakt: schnittstellen-service@dnb.de

nach oben