Your SlideShare is downloading. ×
0
How to use the DataCite Metadata 
Store (MDS) 
TIB, Hannover 
Frauke Ziedorn
Use of MDS 
 Register a dataset 
 Update a dataset 
 Upload metadata file 
 Find my dataset 
 Register many datasets ...
Single operations 
UI 
(User Interface)
Story: Register a dataset 
As a datacentre, I would like to register one of my 
datasets. 
I know the URL of the landing p...
Implementation: Register a dataset 
Use web interface: 
Result: A DOI will be minted and a record in Metadata Store create...
Story: Find my dataset 
As a datacentre, I registered a dataset and I now want to 
find it in the Metadata Store.
Implementation: Find my dataset 
or
Story: Update a dataset 
As a datacentre, I registered my dataset but I now want to 
change the URL of its landing page.
Implementation: Update a dataset 
Find dataset and edit it:
Story: Update metadata file 
As a datacentre, I had already registered my dataset and 
now I want to update the metadata f...
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: 
curl -u USER.NAME 
-H "Content-Type: application/xml" 
--data-binary @metadata.xml 
h...
Little things matter 
 remember setting appropriate headers: 
 Accept=application/xml 
 Content-Type=application/xml 
...
DOI names 
• Prefix is defined by DataCite 
• Suffix is defined by data center 
• Opaque string 
• Characters for a DOI na...
Restrictions 
• You may only use prefixes and domains assigned to 
your account. 
• It may be that you have a DOI quota. O...
It’s distributed – be aware of latency! 
• The Handle System – the technical infrastructure for 
DOIs – is a distributed n...
Persistency: 
You cannot delete DOIs! 
• A DOI is a persistent identifier so removing it 
would go against the idea. 
•It’...
Test Environment 
DataCite has a whole test environment where all 
services can be tested: 
http://test.datacite.org 
Reso...
The DataCite Members
Upcoming SlideShare
Loading in...5
×

DataCite How To: Use the MDS

244

Published on

How to use DataCite's Metadata Store (MDS) via UI or API.
With lots of screenshots for easy understanding.

Published in: Government & Nonprofit
0 Comments
1 Like
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total Views
244
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
3
Comments
0
Likes
1
Embeds 0
No embeds

No notes for slide

Transcript of "DataCite How To: Use the MDS"

  1. 1. How to use the DataCite Metadata Store (MDS) TIB, Hannover Frauke Ziedorn
  2. 2. 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
  3. 3. Single operations UI (User Interface)
  4. 4. Story: Register a dataset 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.
  5. 5. Implementation: Register a dataset Use web interface: Result: A DOI will be minted and a record in Metadata Store created.
  6. 6. Story: Find my dataset As a datacentre, I registered a dataset and I now want to find it in the Metadata Store.
  7. 7. Implementation: Find my dataset or
  8. 8. Story: Update a dataset As a datacentre, I registered my dataset but I now want to change the URL of its landing page.
  9. 9. Implementation: Update a dataset Find dataset and edit it:
  10. 10. Story: Update metadata file As a datacentre, I had already registered my dataset and now I want to update the metadata file.
  11. 11. Implementation: Update metadata file
  12. 12. Bulk operations API (Application Programming Interface)
  13. 13. API • RestFul API • HTTPS with Basic Authentication • Full documentation: https://mds.datacite.org/static/apidoc
  14. 14. Example API Calls Upload Metadata: curl -u USER.NAME -H "Content-Type: application/xml" --data-binary @metadata.xml https://mds.datacite.org/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
  15. 15. Little things matter  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
  16. 16. DOI names • Prefix is defined by DataCite • Suffix is defined by data center • Opaque string • Characters for a DOI name: A – Z a – z 0 – 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
  17. 17. Restrictions • 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.
  18. 18. It’s distributed – be aware of latency! • 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.
  19. 19. 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.
  20. 20. Test Environment 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
  21. 21. The DataCite Members
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×