Page Comparison

...

With the retirement of the HOLLIS (AquaBrowser) discovery layer, we introduce a new search API against the HOLLIS+ (Primo) layer that returns bibliographic items in the same relevancy ranking order as the HOLLIS+ UI.

...

...

Individual bibliographic items will be returned in Dublin Core format, with some additional fields. Furthermore, you may additionally request faceting on a variety of axes.

...

URL request syntax

Anchor1000076110000761 The base syntax is: Anchor1000075610000756

http://webservices.lib.harvard.edu/rest/v2/hollisplus/search/dc/?q={query_string}

There are several additional parameters that can be added

...

Parameters

...

Value9000300

query_string

jsonpanchor

callback function name9000312

Primo's ExLibris's Developers'

Parameter
Anchor
9000299	9000299
Anchor
9000300	Description
q
Anchor
10000766	10000766	Your search valuesanchor
	9000310	9000310		9000311	9000311
Anchor
9000312	The name of the callback function to wrap around JSON data.  Example: ?jsonp=ws_results
limit	an integer	The number of items you want returned (default is 30)
facets	a comma-delimited list of facets	"“all"”, or one or more of the supported facet sets (see below). Specifying one or more facets will result in the display of facets across the entire results set.
Additional parameters conforming to			Primo’s API that are currently supported. They are described in fuller detail at			ExLibris’s Developers’ Network Website: https://developers.exlibrisgroup.com/primo/apis/webservices/xservices/search/briefsearch . If you use one or more of these, you do not need to include the q parameter, above:
query	a query formatted in Primo API style	The format is <field>,<precision>,<value>; e.g.: creator,contains,leo+tolstoy or title,exact,war+and+peace See the table below for some common valid values for <field> and <precision>.
query_inc	comma-delimited list of facet values specified against a particular facet set	Allows you to limit your search to those results matching the specified facet values for the specified facet set. The format is: facet_{facet set name},exact,{value1, value2,…}; e.g.: facet_rtype,exact,dissertations,journals gets only those results that are of resource type dissertation or journal.
query_exc	comma-delimited list of facet values specified against a particular facet set	Allows you to limit your search to those results that do not match the specified facet values for the specified facet set; e.g.: facet_genre,exact,scores,historical+re-creations would exclude any results with the genre of "Score" or "Historical “Score” or “Historical re-creation"creation”
sortField	a sort value	One of: 1) stitle - performs Title sort. 2  2) scdate - performs Date sort (reverse chronological order). 3  3) screator - performs Author sort. 4  4) popularity - Performs Popularity sort.  If you do not specify the sortField, the results are ordered by relevance.

...

Some common-used values for <field> in Primo query syntax.

creator	The author of the work
title	Title of the work Note: a title search includes a search of the table of contents (MARC field 505); if you want to exclude those, use swstitle ( "sort title" “sort title”)
sub	Subject of the work
rtype	Resource type
cdate	Creation date (YYYY)
isbn
issn
lsr04	publisher
lsr05	place of publication
lsr06	Fund(bookplate)

There are two useful values for the <precision> in the Primo query syntax:

contains	will return results for any item whose <field> contains at least one of the given terms
exact	will return results for any item whose <field> contains an exact match of the input term

Facet Sets

PRESTO currently supports faceting on several axes; for convenience, some of them are re-named from their Primo titles, which are provided in parentheses

Sample URLs

Anchor1000077410000774 A basic search using the q parameter is equivalent to entering search terms in the HOLLIS+ search box. Use quotation marks for exact string matches.

search for verba, sidney:

Anchor1000077110000771http://webservices.lib.harvard.edu/rest/v2/hollisplus/search/dc/?q= %22verba,+sidney%22 Anchor

1000077310000773 If wanted your search to only contain results where verba, sidney is the creator, you would use the Primo syntax:

http://webservices.lib.harvard.edu/rest/v2/hollisplus/search/dc/?query=creator,contains,verba++sidney

A combination title/author search for old man and the sea and hemingway, ernest 1899-1961:

Anchor1000077210000772http://webservices.lib.harvard.edu/rest/v2/hollisplus/search/dc/?query=title,exact,%22old+man+and+the+sea%22&query=creator,contains,Hemingway Anchor_GoBack_GoBack++Ernest++1899-1961

...

Response

...

The response to a HOLLIS+ search may contain further links for moving to the next set of results, refining the search, etc., as described below. You can limit the number of results that are returned; experientially, the high limit seems to be about 200.

Anchor1000077710000777 Any call to the PRESTO HOLLIS+ Search returns an XML document (or JSON version of it, if requested) with, minimally, the following elements.
anchor1000077810000778

Top level XML

Anchor1000078010000780 For a HOLLIS search, the top level elements in the returned XML look like this:anchor

<results>
1000078910000789<results><totalResults>808</totalResults><startIndex>1</startIndex><itemsPerPage>30</itemsPerPage><resultSet><totalResults>808</totalResults>
<startIndex>1</startIndex>
<itemsPerPage>30</itemsPerPage>
<resultSet>

<!—a set of individual <item/> records -->

</resultSet><pager><resultSet>
<pager><!-- page details here --></pager>

<!—if you have requested faceting -->

<facetSets>

<facetSet><!—the faceting details for this Set -->

</facetSets>

</results>
Anchor1000079010000790

Note that if the number of results is fewer than the limit requested (default: 30), the <pager> element is not present.
anchor1000079610000796

<resultSet><items><item> element details

Anchor1000079710000797 The <resultSet> contains only <item> elements. The <item> element has two attributes:

• id The HOLLIS+ ID

• position (in the list of results)

• rank (NEW) The calculation of ranking for this item within the search results.

The <item> will also enclose many of the elements listed below, as they are available:

• dc:title

• cataloglink

  –

  -- the URL pointing to the Permanent URI of the item

• dc:type (book, archive_manuscript, image, etc.)

• dc:creator (multiple) – the author(s), if known

• dc:contributor (multiple) any additional known contributors to the work

• authorlink – the query string needed to search for all items created by the dc:creator

• dc:subject (multiple)

• dc:description (multiple)

• dc:date – a text field, usually a year.

• dc:publisher

• notes – any public notes associated with the bibliographic item

• dc:identifier (multiple)

  –

  -- the OCLC, ISBN, ISSN number(s) as they are available

• (Images) numberofimages

• (Images) related – text description of what the item is related to

• (Images) restrictions – text restrictions

• (Images) links (multiple) – represented as <a href> elements, links to thumbnail and copyright and permissions

...

<pages> element details

Anchor1000081810000818 If there are more results than requested by the limit parameter (default: 30), the <pager> element will be present, and contain sub elements. Here's an example from a results XML with 29 results when the requested limit was 20:
Anchor1000094210000942

The request URL for the example was:
Anchor1000082110000821

http://webservices.lib.harvard.edu/rest/v2/hollisplus/search/dc/?query=sub,contains,seven+wise+men+of+greece&limit=20

Anchor1000084010000840 <pages>

<currentpage>1</currentpage>

<page querystr="?query=sub,contains,seven+wise+men+of+greece&amp;limit=20&amp;curpage=2">Next</page>

<page querystr="?query=sub,contains,seven+wise+men+of+greece&amp;limit=20&amp;curpage=2">Last</page>

</pages>

Note the querystr attribute of the <page> element; this string would be used to get the results for whichever "page" “page” was next requested. For the case above, to obtain the last item that fulfills the search, the URL would be:
anchor

1000084210000842http://webservices.lib.harvard.edu/rest/v2/hollisplus/search/dc/?query=sub,contains,seven+wise+men+of+greece&limit=20&curpage=2

<facetSets> element details

The <facetSets> element will only be present if you have requested faceting as described above.

The <facetSets> will enclose one or more <facetSet> elements, depending on which facets you have requested.

The <facetSet> element will look as follows: (the URL was: http://webservices.lib.harvard.edu/rest/v2/hollisplus/search/dc/?query=sub,contains,seven+wise+men+of+greece&limit=20&facets=creator

<facetSetType>creator</facetSetType>

<facetsCount>38</facetsCount>

<facet>

<title>Erasmus, Desiderius, -1536</title>

<count>4</count>

<link>?query=sub,contains,seven+wise+men+of+greece&amp;limit=20&amp;curpage=1&amp;query=facet_creator,exact,Erasmus++Desiderius++-1536</link>

</facet>

<facet>

<title>Beroaldo, Filippo, 1453-1505</title>

<count>3</count>

<link>?query=sub,contains,seven+wise+men+of+greece&amp;limit=20&amp;curpage=1&amp;query=facet_creator,exact,Beroaldo++Filippo++1453-1505</link>

</facet>

.

.

.

</facetSet>

...