Search verb notes from May 23-24 meeting.
Verb Description:Specifies a search request to the index server. Keyword Arguments are a set of bibliographic fields and values specifying the search criteria. Returns a structured response that is a list of each document that matches the search criteria.
RequestsValid bibliographic field arguments can vary among index servers. The Describe-Verb verb returns the set of field arguments for a particular server. The minimal and standard set of bibliographic field arguments is as follows:
- docstruct[n] ( opt -- default=maindocument )
Must enumerate, beginning with 1. Legal parameter values:
- maindocument (req)
- page (req)
- chapter(opt)
- paragraph (opt)
- table of contents (opt)
- appendix (opt)
- table (opt)
- illustration (opt)
- article (opt)
- other (opt)
- field[n] ( req )
Must enumerate, beginning with 1. Legal parameter values:
- title (req)
- itemno (opt)
- author (req)
- pubtype (req, indicates whether monograph or serial))
- subject (opt)
- language (req)
- fullbib (req)
- abstract (opt)
- pubdate (req)
- publisher (req)
- fulltext
- value[n] ( req )
Must enumerate, beginning with 1.- op[n] ( req if applicable )
Must enumerate, beginning with 1. Legal parameter values:
- and (req)
- or (req)
- not (opt)
- within (opt)
- including (opt)
- relop[n] ( opt, requires use of op )
Must enumerate, beginning with 1??? Legal parameter values:
- same (req)
- child (req)
- parent (opt)
- authority ( optional )
The name of the authority in the index server to which the search is to be limited. The default is all authorities. The authority argument may be repeated, in which case the the search is carried out in each authority (effectively or'ing the authority arguments).- added-after ( optional )
Limits the list to those handles for documents that were added or modified since time, a universal time expressed in ISO 8601 format. If the server is not able to determine date of modification to the resolution of a day, or if the server is not able to selectively extract records on a time scale of a day, the server may return additional records, e.g. all those modified during the week, month, or even century containing the date.Operator Precedence: queries are assumed to be submitted using Reverse Polish Notation (RPN)
Rules for bibliographic field matching: A token in a field is either an unquoted word or a quoted string. Tokens are matched to bibliographic entries according to the following rules:
Responses
- Words or phrases are matched exactly as submitted; the wild card symbol * should be used to indicate truncation.
Note that clients should not assume any logical ordering of the records returned.
- handle ( required )
the doc handle- rank ( required )
Relevance data in any form. Should be made as meaningful as possible.- author ( required if available )
Repeatable. Each author is in last, first middle format.- title ( required )
- date ( required )
The date of publication of the document in ISO 8601 format. The exact meaning of the term "date of publication" is determined by the administrator of the index service. It is included in the record that is returned so that user interface services may use the date for ordering of a result set.
Example Request:Protocol=Dienst&Service=Index&ver=6.0&verb=Search&field1=author&value1=davis&op1=or&field2=author&value2=fox
Example Request:Protocol=Dienst&Service=Index&ver=6.0&verb=Search&field1=author&value1=donald&op1=and&field2=title&value2=robot
Example Request:Protocol=Dienst&Service=Index&ver=6.0&verb=Search&field1=author&value1=donald&op1=or&field2=title&value2=computer+vision&op2=and&field3=authority&value3=xxx
Example Response:
<?xml version="1.0" encoding="UTF-8"?>
<Search version="1.0">
<record>
<handle>handlecorp/1112</handle>
<rank>2857</rank>
<author>Doe, J.</author>
<author>Public, J. Q.</author>
<title>Answering Queries</title>
<date>19941106</date>
</record>
<record>
<handle>handlecorp/1110</handle>
<rank>2859</rank>
<author>Mouse, M.</author>
<author>Disney, W.</author>
<title>Success with Cartoons</title>
<date>19941106</date>
</record>
</SearchBoolean>