CrossRef How-to: A Technical Introduction to the Basics of CrossRef, Chuck Koscher

CrossRef Technical Basics Chuck Koscher, Director of Technology

Agenda
This presentation will not cover:
CrossRef membership basics (obligations)
Costs or fees
We assume:
Understanding of web linking
XML and metadata awareness
This presentation will cover:
Technical details regarding CrossRef transactions
Introduce XML specifics as they relate to CrossRef
Resources available for your use

‘ The’ DOI Resolver Publisher’s Prefix
Deposit article meta-data to CrossRef with the DOI & URL
Query CrossRef to get a DOI using an article’s meta-data
Present the referring article to the user with reference links active as DOIs
The user clicks on a link
Their browser sends the link to the DOI Resolver
The Resolver finds the URL and re-directs the user to the target document
HTTP://dx.doi.org/10.1016/S0040-4039(01)80789-9 DOI suffix Review: How a DOI works Publisher of the target entity 1 Publisher of the referring entity 2 User 3 Referrer Source 4 Referent 5 6 Service Target

Flow of transactions Joins CrossRef and receives prefix 10.1234 Designs suffix scheme Publishes Article A Build XML for deposit Sends XML to CrossRef Extract references From the article Query CrossRef to get DOIs for the bibliography Build links into on-line article A (link out) Construct an appropriate landing page Deposit Query Query CrossRef to get DOIs for cited-by article A Query Build ‘who cites this article list into on-line article A (link out) Receive a cited-by alert for article A email Update ‘who cites this article list into on-line article A (link out)

<?xml version="1.0" encoding="UTF-8"?> … <timestamp>200706181120</timestamp> … <journal> <journal_metadata> <full_title>Test Publication</full_title> <abbrev_title>T27P</abbrev_title> <issn media_type='print'>99999999</issn> </journal_metadata> <journal_issue> <publication_date media_type='print'> <month>5</month> <day>5</day> <year>2001</year> </publication_date> <journal_volume> <volume>33</volume> </journal_volume> <issue>1</issue> </journal_issue> <journal_article publication_type='full_text'> <titles> <title>Article Apr 16, 2007 11:51</title></titles> <contributors> <person_name sequence='first' contributor_role='author'> <given_name>Chuck</given_name> <surname>Koscher</surname> </person_name> <publication_date media_type='print'> <month>5</month> <day>9</day> <year>1995</year> </publication_date> <pages> <first_page>100</first_page><last_page>200</last_page> </pages> <doi_data> <doi>10.50505/test_200704082300</doi> <resource>http://www.crossref.org/</resource> </doi_data> <component_list> <component parent_relation="isPartOf"> <description>Some component DOI</description> <doi_data> <doi>10.50505/test_200611161118</doi> <resource>http://www.crossref.org/</resource> </doi_data> </component> </component_list> 1 2 3 4 CrossRef XML

Deposit a list of references in an article - Its just some additional XML <citation_list> <citation key="10.1002/sat.744-BIB1"> <journal_title>Microwave Journal</journal_title> <author>Steyskal</author> <volume>30</volume> <first_page>107</first_page> <cYear>1987</cYear> </citation> <citation key="10.1002/sat.744-BIB2“> <volume_title>Wideband CDMA for Third Generation Mobile Communications</volume_title> <author>Ojanperä</author> <cYear>1998</cYear> <unstructured_citation>(eds). Wideband CDMA for Third Generation Mo…. </unstructured_citation> </citation> <citation key="10.1002/sat.744-BIB3"> <journal_title>IEEE Transactions on Acoustics, Speech, and Signal Processing</journal_title> <author>Treichler</author> <volume>31</volume> <first_page>459</first_page> <cYear>1983</cYear> </citation> <citation key="10.1002/sat.744-BIB4"> <volume_title>Signal Detection in Non Gaussian Noise</volume_title> <author>Kassam</author> <cYear>1988</cYear> <unstructured_citation>Signal Detection in Non Gaussian Noise. Springer: New York, 1… </citation> </citation_list>

Where to perform transactions
95+% of the activity is by automated systems that ‘talk’ to CrossRef sending XML data using simple Web operations.
http://doi.crossref.org => production system (deposit & query)
http://test.crossref.org => a ‘sandbox’ for experiments
www.crossref.org/openurl => OpenURL host (queries only)
http://oai.crossref.org/OAIHandler => metadata harvesting
Interfaces for people are available to perform low volume transactions or to do testing.
http://doi.crossref.org
http://www.crossref.org

How do I send in this XML? - Use the upload form at http://doi.crossref.org

Automating the process to send this XML - Write a program to do it for you automatically .
Documentation
http://www.crossref.org/help
http://doi.crossref.org/doc/userdoc.html
Sample Java
http://www.crossref.org/08downloads/doUpload.java
http://doi.crossref.org/doc/samples.zip

What if I don’t program and don’t know XML? - Use http://www.crossref.org/webDeposit/

What if I have articles in NLM based XML? - Use http://www.crossref.org/webDeposit/

People view: Obtain a DOI when you have the metadata - Use the guest query form at http://www.crossref.org/guestquery

People view: Query for a DOI when you have the metadata - Use a form at http://doi.crossref.org Piped query XML query

Write a program to do it for you automatically
HTTP Post or Get
http://doi.crossref.org/servlet/query?usr=<USR>&pwd=<PWD>&qdata= |%20Natl%20Acad.%20Sci.%20USA|Zhou|94|24|13215|1997||| %0A |J.%20Mol.%20Biol.|Hagerman|260|||1996||| POST /servlet/query?usr=creftest&pwd=c53test&format=unixref HTTP/1.1 Host: doi.crossref.org Connection: Keep-Alive, TE TE: trailers, deflate, gzip, compress User-Agent: RPT-HTTPClient/0.3-3 Accept-Encoding: deflate, gzip, x-gzip, compress, x-compress Content-type: application/x-www-form-urlencoded Content-length: 560 ==== Body 560 bytes Body => usr=<USR> Body => &pwd=<PWD> Body => &qdata=%3C%3Fxml+version+%3D+%221.0%22+encoding%3D%22UTF-8%22%3F%3E%3Cquery_batch+version%3D%222.0%22 ns+%3D+%22http%3A%2F%2Fwww.crossref.org%2Fqschema%2F2.0%22+xmlns%3Axsi%3D%22http%3A%2F%2Fwww.w3.org%2F2001%2FXMLSchema-instance% E%3Chead%3E%3Cemail_address%3Eckoscher%40crossref.org%3C%2Femail_address%3E%3Cdoi_batch_id%3Ew001%3C%2Fdoi_batch_id%3E%3C%2Fhead 3Cbody%3E%3Cquery+key%3D%22555-555%22+expanded-results%3D%22true%22%3E%3Cdoi%3E10.1103%2FPhysRevD.7.2467%3C%2Fdoi%3E+%3C%2Fquery 3C%2Fbody%3E%3C%2Fquery_batch%3E%0A ==== XML Get Post Machine view: Query for a DOI when you have the metadata

People view: Obtain a DOI when you have the metadata (OpenURL) http://www.crossref.org/openurl ? aulast=Maas+LRM &title=JOURNAL+OF+PHYSICAL+OCEANOGRAPHY &volume=32 &issue=3 &spage=870 &date=2002 &pid=username:password

Machine view: Obtain a DOI when you have the metadata
Use our OpenURL resolver
HTTP://www.crossref.org/openurl http://www.crossref.org/openurl?aulast=Maas+LRM &title=JOURNAL+OF+PHYSICAL+OCEANOGRAPHY &volume=32&issue=3&spage=870&date=2002
You must register in order to use this account
http://www.crossref.org/requestaccount/
add “pid=username:password”
or “pid=some@registered_email”
to the OpenURL

People view: Query to obtain metadata using a DOI - Use the form at http://doi.crossref.org

http://www.crossref.org/openurl? id=doi:10.1103/PhysRev.47.777 &pid=username:password &noredirect=true Machine view: Query to obtain metadata using a DOI
Use our OpenURL resolver
HTTP://www.crossref.org/openurl

People view: Query to obtain metadata using a DOI

People view: Obtain a DOI when you have the reference text
Use the simple text query form at
http://www.crossref.org/SimpleTextQuery

People view: Obtain a DOI when you have the reference text If you are the publisher, submit these as references!

Machine view: Obtain a DOI when you have the reference text None (not yet anyway)

Machine view: Query to obtain forward links
Its just another type of XML query
<?xml version = "1.0" encoding="UTF-8"?> <query_batch version="2.0" xmlns = "http://www.crossref.org/qschema/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.crossref.org/qschema/2.0 http://www.crossref.org/qschema/crossref_query_input2.0.xsd"> <head> <email_address>ckoscher@crossref.org</email_address> <doi_batch_id>fl_001</doi_batch_id> </head> <body> <fl_query alert="false">   <doi>10.1097/00001622-200101000-00005</doi> </fl_query> </body> </query_batch>

<forward_link doi="10.1097/00001622-200101000-00005"> <journal_cite> <issn>12345678</issn> <journal_title>Test Publication</journal_title> <article_title>Article Mar 2, 2004 10:38</article_title> <first_page>S125</first_page> <year>1999</year> <publication_type>full_text</publication_type> <doi>10.5555/small_md_0001</doi> </journal_cite> <msg>Forward linking query alerts enabled in CrossRef</msg> </forward_link> <forward_link doi="10.1097/00001622-200101000-00005"> <journal_cite> <issn>12345678</issn> <journal_title>Test Publication</journal_title> <article_title>Article Mar 2, 2004 10:38</article_title> <contributors> <contributor first-author="true"> <given_name>Tom</given_name> <surname>Jo nes</surname> </contributor> </contributors> <volume>12</volume> <issue>1é</issue> <first_page>S125</first_page> <year>1999</year> <publication_type>full_text</publication_type> <doi>10.5555/char_test_001</doi> </journal_cite> <msg>Forward linking query alerts enabled in CrossRef</msg> </forward_link> </body> </query_result> </crossref_result>

Machine view: Obtain lots of metadata all at one time
Use our OAI interface
http://oai.crossref.org/OAIHandler/?verb=ListRecords &from=2009-04-20 &until=2009-05-01 &set=10.1007:2661 &metadataPrefix=cr_unixml

www.crossref.org/help

CrossRef How-to: A Technical Introduction to the Basics of CrossRef, Chuck Koscher

by CrossRef on Aug 17, 2009

Accessibility

Categories

Tags

Upload Details

Usage Rights

3 Embeds 23

Statistics

CrossRef How-to: A Technical Introduction to the Basics of CrossRef, Chuck Koscher — Presentation Transcript

http://www.slideshare.net	19
http://www.crossref.org	3
http://www.health.medicbd.com	1