OAI-PMH: Unterschied zwischen den Versionen

Aktuelle Version vom 7. Juni 2024, 13:54 Uhr

OAI-PMH Open Archives Initiative Protocol for Metadata Harvesting

Eine OAI^[1]-Schnittstelle dient dem Anreichern und Austausch von Daten aus Online-Datenbanken und kann in APS eingerichtet werden.^[2]

OAI-Schnittstellen

DNB:

https://www.dnb.de/DE/Professionell/Metadatendienste/Datenbezug/OAI/oai_node.html

DDB:

https://pro.deutsche-digitale-bibliothek.de/daten-nutzen/schnittstellen

In der Erfassung bei Foto Marburg werden die Daten über den OAI-Status von der Erfassungsdatenbank in die Redaktion und anschließend in die Publikation weitergeleitet.

Identify

Die Query-Parameter^[3] "?verb=Identify" zeigen allgemeine Informationen zu einer OAI-Schnittstelle: ^[4]

ListMetadataFormats

Für die Anzeige der verfügbaren Metadatenformate wird der Parameter "ListMetadataFormats" übermittelt:

<metadataPrefix>oai_dc</metadataPrefix>... <metadataPrefix>raw</metadataPrefix>

ListSets

Die "ListSets" informieren darüber, welche Dokumentgruppen, z.B. Objekte, Künstler verfügbar sind.

<setSpec>obj</setSpec>

Beispiel für den Download (nur für freigeschaltete IP-Adressen):

curl -s "https://aps-production.khi.fi.it/oai-pmh?verb=ListSets" -o "khi-ListSets.xml"

ListRecords

Der Parameter "ListRecords" listet jeweils 100 Dokumente auf:

https://oai.biblhertz.it/foto/oai-pmh?verb=ListRecords&metadataPrefix=raw

Für die nächsten 100 Dokumente werden der "resumptionToken" und für die Gesamtmenge die "completeListSize" benötigt:

<resumptionToken completeListSize="251969" expirationDate="2023-02-16T16:08:50Z">{3b27046c-953b-4b82-8e51-25bae24a48bd}</resumptionToken>

GetRecord

Mit "GetRecord" lassen sich gezielt einzelne Dokumente unter Kenntnis der Dokumentnummer aus Element 5000 (OBJ-Dok.-Nr.) abrufen:

Beispiel für den Download einer Datei:

curl -s "https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08073329&metadataPrefix=raw" -o "obj08073329.xml"

↑ https://www.openarchives.org/OAI/openarchivesprotocol.html
↑ http://apswiki.de/doku.php?id=aps:aps-schnittstellen
↑ OAI Verbs https://sickle.readthedocs.io/en/latest/oaipmh.html
↑ Manuscripta Medievalia liefert keine Daten aus: http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListRecords&metadataPrefix=oai_dc

[1] ttps://www.openarchives.org/OAI/openarchivesprotocol.html

[2] ttp://apswiki.de/doku.php?id=aps:aps-schnittstellen

[3] OAI Verbs https://sickle.readthedocs.io/en/latest/oaipmh.html

[4] Manuscripta Medievalia liefert keine Daten aus: http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListRecords&metadataPrefix=oai_dc

[1]

[2]

[3]

[4]

@@ Zeile 2: / Zeile 2: @@
 Eine OAI<ref>https://www.openarchives.org/OAI/openarchivesprotocol.html</ref>-Schnittstelle dient dem Anreichern und Austausch von Daten aus Online-Datenbanken und kann in [[APS]] eingerichtet werden.<ref>http://apswiki.de/doku.php?id=aps:aps-schnittstellen</ref>
+=== OAI-Schnittstellen ===
+DNB:
+* https://www.dnb.de/DE/Professionell/Metadatendienste/Datenbezug/OAI/oai_node.html
+DDB:
+* https://pro.deutsche-digitale-bibliothek.de/daten-nutzen/schnittstellen
 In der Erfassung bei Foto Marburg werden die Daten über den [[OAI-Status]] von der Erfassungsdatenbank in die Redaktion und anschließend in die Publikation weitergeleitet.
@@ Zeile 7: / Zeile 15: @@
 === Identify ===
-Die Query-Parameter "?verb=Identify" zeigen allgemeine Informationen zu einer OAI-Schnittstelle:
+Die Query-Parameter<ref>OAI Verbs https://sickle.readthedocs.io/en/latest/oaipmh.html</ref> "?verb=Identify" zeigen allgemeine Informationen zu einer OAI-Schnittstelle: <ref>Manuscripta Medievalia liefert keine Daten aus: http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListRecords&metadataPrefix=oai_dc</ref>
-* http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=Identify
 * https://oai.biblhertz.it/foto/oai-pmh?verb=Identify
+* https://heidicon.ub.uni-heidelberg.de/api/v1/plugin/base/oai/oai?verb=Identify
+=== ListMetadataFormats ===
+Für die Anzeige der verfügbaren Metadatenformate wird der Parameter "ListMetadataFormats" übermittelt:
+* https://heidicon.ub.uni-heidelberg.de/api/v1/plugin/base/oai/oai?verb=ListMetadataFormats
+* https://oai.biblhertz.it/foto/oai-pmh?verb=ListMetadataFormats
+<code><metadataPrefix>oai_dc</metadataPrefix>...
+<metadataPrefix>raw</metadataPrefix></code>
 === ListSets ===
@@ Zeile 20: / Zeile 37: @@
 <code><setSpec>obj</setSpec></code>
+Beispiel für den Download (nur für freigeschaltete IP-Adressen):
+<code>curl -s "https://aps-production.khi.fi.it/oai-pmh?verb=ListSets" -o "khi-ListSets.xml"</code>
 === ListRecords ===
@@ Zeile 25: / Zeile 46: @@
 Der Parameter "ListRecords" listet jeweils 100 Dokumente auf:
-* https://oai.biblhertz.it/foto/oai-pmh?metadataPrefix=raw&verb=ListRecords
+* https://oai.biblhertz.it/foto/oai-pmh?verb=ListRecords&metadataPrefix=raw
 Für die nächsten 100 Dokumente werden der "resumptionToken" und für die Gesamtmenge die "completeListSize" benötigt:
@@ Zeile 33: / Zeile 54: @@
 === GetRecord ===
-Mit "GetRecord" lassen sich gezielt einzelne Dokumente unter Kenntnis der Dokumentnummer abrufen:
+Mit "GetRecord" lassen sich gezielt einzelne Dokumente unter Kenntnis der Dokumentnummer aus Element [[5000 (OBJ-Dok.-Nr.)]] abrufen:
 * https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08073329&metadataPrefix=raw
+* https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08127672&metadataPrefix=raw
+* https://heidicon.ub.uni-heidelberg.de/api/v1/plugin/base/oai/oai?verb=GetRecord&metadataPrefix=lido&identifier=oai:heidicon.ub.uni-heidelberg.de:ed84679c-e602-4b7c-9e77-f8b5c9c97b74
+Beispiel für den Download einer Datei:
+<code>curl -s "https://oai.biblhertz.it/foto/oai-pmh?verb=GetRecord&identifier=oai::obj::08073329&metadataPrefix=raw" -o "obj08073329.xml"</code>
 -----------
 <references/>