datacite how to: use the mds

How to use the DataCite Metadata Store (MDS)

TIB, HannoverFrauke Ziedorn

Use of MDS

Register a dataset Update a dataset Upload metadata file Find my dataset

Register many datasets Update many datasets Upload many metadata files Retrieve a metadata file

„Single” operations – use UI

Bulk operations – use API

Single operations

UI(User Interface)

As a datacentre, I would like to register one of my datasets.I know the URL of the landing page and DOI name I want to assign to the datasets.I also have a valid XML file with the metadata to my dataset according to DataCite's standards.

Story: Register a dataset

Use web interface:

Result: A DOI will be minted and a record in Metadata Store created.

Implementation: Register a dataset

As a datacentre, I registered a dataset and I now want to find it in the Metadata Store.

Story: Find my dataset

or

Implementation: Find my dataset

As a datacentre, I registered my dataset but I now want to change the URL of its landing page.

Story: Update a dataset

Find dataset and edit it:

Implementation: Update a dataset

As a datacentre, I had already registered my dataset and now I want to update the metadata file.

Story: Update metadata file

Implementation: Update metadata file

Bulk operations

API(Application Programming

Interface)

API

• RestFul API• HTTPS with Basic Authentication• Full documentation:

https://mds.datacite.org/static/apidoc

Example API Calls

Upload Metadata:

Mint or Update a DOI:curl -u USER.NAME -d "url=http://example.com" -d "doi=10.01234/foobar" https://mds.datacite.org/doi

curl -u USER.NAME -H "Content-Type: application/xml" --data-binary @metadata.xml https://mds.datacite.org/metadata

remember setting appropriate headers: Accept=application/xml Content-Type=application/xml

Pay attention to the response codes – they mean what they say! Additional message can be included in the

response body e.g. Response code: 403 Forbidden response body: user quota exceeded

Little things matter

DOI names

• Prefix is defined by DataCite• Suffix is defined by data center• Opaque string• Characters for a DOI name:

A – Za – z0 – 9: (colon). (full-stop)- (hyphen)_ (underscore)/ (slash)

No umlauts or special characters!http://www.tib-hannover.de/fileadmin/informationsmaterial/flyer/TIB_DOI_Service_DOKU_ENG.pdf

• You may only use prefixes and domains assigned to your account.

• It may be that you have a DOI quota. Once this is fulfilled you cannot register any more DOIs.

Restrictions

• The Handle System – the technical infrastructure for DOIs – is a distributed network system.

• Newly minted DOIs should be resolvable after about 5 minutes.

• Updates to DOIs can take up to 24 hours before being distributed through the whole Handle system.

It’s distributed – be aware of latency!

Persistency:You cannot delete DOIs!

• A DOI is a persistent identifier so removing it would go against the idea.

•It’s still possible to deaccesses a dataset, but this should be noted on the DOI‘s landing page.

• A DOI should always resolve to a landing page where metadata and information on how to access the dataset are given.

DataCite has a whole test environment where all services can be tested:http://test.datacite.org

Resolver for test DOIs: http://dx.test.datacite.org

Test Environment

The DataCite Members