...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
| Reviewed and Revised by ERM Committee |
|---|
| Table of Contents | In-Depth Articles | ||
|---|---|---|---|
|
|
General Electronic Services (GES) provide a variety of options to end-users in the Primo online services (aka "View It") menu. Most notable is ILLiad, but other common GES include "report a problem" forms, Google Scholar searches, ERIC searches, and ProQuest dissertation searches.
The initial display conditions of a GES are controlled its Service Details and Service Availability Rules. Display conditions may additionally be dependent upon your Display Logic Rules.
Step-by-step guide
You must have System Administrator or Fulfillment Administrator privileges to complete this process.
...
- Go to the GES's Service Availability Rules tab.
- The Default Rule, at the bottom of the page, is always IsDisplay=False
- For a GES that needs no other display conditions, just edit the default rule. Click the ellipsis icon next to the rule and choose Edit.
- Under Output Parameters, change IsDisplay to True, then Save.
- On the SAR tab, click Save. Your rule is now being applied.
Important points
- There is a limit of 25 total resources (including full-text databases and GES) on the "View It" menu.
- Order of the GES list here does not matter. Order is controlled under Configuration > Fulfillment > General Electronic Services Order
- Order of SARs does matter; rules listed first are applied first.
Understanding Service Availability Rules
The Default Rule, at the bottom of every new SAR tab, will always be IsDisplay=False
- For a simple GES that you want to display all the time, simply change the default rule to IsDisplay=True.
- A GES that should display based upon specific criteria will require at least one additional SAR.
- If you leave the default rule set to IsDisplay=False, then most of your additional rules will have the condition IsDisplay=True.
- Another way to say this: Never display this service unless X condition is present.
- If you change the default rule to IsDisplay=True, then most of your additional rules will have the condition IsDisplay=False.
- Another way to say this: Always display this service except when X condition is present.
- If you leave the default rule set to IsDisplay=False, then most of your additional rules will have the condition IsDisplay=True.
- Because the order of SARs matters, put the rule that will apply most broadly at the top of the list. The system will read rules until it finds one that applies, then stop.
...
- You can deactivate a rule without deleting it by toggling its Enabled button to off.
Creating a SAR
- On the SAR tab, click Add Rule.
- Give the SAR a Name. The Description is optional.
Because the conditions of an individual rule do not display on the SAR tab's rule list, it will make your life easier later to put the rule criteria into either the Name or the Description, as shown here:
- Click Add Parameter
- Name is the list of data fields.
- Operator is the condition (contains, is empty, is not empty, equals, does not equal, etc.)
- Value is what appears in the data field you chose.
- Click Add Parameter
- You may add multiple parameters; they will be treated as an AND operation (i.e., both parameters must be true for the rule to apply).
- Make sure IsDisplay is set as you prefer; True will be the default.
- Click Save.
- NB when you are testing new rules: You must click Save on the SAR tab to make the rule live.
Tip for selecting fields and values to use in your parameters
...
- In Chrome, right-click in the background area of the Viewit or GetIt menu (it's an iframe)
- Select View Frame Source
- Remove view-source: from before "http" in the URL field
- Jump to the end of the URL, find svc_dat=getit and change it to svc_dat=CTO
- Press Enter. An XML page displays with the OpenURL elements for this record.
The PNX bookmarklet and, in the case of the link resolver, the openURL, may also be helpful for inspecting records.
Use Case: ILLiad
Theoretically, one your could have a single GES for ILLiad, but there is good reason to divide ILLiad into at least two, articles and books. Primarily, ILLiad's parsing limitations mean that you should not include ISBN and ISSN in the same URL Template. Splitting into two GES also allows you to present more specific information or instructions to the user about the different types of material.
More than two ILLiad services are possible; however, you would need to carefully tailor the conditions for their availability via SARs.
ILLiad Articles
My library uses EZproxy (locally hosted) to authenticate users of ILLiad (hosted with OCLC), so our URL Template is our proxy prefix, followed by our ILLiad base address, followed by:
...
Currently, we have only one SAR:
If rft.genre=article, display=true
(Default is display=false)
ILLiad Books
The URL Template is slightly different from the one for articles:
?Action=10&Form=30&rft.genre={rft.genre}&rft.title={rft.btitle}&rft.stitle={rft.stitle}&rft.atitle={rft.atitle}&rft.date={rft.pubdate}&rft.month={rft.month}&rft.volume={rft.volume}&rft.issue={rft.issue}&rft.number={rft.number}&rft.epage={rft.epage}&rft.spage={rft.spage}&rft.edition={rft.edition}&rft.isbn={rft.isbn}&rft.eisbn={rft.eisbn}&rft.au={rft.aulast},{rft.aufirst}&rft.auinit={rft.auinit}&rft.pub={rft.pub}&rft.publisher={rft.publisher}&rft.place={rft.place}&rft.doi={rft.doi}&rfe_dat={rft.oclcnum}&rfr_id={rfr_id}
Several SARs apply:
The first rule is display=false, so that any results coming from our systemwide shared library catalog will automatically be excluded.
The next rules are display=true. So if a result is from somewhere other than our shared catalog, and it is a book or book chapter, the ILLiad book option will appear.
We also use a Display Logic rule to hide the ILLiad Books GES if our systemwide Resource Sharing option is present.
Use Case: Report a Problem
SFX had a built-in "report a problem" form, but in Alma you must build your own. Once you have a form, you can link to it via a GES.
...
This GES has only one SAR, IsDisplay=True.
Use Case: Google Scholar Search
Grabs the article title and plugs it into a Google Scholar search. This is handy for locating articles that may be available free via Institutional Repositories or are otherwise open access.
URL Template is:
https://scholar.google.com/scholar?as_q=%22{rft.atitle}%22&ie=utf8&oe=utf8
Display location can be just Viewit, or Viewit & Getit. If using the "both" option, you may wish to Disable service: When Resource is owned by institution
This GES has only one SAR, IsDisplay=True.
Use Case: ProQuest Dissertations Search
Grabs the dissertation title and plugs it into a search of the ProQuest Dissertations database(s). Since all CSUs have subscription access to at least one of the ProQuest disssertions products (Humanities & Social Sciences), make sure to proxy the URL so your off-campus users can get to the full text.
URL Template is:
(your proxy prefix here)http://gateway.proquest.com/openurl?res_dat=xri%3Apqm&title={rft.btitle}&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Adissertation&url_ver=Z39.88-2004&genre=dissertation
This GES requires some SARs so that it will display only on records for dissertations.
We use Display Logic rules to My library uses a second Dissertations GES for dissertation references coming to the link resolver the PsycINFO and MLA databases. The SARs address conditions specifc to only those sources:
We use Display Logic rules to hide other service options, such as ILLiad, when the ProQuest a Dissertations GES is present.
Use Case: ERIC Documents Search
Our blended EBSCOhost results include results from ERIC. Many recent ERIC Documents are available free, so we wanted to offer an ERIC search rather than an ILLiad form.
...
This GES requires some SARs so that it will display only for ERIC Document records. Notice that rule one has two conditions:
Use Case: Hide Resource Sharing (CSU+) on the Link Resolver Services Menu
Please see Sarina Sinick's original wiki post, Hiding the CSU+ link on your Primo Services page, option 2.
What follows is a condensed version:
FIrst, create a placeholder GES that appears only in the link resolver.
- Give it a descriptive name, e.g. Hide CSU+
- Put any fake URL into the URL Template field; display it everywhere, disable service never.
- Change the default SAR to display=true, then create one additional SAR:
If rfr_id contains primo.exlibrisgroup.com-01CALS_ALMA, display=false
The CALS_ALMA SAR should prevent your placeholder from appearing on the services menu for results from PCI or the CSU shared catalog. In other words, the Hide CSU+ GES should appear only in the link resolver. Test to verify before proceeding!
Then, create two Display Logic Rules, as follows:
Hide service Resource Sharing Request with Resource Sharing System = Alma if exists service General Electronic Service with Service = Hide CSU+
Hide service General Electronic Service with Service = Hide CSU+
The rules must go in this order! The first rule prevents resource sharing from showin up on any page where our placeholder GES appears.The second rule then hides the placeholder, so it won't confuse your users.
| Info |
|---|
Related articles
| Filter by label (Content by label) | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...