Update: This post was updated in August 2014 to reflect the new URL for the CUNY Catalog.
Linking to the Aleph OPAC
I don’t know how other institutions do it but, at CUNY, we encourage folks to proxy their OPAC links. This ensures that when a user attempts to view an e-resource, he/she will be able to authenticate himself/herself and gain access to that resource. Otherwise, the user will be stuck behind a paywall.
So what does the URL look like? In its simplest form, it’s just the URL to the OPAC prefixed by the proxy URL:
Of course, this is going just through the central office proxy server (ensuring access only to CUNY-wide e-resources, not campus-specific ones) and doesn’t specify a “local base,” or a library scope, so it defaults to the union (or all CUNY libraries) view. To tailor this link to your specific library, you will need to know your college’s proxy server and your Aleph local base. Then you’ll end up with a link that looks like this:
Using this properly formatted URL, your patrons will be defaulted to their local library search scope and they will be pinged for authentication when they reach a licensed e-resource.
Linking to a specific search
But what about when you want to link to a specific search? For example, a faculty member would like to link to all the library’s holdings of Junot Diaz’s work from her Blackboard course site. How can we help her with this?
It’s not enough to just do a search and then copy & paste the resulting URL. You will be stuck with a unique session ID in that URL that will expire and cause the link to default to the basic search screen. This then leads to confusion and frantic emails. The simplest solution, then, is to take that search result URL…
…and remove the session ID. In the URL above, it’s the gobbledygook (yes, that’s the technical term for it) after the
F/ and before the
?func. So the new, persistent (and proxied!) URL will be:
There are several things to note here:
- This is scoped to Lehman College and goes through their proxy server. If you want to narrow it to your own library (or broaden it to all the CUNY libraries), choose the appropriate Aleph local base and proxy server.
find_scan_codeparameter has the value
FIND_WAU, which means we’re searching for a keyword (that’s the
findpart) in the author field (that’s the
waupart). If you need to perform a different search, you will need to select a different search type (or value for the
FIND_WRD: All Fields
SCAN_TTL: Title begins with
SCAN_AUT: Author, last name first
SCAN_SUL: Subject begins with
FIND_WTI: Keyword in title
FIND_WAU: Keyword in author
FIND_WSU: Keyword in subject
SCAN_SUC: Children’s subject begins with
SCAN_SUM: MeSH subject begins with
SCAN_SHL: Call number
SCAN_ISBN: Browse ISBN
SCAN_ISSN: Browse ISSN
SCAN_SYS: Browse Aleph system number
requestparameter is where you enter your query. Spaces need to be replaced with a plus sign (+). In our example above, notice how the query reads
It is also possible to construct a much more complicated URL:
Here, instead of a
find_scan_code, we’re using a
ccl_term (Common Command Language), which is a way to construct a more complex search in the URL. Furthermore, the query for the 2-letter OWN code (
wow=bb) and keyword in title (
wti=American+directories) used in the
ccl_term parameter in this example includes escape sequences for some of the following characters:
These characters have to be escaped in the
ccl_term parameter. For a list of the CCL terms, see the CUNY Catalog help files.
Embedding a search box
Instructions for embedding a search box to the CUNY Catalog from anywhere (e.g., LibGuides, SerialsSolutons, etc.) are too long to include in this post. However, they are available on the Support @ OLS website.