SRU ermöglicht die dezidierte Recherche, ohne eine eigene Datenbank vorzuhalten.
OAI ermöglicht eine ständige Synchronisation großer Datenbestände. Dies setzt den Datenimport eines aktuellen Grundbestandes in eine eigene Datenbank voraus.

Eine OAI-Anfrage liefert alle Datensätze zurück, die in dem angegebenen Zeitraum geändert oder neu erstellt wurden. Ein retrospektiver Datenbezug (in die Vergangenheit) über mehrere Monate wird nicht empfohlen, da automatische Verarbeitungen Datensätze fortlaufend aktualisieren und dadurch der Datenbezug unvollständig ist. Für einen retrospektiven Datenbezug stellen wir Gesamtabzüge bereit.

Es ist nicht möglich, alle Datensätze zu einem anderen bestimmten Kriterium als dem Änderungsdatum abzufragen. Für eine solche Anfrage verwenden Sie bitte die SRU-Schnittstelle.
Es ist nicht möglich, alle neuen Sätze über die OAI-Schnittstelle abzufragen. Wieso?
Wird ein Datensatz neu erzeugt, entspricht das Änderungsdatum dem Erstellungsdatum. Wird nun zu einem späteren Zeitpunkt dieser Datensatz manuell oder automatisch verändert, ändert sich das Änderungsdatum und eine Anfrage an die OAI-Schnittstelle mit dem Zeitraum des Erstelldatums würde keinen Treffer liefern, obwohl dieser Satz tatsächlich zu diesem Zeitpunkt erstellt wurde. Dieser Satz würde erst ausgeliefert, wenn der Zeitraum der letzten Änderung angegeben wird, da nur dieses Kriterium von OAI berücksichtigt wird.

Die Deutsche Nationalbibliothek empfiehlt eine Abfragefrequenz nicht unter einer Minute, da es ansonsten zu doppelten Datenlieferungen kommen kann (nicht relevant für OAI-Anfragen mit "resumptionToken"). Die Abfragefrequenz sollte nicht kleiner sein, als der abgefragte Zeitraum.

Eine Trefferliste ist auf 100.000 Datensätze begrenzt. Es erfolgt eine Fehlermeldung bei größerer Treffermenge. Abfragezeitraum und –frequenz sind entsprechend einzuschränken.

Der Abfragezeitraum sollte nicht zu weit reichen, um eine Treffermenge über 100.000 Datensätzen zu vermeiden. Empfehlung bei nicht zeitkritischen Verfahren für Abfragezeitraum/Frequenz: 30 Minuten. Bei kleinen Sets (z. B. Online-Dissertationen) reicht ein einmal tägliches oder einmal wöchentliches Harvesting aus, da dadurch ein Datensatz, der in diesem Zeitraum mehrfach geändert wurde, nur einmal bezogen und die Treffermenge trotzdem nicht zu groß wird.
Wir empfehlen zudem als Wiederaufsetzzeitpunkt ("from") die Zeitangabe im Element "responseDate", z. B. <responseDate>2017-08-30T08:12:54Z</responseDate> zu nutzen, da diese Zeitangabe der aktuellen Verfügbarkeit der Daten in unserem Repository am besten entspricht. Zusätzlich empfehlen wir das Harvesten mit einer geringen zeitlichen Überlappung ("responseDate" minus eine Minute = "from").

Bei Sonderaktionen mit Änderungen an über 50.000 Datensätzen an einem Tag gehen wir folgendermaßen vor:

• Umfangreiche Sonderaktionen werden am Wochenende/Feiertag durchgeführt.
• Die Änderungen an den Datensätzen werden nicht protokolliert, sodass diese Daten über den OAI-Index nicht sichtbar sind.
  Die Datenänderungen sind erst zu einem späteren Zeitpunkt im OAI-Index sichtbar, wenn der OAI-Index komplett neu generiert wurde
• Löschungen im Sinne von OAI werden nicht geliefert.

Ein zeitnah harvestendes System bekommt somit von den Änderungen nichts mit, auch wenn es kontinuierlich durchläuft. Nur wenn es sich um relevante Änderungen für ein harvestendes System handelt, kann das Harvest-Zeitintervall entsprechend zurückgesetzt werden.

Löschungen im Sinne von OAI werden nicht geliefert.
Für die ZDB-Titel- und -Lokaldaten sowie die GND werden gelöschte und umgelenkte Sätze als verkürzte Datensätze geliefert, entsprechend gekennzeichnet und verfügen über ID-Nummern, Standard- und Datumsfelder.
Entsprechend gekennzeichnete Lokaldaten sind maximal eine Woche über die OAI-Schnittstelle verfügbar (weitere Informationen im FAQ ILTIS).
Der Geschäftsgang für Titel-Änderungen ist noch nicht abschließend konzipiert.

Über die OAI-Schnittstelle werden nur die Datensätze der Teile (mit abhängigem oder unabhängigem Titel) ausgeliefert. Im Gegensatz dazu werden über den Datendienst via SFTP-/WWW-Server sowohl die Datensätze der Teile als auch die übergeordneten Datensätze bereitgestellt. Über OAI-PMH ist die Abfrage der übergeordneten Datensätze über den entsprechenden Identifier generell möglich. Dieser Identifier ist je nach Datensatztyp (mit abhängigem oder unabhängigem Titel) und Format in unterschiedlichen Feldern beziehungsweise Elementen der Datensätze der Teile hinterlegt, siehe Übersicht.

Nein, da Datensätze immer wieder geändert werden und Datensätze über OAI nur mittels des Änderungsdatums recherchiert werden können, lässt sich nicht vorhersagen, wann ein bestimmter Satz in einer OAI-Antwort enthalten ist.

Ein „resumptionToken“ ermöglicht die Rückgabe von Teilantworten bei Treffermengen ab 51 Datensätzen. Der OAI-Harvester bekommt einen Token, den er für die folgende Anfrage beim OAI-Repository nutzen muss, um die nächste Teilantwort zu erhalten. In jeder Teilantwort wird, wenn noch nicht alle Datensätze ausgeliefert wurden, ein neuer „resumptionToken“ mitgeliefert, mit dem die nächste Teilantwort angefordert werden muss. Im Element „resumptionToken“ sind die Attributwerte der aktuellen Listenposition und die Gesamtanzahl der Datensätze enthalten (cursor="50" completeListSize="xxxxxx"). Pro OAI-Antwort werden maximal 50 Datensätze geliefert. Ein „resumptionToken“ ist maximal 30 Minuten gültig.

Beispiel mit „resumptionToken“:

https://services.dnb.de/oai/repository?verb=ListRecords&resumptionToken=xxxxxxxxxx_hier_resumptionToken_einfügen_xxxxxxxx

Die koordinierte Weltzeit wird auch UTC (Universal Time Coordinated) genannt und ist die Grundlage zur Berechnung der Ortszeit.
Beispiel für Deutschland:
Ortszeit für Berlin ist UTC+1 (während der Sommerzeit gilt UTC+2). Die Zeitangabe seitens des OAI-Servers erfolgt in koordinierter Weltzeit UTC.
Zur aktuellen Ortszeit 10:30 Uhr ist es daher nur sinnvoll bis UTC 9:29 Uhr zu harvesten, während der Sommerzeit somit bis UTC 8:29 Uhr.

Innerhalb einer OAI-Antwort werden Markup-Zeichen (<, > und &) in einem CDATA-Abschnitt transportiert.

Bitte senden Sie konkrete Anfragen oder Fehlermeldungen zur OAI-Schnittstelle zeitnah. Nur so ist eine Nachvollziehbarkeit gewährleistet und Sie unterstützen damit die Fehlerbehebung.
Bitte senden Sie Anfragen oder Fehlermeldungen immer mit folgenden Angaben an schnittstellen-service@dnb.de:

• Syntax OAI-PMH-Anfrage (Set, Format, Zeitraum)
• Fehlermeldung/Beschreibung
• Kontext (wiederholt, sporadisch, verwendeter Client …)

Wir empfehlen, den Timeout auf mindestens 2 Minuten zu setzen, damit es nicht zu Abbrüchen beim Harvesten kommt. Die Antwortzeiten in bestimmten sets (z.B. zdb:holdings) können bei umfangreichen Änderungen trotz kurzem Abfragezeitraum mehr als 90 Sekunden betragen.

Für den ersten Einstieg geeignet ist zum Beispiel die Software-Suite Catmandu, OpenRefine oder Metafacture, zur Datenanalyse der „Konstanz Information Miner“ (KNIME) oder das Metadata Quality Assurance Framework. Eine weiterführende Übersicht bieten die Vortragsfolien „Open Source Software zur Verarbeitung und Analyse von Metadaten“ und der Artikel Survey of Tools for Linked Data Consumption.

Um über Änderungen und Neuerungen sowie Störungen oder Wartungsarbeiten zeitnah informiert zu werden, empfehlen wir Ihnen die Eintragung in den Mailverteiler OAI-Schnittstelle.