OAI-PMH Interface
Table of contents
OAI-PMH
ZORA supports OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting Version 2.0), a standard for the automated retrieval and exchange of data from repositories. Structured metadata is provided in selectable formats. OAI-PMH consists of six verbs or services that are invoked via HTTP.
ZORA's OAI-PMH interface can be accessed via the following base URL: https://www.zora.uzh.ch/server/oai/
Default Context: https://www.zora.uzh.ch/server/oai/request?verb=Identify
OpenAIRE Context : https://www.zora.uzh.ch/server/oai/openaire?verb=Identify
Metadata Formats
The following metadata formats are available:
- oai_dc: Dublin Core, a standard bibliographic exchange format, based onOpenAIRE Guidelines for Literature Repositories v3
- oai_datacite: DataCite Metadata Schema 4.4, comprehensive format for research data and publication repositories
- marc: MARC 21 XML Schema, standard exchange format for library catalogs, developed by the Library of Congress
- mods: Metadata Object Description Schema by the Library of Congress
- akaber: exchange format for the UZH academic report, based on Dublin Core
Accessing metadata formats viahttps://www.zora.uzh.ch/server/oai/request?verb=ListMetadataFormats
Sets
Sets comprise partial lists of ZORA items that are defined by specific criteria. Besides the sets that are defined by the Communities & Collections, there are some specific sets
| SetSpec | Setname | Description |
|---|---|---|
| openaire | OpenAIRE Set | Items for OpenAIRE |
|
6574683D596573 |
swisscovery | Items for indexation in swisscovery |
| 6E623D596573 | NB = Yes | Dissertations for the Swiss National Library |
| ec_fundedresources | EC_fundedresources | Items with funder data |
| 74797065733D6D6F6E6F6772617068 | Type = Monograph | Monographs |
| 74797065733D6E65777370617065725F61727469636C65 | Type = Newspaper Article | Newspaper articles |
| 74797065733D61727469636C65 | Type = Journal Article | Journal articles |
| 74797065733D646973736572746174696F6E | Type = Dissertation | Dissertations |
| 74797065733D636F6E666572656E63655F6974656D | Type = Conference or Workshop Item | Conference or workshop items |
| 74797065733D736369656E74696669635F7075626C6963617 4696F6E5F696E5F656C656374726F6E69635F666F726D |
Type = Scientific Publication in Electronic Form | Scientific publications in electronic form |
| 74797065733D626F6F6B5F73656374696F6E | Type = Book Section | Book sections |
| 74797065733D6564697465645F736369656E74696669635F776F726B | Type = Edited Scientific Work | Edited scientific works |
All set names can be retrieved viahttps://www.zora.uzh.ch/server/oai/request?verb=ListSets
Harvesting OAI-PMH
Usage:python3.14 pyoaiharvest.py -h
usage: pyoaiharvest.py [-h] [-l LINK] [-o FILENAME] [-f FROM_DATE] [-u UNTIL] [-m MD_PREFIX] [-s SETNAME]
<options:
-h, --help show this help message and exit
-l, --link LINK URL of repository
-o, --filename FILENAME write repository to file
-f, --from FROM_DATE harvest records from this date yyyy-mm-dd
-u, --until UNTIL harvest records until this date yyyy-mm-dd
-m, --mdprefix MD_PREFIX use the specified metadata format
-s, --setName SETNAME harvest the specified set
Example: Harvesting of the OpenAIRE set in MarcXML format:python3.14 pyoaiharvest.py -l https://www.zora.uzh.ch/server/oai/request -o switch_dc.xml -m marc -s openaire
Periodic update
The metadata for the OAI-PMH index is updated daily at 11:00 p.m.