OAI-PMH is a protocol for harvesting the metadata descriptions of objects from an archive and it is the way that MWDL members share their metadata with us.
In this guide you will find tips for making the OAI-PMH sharing process smoother between your institution and MWDL. While we have included links to OAI-PMH resources for some common digital repositories in our network (right), we are not experts in how to configure your specific OAI-PMH settings. Each system is different, so you will need to consult your user manual, vendor, or systems team for information about making configuration changes.
Our harvesting system in Ex Libris Primo sends a standard “Identify” request first to verify that the OAI repository is functioning.
Then it sends a “ListRecords” request with “from” and “until” parameters to obtain the first batch of metadata records from the repository.
Additional “ListRecords” requests with appropriate “resumptionToken” parameters, are sent as needed to get the full listing of records.
We run a number of normalization routines on the harvested records to transform the Dublin Core metadata into Primo normalized XML.
Most institutions create metadata that complies with one of several possible metadata schemes. MODS, Dublin Core (DC), and Qualified Dublin Core (QDC) are the most common schemes that our partners use, though your institution might use a different scheme like METS or MARC, or even a locally created scheme.
MWDL only harvests OAI-PMH feeds of Dublin Core (DC) and Qualified Dublin Core (QDC) at this time. Be sure to double-check your OAI-PMH feed to make sure that it is outputting your metadata in Dublin Core format.
Querying your collection’s OAI stream in a Web browser is a great way to check the mapping of your fields, and to see if any text is getting truncated or any non-Unicode characters are being included. Also, if the OAI provision is not working, you will get an error message in the results, which may give useful information.
MWDL harvests metadata at the collection level. We do not have the ability to harvest individual items or to omit specific items from a collection. In other words, we can’t cherry pick items from your collections.
MWDL includes digital collections for search on our search portal at https://mwdl.org only by explicit permission of the repository managers. To request collection(s) be added to or deleted from the MWDL database, please use this form.