Page History

...

The DSpace platform supports the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) version 2.0 as a data provider. This is accomplished using the XOAI OAI-PMH Java Toolkit.

Wiki MarkupThe DSpace build process builds a Web application archive, _\[dspace-source\]/build/oai.war_), in much the same way as the Web UI build process described above. The only differences are that the JSPs are not included. This 'webapp' is deployed to receive and respond to OAI-PMH requests via HTTP. In  In a typical configuration, this is deployed at _oai_, containing request, driver and openaire contexts, for example:

http://dspace.myu.edu/oai/request?verb=Identify

...

oai:dspace.myu.edu:123456789/345

Wiki MarkupIf you wish to use a different scheme, this can easily be changed by editing the value of identifier.prefix at \prefix at [dspace\]/config/modules/oai.cfg file.

Access control

OAI provides no authentication/authorisation details, although these could be implemented using standard HTTP methods. It is assumed that all access will be anonymous for the time being.unmigrated-wiki-markup

A question is, "is all metadata public?" Presently the answer to this is yes; all metadata is exposed via OAI-PMH, even if the item has restricted access policies. The reasoning behind this is that people who do actually have permission to read a restricted item should still be able to use OAI-based services to discover the content. But, exposed data could be changed by changing the XSLT defined at \defined at [dspace\]/config/modules/oai/metadataFormats.

Modification Date (OAI Date Stamp)

...

DSpace supports resumption tokens for 'ListRecords', 'ListIdentifiers' and 'ListSets' OAI-PMH requests.

Wiki MarkupEach OAI-PMH ListRecords request will return at most 100 records (by default) but it could be configured in file \ [dspace\]/config/modules/oai/xoai.xml.

When a resumption token is issued, the optional completeListSize and cursor attributes are included. OAI 2.0 resumption tokens are persistent, so expirationDate of the resumption token is undefined, they do not expire.

...