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 https:://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	https://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

Information about updated:

- When a resource is newly registered, it becomes visible immediately resp. after one minute in da|ra and OAI-PMH with timestamp GMT +01.

- When an already registered resource gets a metadata update, it is NOT updated IMMEDIATELY but overnight in Solr. The update will not take place until the next day at 00:30.

- The update is always visible in OAI on the next day, i.e. after 00:30. Of course, with correct update date.

If you have questions please contact .