DataCite How To: Use the MDS
-
Upload
frauke-ziedorn -
Category
Government & Nonprofit
-
view
142 -
download
5
description
Transcript of 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