ZOP OAI
Base URL
https://zop.zb.uzh.ch/oai/request?
OAI-Sets
Komplette Liste der verfügbaren Sets: https://zop.zb.uzh.ch/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/oai/request?verb=ListMetadataFormats
Das Format zop_dc enthält Thumbnail-Bilder für Cover/Titelseiten, Bsp.:
<zop:thumbnail>https://zop.zb.uzh.ch/bitstream/123456789/394/3/990060637490205508.pdf.jpg</zop:thumbnail>
Abfrage-Beispiele
-
Der Identifier ist nach folgendem Schema aufgebaut:
oai:zop.zb.uzh.ch:123456789/{id}
-
ListRecords
Nach Zeitraum:
https://zop.zb.uzh.ch/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/oai/request?verb=ListRecords&metadataPrefix=zop_dc&set=col_123456789_27
mit Resumption Token:
https://zop.zb.uzh.ch/oai/request?verb=ListRecords&resumptionToken=zop_dc///col_123456789_2/100
https://zop.zb.uzh.ch/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/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, Bsp.: 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:
<zop:thumbnail>https://zop.zb.uzh.ch/bitstream/123456789/394/3/990060637490205508.pdf.jpg</zop:thumbnail>
Mit der Alma MMS ID kann z.B. der Swisscovery-Link zur physischen Ressource "erraten" werden: https://uzb.swisscovery.slsp.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.slsp.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 – dies im Unterschied zu physischen Ressourcen, deren Digitalisate auf e-rara und e-manuscripta sind. Bsp.: https://uzb.swisscovery.slsp.ch/permalink/41SLSP_UZB/1d8t6qj/alma990106367390205508. Allerdings hat die physische Ressource in diesem 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.
Im OAI-Record ist der Link nicht in allen Formaten enthalten – METS ist eines der Formate, das den Download-Link enthält, Bsp.: https://zop.zb.uzh.ch/oai/request?verb=GetRecord&metadataPrefix=mets&identifier=oai:zop.zb.uzh.ch:123456789/979.
<premis:objectIdentifierValue>https://zop.zb.uzh.ch/bitstream/123456789/979/1/990033737450205508.pdf</premis:objectIdentifierValue>
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/oai/request?verb=GetRecord&metadataPrefix=mets&identifier=oai:zop.zb.uzh.ch:123456789/979
<premis:objectIdentifierValue>https://zop.zb.uzh.ch/bitstream/123456789/979/2/990033737450205508.pdf.txt</premis:objectIdentifierValue>
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:
<zop:thumbnail>https://zop.zb.uzh.ch/bitstream/123456789/848/4/1998_1.pdf.jpg</zop:thumbnail>
<zop:thumbnail>https://zop.zb.uzh.ch/bitstream/123456789/848/6/1998_2.pdf.jpg</zop:thumbnail>