Deep Links to Polaris PowerPAC and Mobile PAC
Deep links allow searches for specific bibliographic records in your PAC from external sites. Such searches are launched, for example, when you use the PAC look-up feature on the sites of book and material vendors. This section lists the PowerPAC and Mobile PAC URLs for setting up links to specific bibliographic records in your PAC from an external site.
PowerPAC
All URLs should be prefixed with your site-specific base URL (example:
mylibrary.com/polaris/). The URL is necessary for each link parameter.
ISBN
view.aspx?isbn={isbn},{isbn}, …
Examples - Single and multiple ISBNs, any branch:
http://mylibrary.com/polaris/view.aspx?isbn=1234567890
http://mylibrary.com/polaris/view.aspx?isbn=1234567890,2222333344,987698765X
Important: To limit by branch, you must use searchresults.aspx instead of view.aspx. Be aware of the following points:
- Searchresults.aspx is subject to change as Polaris PowerPAC changes. You may need to change your link format accordingly. (View.aspx is stable from release to release.)
- You must have already set up a custom “limit by” for assigned branch in Polaris Administration. For instructions, see Setting Up Search Filters (Limit By).
Example - Branch-specific and limited to titles with linked items at that branch
http://mylibrary.com/polaris/search/searchresults.aspx?ctx=17.1033.0.0.1&type=keyword&by=ISBN&term=0375750126&limit=AB=17&page=0
Where 17 is the branch’s organization ID in Polaris. You can use the same format with other link parameters.
LCCN
view.aspx?lccn={lccn},{lccn}, …
Examples:
http://mylibrary.com/polaris/view.aspx?lccn=2001627090
http://mylibrary.com/polaris/view.aspx?lccn=2001627090,2001336783,85153773
Control Number
view.aspx?cn={control_number},{control_number}, …
Examples:
http://mylibrary.com/polaris/view.aspx?cn=13243
http://mylibrary.com/polaris/view.aspx?cn=13243,9999,24354,348
See also Limited Control Number.
Keyword
view.aspx?keyword={url_encoded_keywords}
Examples:
http://mylibrary.com/polaris/view.aspx?keyword=cars
http://mylibrary.com/polaris/view.aspx?keyword=science+fiction+robots
Title
view.aspx?title={url_encoded_title}
Examples:
http://mylibrary.com/polaris/view.aspx?title=Misery
http://mylibrary.com/polaris/view.aspx?title=Punishment+Crime
Title searches are keyword searches, and hits are returned regardless of the word order in the tag. If you want the title search to return only hits that match the order in the tag, you can have your vendor add a type=phrase query string parameter to the vendor’s template.
Example (type=phrase):
http://mylibrary.com/polaris/view.aspx?title=Crime+and+Punishment&type=phrase
Author
view.aspx?author={url_encoded_author}
Examples:
http://mylibrary.com/polaris/view.aspx?author=Shakespeare
http://mylibrary.com/polaris/view.aspx?author=John+Grisham
Author searches are keyword searches to ensure that hits are returned whether the name order is first, last or last, first. If you want the author search to return only hits that match the order in the tag, you can have your vendor add a type=phrase query string parameter to the vendor’s template.
Example (type=phrase):
http://mylibrary.com/polaris/view.aspx?author=Grisham+John&type=phrase
Subject
view.aspx?subject={url_encoded_subject}
Examples:
http://mylibrary.com/polaris/view.aspx?subject=dogs
http://mylibrary.com/polaris/view.aspx?subject=History+Civil+War
Subject searches are keyword searches, and hits are returned regardless of the word order in the tag. If you want the subject search to return only hits that match the order in the tag, you can have your vendor add a type=phrase query string parameter to the vendor’s template.
Example (type=phrase):
http://mylibrary.com/polaris/view.aspx?subject=Civil+War+History&type=phrase
Series
Example:
http://mylibrary.com/polaris/view.aspx?series=lonely+planet
Combination: Author, Title, Subject
You can combine Author, Title, and/or Subject parameters in the same query.
Examples:
http://mylibrary.com/polaris/view.aspx?author=King&title=Misery
http://mylibrary.com/polaris/view.aspx?title=Harry+Potter&subject=wizard+schools
http://mylibrary.com/polaris/view.aspx?subject=cabin+building&author=Thoreau
UPC
view.aspx?upc={upc_code},{upc_code}, …
Examples:
http://mylibrary.com/polaris/view.aspx?upc=287986736748
http://mylibrary.com/polaris/view.aspx?upc=289839472834,771826736475,112989783678
OCLC
view.aspx?oclc={oclc_number},{oclc_number}, …
Examples:
http://mylibrary.com/polaris/view.aspx?oclc=ocm12384675
http://mylibrary.com/polaris/view.aspx?oclc=ocm768375267,ocm38916725,ocm11286756
Record Sets (Bibliographic)
See Create a URL Link to a Record Set in the PAC.
E-Source Targets
See Create links to e-sources on external sites.
Limited Control Number
Polaris PowerPAC’s full bibliographic product page (title.aspx) also supports a deep link by control number for local titles. This limited-function deep link was added to improve link sharing on social web sites that the PowerPAC deep link format for view.aspx (see Control Number) did not support as well. The deep link for title.aspx supports a control number parameter (cn={control-number}) which, if present, searches for and goes directly to the PAC product page for the single, local bibliographic title with that control number.
{pac-root-url}/search/title.aspx?&ctx={ctx-value}&pos=1&cn={control-number}
Examples:
- Any branch or language (no ctx parameter):
http://mylibrary.com/polaris/search/title.aspx?&pos=1&cn=12345
- Branch organization ID is 83 (ctx=83):
http://mylibrary.com/polaris/search/title.aspx?ctx=83&pos=1&cn=12345
- Branch organization ID is 83, language is English (ctx=83.1033):
http://mylibrary.com/polaris/search/title.aspx?ctx=83.1033&pos=1&cn=12345
Mobile PAC
All URLs should be prefixed with your site-specific mobile base URL (example: mylibrary.com/mobile/). The URL is necessary for each link parameter:
{Base Mobile PAC URL}/view.aspx?{TYPE}={TERM}
Because Mobile PAC does not currently support Boolean searching, only single terms are allowed. The following access points {TYPE} are available:
- ISBN
- LCCN
- CN - Control number
- ISSN
- Title
- Author
- Subject
- Series
- Keyword
- brs - Record set ID
- brsn - Record set name
In general, if a mobile device goes to a PowerPAC deep link and Mobile PAC supports the search criteria specified in the URL, the mobile device user is automatically directed to the Mobile PAC search results page. If Mobile PAC does not support the search criteria, the mobile device user is directed to the PowerPAC search results page.
However, if type=phrase is part of the PowerPAC deep link, the user is directed to the Mobile PAC search results page. Also, the user is directed to the Mobile PAC search results page when there are multiple terms for author, title, or subject in the PowerPAC deep link.
Examples:
http://mylibrary.com/polaris/view.aspx?title=time+to+kill&type=phrase
http://mylibrary.com/polaris/view.aspx?title=time+to+kill&author=grisham+john
Note:
Although the user is directed to the Mobile PAC search results page in these cases, if the user then clicks the Search bread crumb in the Mobile PAC page header, the search form does not support the deep link search terms due to their complexity.