×

Sehr geehrter Nutzer, Sie benutzen einen veralteten Browser.
Der intranda viewer unterstützt diese Version des Browsers nicht in vollem Umfang.
Aus diesem Grund kann es zu Fehldarstellungen der Seiten kommen.

Bitte benutzen Sie einen der folgenden Browser:

Zur Nutzung der OAI-Schnittstelle

Die OAI-Dienste im Überblick

OAI (Open Archives Initiative) ist eine Initiative, die die Definition einer offenen Schnittstelle zum Austausch von Metadaten zum Ziel hat. Die Kommunikation einer solchen Schnittstelle erfolgt zwischen GEI-Digital als Datenlieferant (data provider) und einem Dienstanbieter (service provider), der die Daten bezieht. Der Bezug erfolgt automatisiert durch einen sogenannten "OAI-Harvester". Das Protokoll, welches für die Kommunikation verwendet wird, hat die Bezeichnung OAI-PMH (OAI-Protocol for Metadata Harvesting). OAI ermöglicht eine ständige Synchronisation großer Datenbestände, dies setzt den Datenimport eines aktuellen Grundbestandes in eine eigene Datenbank voraus.

GEI-Digital bietet eine Anfragemöglichkeit auf seine Daten über eine HTTP- oder HTTPS-Schnittstelle und das OAI-PMH-Protokoll. Eine Anmeldung oder Autorisierung ist dazu nicht erforderlich.

Standard der OAI-Schnittstelle

Protokoll: OAI-PMH Version 2.0

OAI-PMH Protokoll

Das Protokoll OAI-PMH ist webbasiert. Der OAI-Harvester arbeitet mit einfachen Anfragen per HTTP-GET oder -POST und erhält eine HTTP-Antwort vom Datenlieferanten zurück. Diese Antwort enthält, eingebettet in eine XML-Struktur, die angeforderten Metadaten. Ein Vorzug dabei ist, dass ein OAI-Repository auch mit einem Webbrowser abgefragt werden kann.

OAI-Harvester

Um OAI zum Abgleich der Daten zwischen GEI-Digital und einem Dienstanbieter nutzen zu können, muss auf Seiten des Dienstanbieters ein OAI-Harvester (z. B. OAI-PMH Harvester Manager) implementiert werden. Der OAI-Harvester ruft sich in einer Endlosschleife immer wieder selbst auf. Er führt dabei einen "ListRecords-Befehl" aus, der sich auf das für den Dienstanbieter definierte Datenset (Katalog) beschränkt. Des Weiteren wird dem"ListRecords-Befehl"über einenZeitstempel, der Zeitpunkt des letztmaligen Aufrufs mitgegeben. Auf diese Weise ist gewährleistet, dass

  • keine Änderung verpasst wird
  • sich Änderungen zeitnah in der Dienstanbieter-Datenbank widerspiegeln
  • keine für den Service Provider irrelevanten Daten transportiert werden

OAI-Funktionen

Das Protokoll OAI-PMH enthält sechs Basisfunktionen, die an die baseURL (z. B. "http://gei-digital.gei.de/viewer/oai/") mit "?verb=" angefügt werden:

  • Identify: Anzeige von allgemeinen Informationen zum OAI-Repository
  • ListSets: Informationen zu allen im OAI-Repository zur Verfügung stehenden Datensets (Kataloge)
  • ListMetadataFormats: Auflistung aller im OAI-Repository zur Verfügung stehenden Datenformate
  • GetRecord: Abruf einzelner Datensätze mittels ID-Angabe. Voraussetzung ist die Kenntnis der Identifikationsnummer des gewünschten Datensatzes (PPN, URN)
  • ListRecords: Harvesten von Datensätzen mittels Angabe des Zeitraums (from / until) und/oder Datensets. Dies ist der Kernbefehl von OAI. Er ermöglicht selektives Harvesting, d. h. der Harvester kann seine Anfrage auf Datensätze beschränken, die
    • aus einem bestimmten Katalog stammen und
    • in einem bestimmten Zeitraum erzeugt oder geändert wurden

  • Die Zeitangabe erfolgt in koordinierter Weltzeit UTC.

    Zugangsvoraussetzungen

    Eine Anmeldung oder Autorisierung ist dazu nicht erforderlich.

    Nutzungs- und Bezugsbedingungen

    Die Digitalisate werden als Public Domain zur Verfügung gestellt. Die Metadaten aus GEI-Digital werden unter der CC0-Lizenz freigegeben.
    Weitere Informationen zu den Nutzungsbedingungen finden Sie hier.
    Die Metadaten und Online-Schnittstellen von GEI-Digital 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: Dr. Anke Hertling
    E-Mail: gei-digital@gei.de
    Tel.: +49 (0)531 59099-240

    Syntax einer OAI-Anfrage auf eine bestimmte ID-Nummer (PPN) im Format MARC21/XML

    http://gei-digital.gei.de/viewer/oai/?verb=GetRecord&metadataPrefix=marcxml&identifier=PPN65627140X

    Syntax einer OAI-Anfrage auf eine bestimmte ID-Nummer (PPN) im Format METS

    http://gei-digital.gei.de/viewer/oai/?verb=GetRecord&metadataPrefix=mets&identifier=PPN65627140X

    Die URLs im Abschnitt "mets:fileGrp USE="ABBYYXML" verlinken auf die OCR-Volltexte des Digitalisats (seitenweise). Diese müssen kopiert und in einem neuen Browser-Fenster aufgerufen werden.

    Syntax einer OAI-Anfrage nach Titeln im Format MARC21/XML aus der Sammlung „Geschichtsbücher Kaiserreich" aus dem Zeitraum 01.04.2015 – 08.07.2015

    http://gei-digital.gei.de/viewer/oai/?verb=ListRecords&from=2015-04-01&until=2015-07-08&metadataPrefix=marcxml&set=kaiserreichgeschichtsschulbuecher