OAI-PMH: Unterschied zwischen den Versionen

Aus Data-Wiki
imported>Glorius
 
(19 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
=== OAI-PMH Open Archives Initiative Protocol for Metadata Harvesting ===
== OAI-PMH Open Archives Initiative Protocol for Metadata Harvesting ==


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>
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.
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<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>
* 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 ===
Die "ListSets" informieren darüber, welche Dokumentgruppen, z.B. Objekte, Künstler verfügbar sind.
* http://www.manuscripta-mediaevalia.de/db/apsisa.dll/oai-pmh?verb=ListSets
* https://oai.biblhertz.it/foto/oai-pmh?verb=ListSets
<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 ===
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:
<code><resumptionToken completeListSize="251969" expirationDate="2023-02-16T16:08:50Z">{3b27046c-953b-4b82-8e51-25bae24a48bd}</resumptionToken></code>
=== GetRecord ===
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/>
<references/>

Aktuelle Version vom 6. November 2024, 11:30 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:

DDB:

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:

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"