1. SRU & CQL Ralph LeVan Senior Research Scientist, OCLC levan@oclc.org
Code4Lib Pre-Conference
Brown University
23 February 2009

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:
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="

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=" <version>1.1</version> <record> <recordSchema> <recordPacking>xml</recordPacking> <SRW:recordData>

12. Explain Record
<explain authoritative="true" xmlns=" <serverInfo protocol="SRW/U">… <databaseInfo>… <indexInfo>… <schemaInfo>… <configInfo>…

13. indexInfo
<set identifier=" 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=" <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