DataCite How To: Use the MDS
Upcoming SlideShare
Loading in...5
×
 

DataCite How To: Use the MDS

on

  • 54 views

How to use DataCite's Metadata Store (MDS) via UI or API.

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

Statistics

Views

Total Views
54
Views on SlideShare
54
Embed Views
0

Actions

Likes
1
Downloads
1
Comments
0

0 Embeds 0

No embeds

Accessibility

Upload Details

Uploaded via as Microsoft PowerPoint

Usage Rights

CC Attribution-NonCommercial-ShareAlike LicenseCC Attribution-NonCommercial-ShareAlike LicenseCC Attribution-NonCommercial-ShareAlike License

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

DataCite How To: Use the MDS DataCite How To: Use the MDS Presentation Transcript

  • 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  Update many datasets  Upload many metadata files  Retrieve a metadata file „Single” operations – use UI Bulk operations – use API
  • 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 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.
  • Implementation: Register a dataset Use web interface: Result: A DOI will be minted and a record in Metadata Store created.
  • 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 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: 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
  • 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
  • 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
  • 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.
  • 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.
  • 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.
  • 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
  • The DataCite Members