Project

General

Profile

======================
      Outdated!
======================

Please see up-to-date documentation under http://cybertaxonomy.eu/cdmlib/oai-pmh.html.


CDM Community Server - OAI-PMH

General

In order to allow central aggregators harvesting the CDM Community Stores the OAI-PMH protocol with selective date based harvesting has been implemented in to the CDM Community Stores. BHL":http://www.biodiversitylibrary.org/, "GBIF":http://www.gbif.net, "EOL or any other data aggregator therefore are able to easily pool CDM data selectively and keep their copy up to date by accessing incremental changes only.

The CDM Community Store an an OAI-PMH disseminates different types items #Item like taxa, references, and so on. Therefore the CDM OAI-PMH interface is split in to sub repositories which exist at different base URL. For each type another URL. The implementation of the OAI-PMH is equipped with a XSLT which renders a humane user interface when accessed with a browser.

Currently the following sub repositories exist (All URL are relative to the specific root of the CDM Community Server):

Reference sub repository

base URL: reference/oai

Metadata Formats:

Sets:

  • Any kind of reference

Taxon sub repository

base URL: taxon/oai

Metadata Formats:

Sets:

  • Synonyms

  • Accepted Taxon Concepts

OAI-PMH Registry

Those CDM DataStores willing to expose their data via the OAI-PMH interface can register at an OAI-PMH provider registry The registry process can be triggered from the administrative overview page of the CDM Servers, which is usually available at http://my.server.name:8080/ .

[!CDM|Server_overview.png!]

This overview page shows a table listing all CDM Community Stores which are exposed by this specific CDM Community Server. CDM Community Stores which are not yet registered offer a Request for registration link. Clicking this link allows sending an email to the EDIT OAI-PMH provider registration service. Once a server has been registered this link is being replaced by a text indicating the registration state and the CDM Community Store is listed by the OAI-PMH provider registry with according metadata. This list is returned in XML if not specified differently, whereas the data structure is defined by the http://cybertaxonomy.eu/registry/oai/1.0/providers.xsd XML schema. The OAI-PMH provider registry is a simple RESTful web service, all parameters are provided as URL parameters added to the base URL:

NOTE: At the time of writing this documentation no CDM Community Store has been registered so far. This decision is only in the responsibility of the owner of the data hosted in a Community Store.

CDM Server_overview.png View (49.7 KB) Andreas Kohlbecker, 09/09/2010 11:47 AM

OAI_2.0_Request_Results.png View (152 KB) Andreas Kohlbecker, 09/09/2010 04:37 PM

Add picture from clipboard (Maximum size: 40 MB)