Start here: Ex Libris Product Documentation Managing COUNTER-Compliant Usage Data
Also refer to: COUNTER SUSHI | Project Counter and Section 8.0 SUSHI for Automated Report Harvesting | Project Counter
SUSHI Logins (request access through site)
Additional Guidance | Tips and Tricks for Specific Vendors
Question | Answer |
---|---|
What information do I need to set up a SUSHI account and where do I get it? | It is best to contact the vendor to obtain the credentials that you need to set up a SUSHI account. SUSHI credentials will always include a rest URL. In addition, vendors can use a requestor ID, a customer ID and an API key. Ex Libris provides a SUSHI Vendor Lists and this information is available in Alma too but I recommend verifying the information with the vendor. You also need to know which reports are being provided by the vendor and decide which ones you'd like to harvest. To look up the SUSHI credentials for a vendor in Alma, use the search feature in the SUSHI Account box. |
How many SUSHI accounts do I need to set up for each vendor? | In most cases, only 1 SUSHI account is needed to get COUNTER 5 reports for each vendor but multiple SUSHI accounts are needed for vendors that have different SUSHI credentials for different platforms or different accounts. For COUNTER 4 reports, you need one SUSHI account for each type of report you need to harvest. (You can use the duplicate feature to set up multiple SUSHI accounts for COUNTER 4 reports using the same SUSHI credentials.) |
Do SUSHI account names need to be unique for each report? | I recommend having unique SUSHI account names if you have multiple SUSHI accounts under the same vendor. For COUNTER 4 reports, it is okay if the account names are not unique since each account is set up to collect only 1 type of report. Note that you cannot change the SUSHI account name after you've created and saved the SUSHI account. |
How do I test the SUSHI account that I've just created? | To test the account information for the SUSHI account, use the Test Connection button on the top of the SUSHI Account Details page. To test each report type, use the Test Connection with Response. Note that Test Connection does not test all fields required to SUSHI harvest a report so I recommend using Test Connection with Response on at least one of the reports to fully test your SUSHI credentials. If Alma is not able to establish a connection using the information for the SUSHI account, Alma will display an error message: . If Alma was able to establish a Connection using the account information and get a response back from the server, it will return a json file. Be sure to open the json file and review the content as an error message can be returned within the json file. The list of SUSHI-defined error codes can be found here: Appendix F: Handling Errors and Exceptions | Project Counter (Note that the Test Connection with Response function is not available for COUNTER 4 reports.) |
What happens the first time the SUSHI harvest job runs after I set up an account? | You can have the SUSHI harvesting job run to harvest reports just for a specific SUSHI account by selecting the Harvest Now option for that SUSHI account. In addition, the SUSHI harvesting job can be scheduled to run on a regular schedule for all SUSHI accounts. Refer to Managing COUNTER-Compliant Usage Data for details on how to schedule this job. Whether you choose the "Harvest Now" option or the scheduled job option. the SUSHI harvesting job will try to harvest the most recent 12 months of usage reports that are available when the reports are being harvested for the first time for each SUSHI account. |
Tips and Tricks for Specific Vendors
More information is available in the Ex Libris Knowledge Center
How do I know if there are usage statistics available for a specific resource? | It is best to contact the vendor and ask if they provide any COUNTER reports. To be COUNTER-compliant, vendors need to be providing COUNTER 5 reports but a few may still be providing COUNTER 4 reports. There are also lists that try to show which vendors provide COUNTER 5 reports and whether SUSHI API can be used to harvest those reports but these lists may not have the latest information.
|
How do I set up SUSHI for Elsevier (Science Direct, Scopus, Engineering Village)? | You have to fill out an Elsevier request form before you can use SUSHI:https://www.elsevier.com/__data/assets/word_doc/0003/184791/Elsevier-SUSHI-application-form.docx Send the completed form to Elsevier (click the email link at https://service.elsevier.com/app/home/supporthub/admin-tool/ or https://www.elsevier.com/solutions/sciencedirect/support) Here are the IP addresses you'll need to fill in: The following IPs/IP ranges must be allowed access to/from your institution. (Note that the IP ranges below are in CIDR notation.) Here is further documentation in the Ex Libris Knowledge Center: |
How do I set up SUSHI for Engineering Village if I already did it for ScienceDirect? | Open a support ticket with Elsevier. Let them know you've already set up other services and need to add Engineering Village. They will do the set-up on the back end and give you the correct URL and account number to set up SUSHI harvesting for Alma. Click on the email link at https://service.elsevier.com/app/home/supporthub/admin-tool/ or https://www.elsevier.com/solutions/sciencedirect/support |
How do I set up SUSHI for American Mathematical Society? | Use the following values:
|
How do I set up SUSHI for Silverchair-hosted vendors (e.g. AMA, ASME, Duke, GeoScienceWorld) | Log into the Sitemaster admin page and select the COUNTER reports tab. Scroll to the bottom and click on the "How do I use SUSHI to generate COUNTER reports?" link. Enter your Requestor ID, Customer ID, and password as indicated (note that the password you used to log into Sitemaster goes in the Requester Email field).
|