# Zurich Open Platform (ZOP, DSpace) OAI
Basis-URL:
https://zop.zb.uzh.ch/server/oai/request?
## OAI-Sets
Komplette Liste der verfügbaren Sets:
https://zop.zb.uzh.ch/server/oai/request?verb=ListSets
Die beiden Sets *Aus der Zentralbibliothek Zürich (com_123456789_1)* und *Partnerinstitutionen (com_123456789_4)* bilden zusammen den gesamten ZOP-Inhalt ab.
## Verfügbare Metadaten-Formate
https://zop.zb.uzh.ch/server/oai/request?verb=ListMetadataFormats
Das Format zop_dc enthält Thumbnail-Bilder für Cover/Titelseiten.
Beispiel:
https://zop.zb.uzh.ch/bitstream/123456789/394/3/990060637490205508.pdf.jpg
## Abfrage-Beispiele
- GetRecord
https://zop.zb.uzh.ch/server/oai/request?verb=GetRecord&metadataPrefix=zop_dc&identifier=oai:zop.zb.uzh.ch:123456789/394
- Der Identifier ist nach folgendem Schema aufgebaut:
oai:zop.zb.uzh.ch:123456789/{id}
- ListRecords
Nach Zeitraum:
https://zop.zb.uzh.ch/server/oai/request?verb=ListRecords&metadataPrefix=zop_dc&from=2021-08-23&until=2021-08-29
Nach Set, z.B. Adressbücher:
https://zop.zb.uzh.ch/server/oai/request?verb=ListRecords&metadataPrefix=zop_dc&set=col_123456789_27
mit Resumption Token:
https://zop.zb.uzh.ch/server/oai/request?verb=ListRecords&resumptionToken=zop_dc///col_123456789_2/100
https://zop.zb.uzh.ch/server/oai/request?verb=ListRecords&resumptionToken=zop_dc///col_123456789_2/200
(es werden offenbar standardmässig 100 Records auf einmal zurückgeliefert)
- ListIdentifiers
https://zop.zb.uzh.ch/server/oai/request?verb=ListIdentifiers&metadataPrefix=zop_dc&set=col_123456789_2
## Verbindung zum Katalogisat der physischen Ressource in Alma
### Swisscovery-Link
Das User Interface von ZOP bietet einen "Katalog-Link" auf die zum digitalen Objekt gehörende physische Ressource in Swisscovery an.
Beispiel:
https://zop.zb.uzh.ch/handle/123456789/1002
Über die OAI-Schnittstelle von ZOP ist dieser Link jedoch nicht verfügbar.
In gewissen Fällen ist die Alma MMS ID der zum digitalen Objekt gehörenden physischen Ressource im Dateinamen des Thumbnail-Bilds enthalten.
Beispiel:
https://zop.zb.uzh.ch/bitstream/123456789/394/3/990060637490205508.pdf.jpg
Mit der Alma MMS ID kann z.B. der Swisscovery-Link zur physischen Ressource "erraten" werden:
https://uzb.swisscovery.ch/discovery/fulldisplay?context=L&vid=41SLSP_UZB:UZB&docid=alma990060637490205508
Auch die SRU-Schnittstelle von Alma kann mit der MMS ID abgefragt werden, um das Katalogisat zur physischen Ressource im Marcxml-Format zu erhalten:
https://uzb.swisscovery.ch/view/sru/41SLSP_UZB?version=1.2&operation=searchRetrieve&recordSchema=marcxml&query=alma.mms_id=990104431070205508
Die Alma MMS ID ist jedoch nicht systematisch im Dateinamen des Digitalisats enthalten.
### Kein Link zum Digitalisat in Marc-Feld 856 der Alma-Titelaufnahme
Das Katalogisat der physischen Ressource in Alma enthält keinen Link zum Digitalisat auf ZOP im Marc-Feld 856.
Beispiel:
https://uzb.swisscovery.ch/permalink/41SLSP_UZB/rloemb/alma990042368750205508
Dies im Unterschied zu physischen Ressourcen, deren Digitalisate auf e-rara und e-manuscripta sind.
Beispiel:
https://uzb.swisscovery.ch/permalink/41SLSP_UZB/1d8t6qj/alma990106367390205508
Allerdings hat die physische Ressource im zweiten Beispiel eine Digitale Repräsentation in Alma und ist sowohl als physische als auch als elektronische Ressource codiert:
007 cr
007 ki
## Link zum Digitalisat
Ähnlich wie der Swisscovery-Link ist auch der Download-Link zum pdf (Download-Button) auf dem User Interface zu finden.
Beispiel:
https://zop.zb.uzh.ch/handle/123456789/979
[](https://data.zb.uzh.ch/map/uploads/images/gallery/2022-09/zop-pdf.png)
Im OAI-Record ist der Link nicht in allen Formaten enthalten – METS ist eines der Formate, das den Download-Link enthält.
Beispiel:
https://zop.zb.uzh.ch/server/oai/request?verb=GetRecord&metadataPrefix=mets&identifier=oai:zop.zb.uzh.ch:123456789/979
https://zop.zb.uzh.ch/bitstream/123456789/979/1/990033737450205508.pdf
Folgende Formate enthalten den pdf-Download-Link:
- mets
- ore (Namespace http://www.w3.org/2005/Atom)
- didl
Folgende Formate enthalten den Thumbnail-Link:
- ore
- zop_dc
## Link zum Volltext
Wenn für die Ressource ein Volltext verfügbar ist, enthält das OAI-Record im METS-Format einen Volltext-Link.
Beispiel:
https://zop.zb.uzh.ch/server/oai/request?verb=GetRecord&metadataPrefix=mets&identifier=oai:zop.zb.uzh.ch:123456789/979
https://zop.zb.uzh.ch/bitstream/123456789/979/2/990033737450205508.pdf.txt
## Keine systematisch strukturierten Datei-URLs
Auf den ersten Blick scheint es möglich zu sein, den Link zum Digitalisat aus dem Thumbnail-Link (Format zop_dc) zu ermitteln:
Thumbnail:
https://zop.zb.uzh.ch/bitstream/123456789/676/3/990059691690205508.pdf.jpg
Ganzes pdf:
https://zop.zb.uzh.ch/bitstream/123456789/676/1/990059691690205508.pdf
Dies funktioniert aber nicht in jedem Fall: Es ist nicht immer .../1/... für das ganze Digitalisat, .../2/... für den Volltext und .../3/... für das Thumbnail.
Auch die Alma MMS ID ist nicht immer im Dateinamen enthalten. Bei den digitalisierten Adressbüchern der Stadt Zürich enthalten die Dateinamen statt der MMS ID den Jahrgang:
https://zop.zb.uzh.ch/bitstream/123456789/848/4/1998_1.pdf.jpg
https://zop.zb.uzh.ch/bitstream/123456789/848/6/1998_2.pdf.jpg
(aus https://zop.zb.uzh.ch/server/oai/request?verb=GetRecord&metadataPrefix=zop_dc&identifier=oai:zop.zb.uzh.ch:123456789/848)