da-ra OAI-PMH Data Provider Beta

OAI-PMH Data Provider Beta

What is this service?

This da|ra service exposes metadata stored in da|ra using the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH).

Who can use this service?

This service is open to everyone and is meant to be accessed by OAI-PMH compliant harvesters or any application that issues OAI-PMH requests. The service base address is http:://da-ra.de/oaip and the service identifier is available here.

What is OAI-PMH?

In brief, OAI-PMH provides a set of services that enables exposure and harvesting of repository metadata. The protocol is comprised of six verbs that specify the service being invoked, they are:

Identify - used to retrieve information about the repository.
ListIdentifiers - used to retrieve record headers from the repository.
ListRecords - used to harvest full records from the repository.
ListSets - used to retrieve the set structure of the repository.
ListMetadataFormats - lists available metadata formats that the repository can disseminate.
GetRecord - used to retrieve an individual record from the repository.

Selective harvesting can be performed by the use of accompanying parameters. Available parameters are:

identifier - specifies a specific record identifier.
metadataPrefix - specifies the metadata format that the records will be returned in.
set - specifies the set that returned records must belong to.
from - specifies that records returned must have been created/update/deleted on or after this date.
until - specifies that records returned must have been created/update/deleted on or before this date.
resumptionToken - a token previously provided by the server to resume a request where it last left off.

The verbs and parameters can be combined to issue requests to the service such as:

For more details on the protocol, its implementation, and uses please visit the OAI-PMH web site.

Available Metadata Formats

da|ra makes the metadata sets available for public use under the CC0 1.0 Public Domain Designation

The da|ra OAI-PMH Data Provider is able to disseminate records in the following formats:

OAI Dublin Core (oai_dc)

As a minimum requirement for OAI-PMH compliance, metadata must be made available in the OAI Dublin Core format. For more information please see the OAI-PMH web site.

DDI-Lifecycle 3.1

For more information about this format and its schema please see the DDI Lifecycle 3.1 Specification.

DDI-Lifecycle 3.2

For more information about this format and its schema please see the DDI Lifecycle 3.2 Specification.

Set Structure

Each da|ra Publication Agent is represented by a set in the repository. Therefore it is easy to harvest all available metadata for a particular Publication Agent.

Arbitrary Queries

You can use custom solr search queries in your setspec. Therefore the solr query string must be base64url encoded, see RFC 4648, and appended to any normal setspec or the empty string separated by a tilde (~). There shall be no tailing padding character (=).

Example:

solr query string	`fq=resourceType:Dataset`
base64url	`ZnE9cmVzb3VyY2VUeXBlOkRhdGFzZXQ=`
set name	http://www.da-ra.de/oaip/oai?verb=ListIdentifiers&metadataPrefix=oai_dc&set=~ZnE9cmVzb3VyY2VUeXBlOkRhdGFzZXQ=

Currently the solr query params q and fq are supported. Please, contact us for more information on the available Solr fields.

Help

If you have questions please contact .