1 / 16

How To: SRU

How To: SRU. Ralph LeVan Senior Research Scientist, OCLC levan@oclc.org WorldCat Hackathon New York Public LIbrary 7 November 2008. The Basics. REST-ful API for Search and Retrieve CQL – A rich, standardized query grammar Self-describing service through Explain records.

harrison-sullivan
Download Presentation

How To: SRU

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. How To: SRU Ralph LeVan Senior Research Scientist, OCLC levan@oclc.org WorldCat Hackathon New York Public LIbrary 7 November 2008

  2. The Basics • REST-ful API for Search and Retrieve • CQL – A rich, standardized query grammar • Self-describing service through Explain records

  3. REST-ful API for Search and Retrieve • Base URL: http://worldcat.org/identities/search/Identities • Querystring: query=local.Name+all+%22ralph+levan%22 • Important Optional Parms: • startRecord • maximumRecords • recordSchema

  4. REST-ful API for Search and Retrieve • Untrustworthy Optional Parms: • sortKeys

  5. REST-ful API for Search and Retrieve • Amusing Parms: • recordPacking

  6. REST-ful API for Search and Retrieve • Omittable Mandatory Parms: • version • operation

  7. CQL • Standard Boolean operations • Search Terms: [Index relation] quotedString • query=dog • query=cql.any exact “moby dick” • Indexes defined by server • Standard relations: • exact, =, all, any

  8. searchRetrieveResponse • <?xml version="1.0" ?> • <?xml-stylesheet type="text/xsl" href="/identities/NameFinderResponse.xsl"?> • <searchRetrieveResponse xmlns="http://www.loc.gov/zing/srw/">

  9. searchRetrieveResponse elements • <version>1.1</version> • <numberOfRecords>3</numberOfRecords> • <resultSetId>6dsxzt</resultSetId> • <resultSetIdleTime>300</resultSetIdleTime> • <records><record></record>...</records> • <echoedSearchRetrieveRequest>... • <diagnostics>... • <extraResponseData>...

  10. record elements • <recordSchema> • info:srw/schema/1/Identities</recordSchema> • <recordPacking>xml</recordPacking> • <recordData>... • <recordPosition>1</recordPosition>

  11. Explain • <explainResponse xmlns="http://www.loc.gov/zing/srw/"> • <version>1.1</version> • <record> • <recordSchema> • http://explain.z3950.org/dtd/2.0/</recordSchema> • <recordPacking>xml</recordPacking> • <SRW:recordData>

  12. Explain Record • <explain authoritative="true" xmlns="http://explain.z3950.org/dtd/2.0/"> • <serverInfo protocol="SRW/U">… • <databaseInfo>… • <indexInfo>… • <schemaInfo>… • <configInfo>…

  13. indexInfo • <set identifier="http://staff.oclc.org/~levan/localContextSets/Identities" name="local"/> • <index> • <title>local.BirthDate</title> • <map> • <name set="local">BirthDate</name> • </map> • <configInfo> • <supports type='relation'>any</supports> • </configInfo> • </index>

  14. schemaInfo • <schema sort="false" retrieve="true" name="Identities" • identifier="info:srw/schema/1/Identities” • location="http://www.oclc.org/standards/Identities/schema/Identities.xsd"> • <title>Identities records in their native format</title> • </schema>

  15. configInfo • <default type="maximumRecords">250</default> • <default type="numberOfRecords">10</default> • <default type="retrieveSchema"> • info:srw/schema/1/Identities</default>

  16. Links • http://www.loc.gov/standards/sru/

More Related