Setting up SUSHI Harvesting in Alma

Staff require at least the first three roles for the majority of work setting up SUSHI. The General System Administrator role tasks are minimal and can be accomplished by someone with that role at an institution if the staff member in charge of SUSHI set up does not have that role.

• Acquisitions Administrator - Configure COUNTER subscribers and activate, deactivate, or manually run the automatic harvesting job.
• Vendor Manager - View usage data related to a particular vendor, manually harvest data for the vendor, manually upload data for the vendor, and manage any uploaded data files.
• Usage Data Operator - Manually upload or delete data for any vendor, manage the uploaded data files, and view missing COUNTER data.
• General System Administrator - Activate, deactivate, schedule, or monitor the automatic harvesting job, view the job's history, report, and events, and configure email notifications for the job.

Typically an institution needs one SUSHI subscriber.

Set this up in Configuration Menu > Acquisitions > General > Subscribers​​​

1. Click Add Row. 
   • 
2. Enter Code (Select your institutions 3-letter I-Share Code, or some other code of your choosing).
3. Enter a Description.
4. Leave Default Value Yes.
5. Click Add Row.
6. Once the subscriber Code is added, it will be listed in the Code Table.
   • 
7. Click Save.

Vendor Records

You must have a vendor record in Alma to set up SUSHI harvesting for that vendor.

• Search Alma Vendors with vendor status = All.
  • If no vendor exists, click on Add vendor and create a new vendor for the publisher/platform.

• Once you have a vendor added, or an existing vendor is found, click the Vendor Code, or "More Actions" ellipsis to Edit the vendor.

• Click on the Usage Data Tab.

Usage Data Tab

Click on Add SUSHI Account.
Select Release 4 or Release 5*
* Note: most vendors provide stats in COUNTER Release 5 and many have phased out provision of COUNTER Release 4.

See Finding SUSHI Credentials for help finding SUSHI connection information for common platforms/vendors, as well as links to other helpful resources.

Paste SUSHI Connection info on vendor’s Alma SUSHI Account Request Details section, as pictured below.

• Connection details vary by vendor/platform. Most often used fields are: Requester ID, Customer ID, and many also require an API Key. 
• DO NOT FILL OUT FIELDS NOT REQUIRED BY VENDOR/PLATFORM.

Once you have entered your SUSHI Connection details, click Test Connection. This will verify your connection details are correct.

For COUNTER 5 connections, a JSON file is created for download. This file can be opened with a Text editor.

If you have never opened a JSON file and attempt to open it with Chrome, you will receive this error:

To open the file, open your text editor of choice and choose Open, then navigate to the file to Open it. You may want to associate the JSON file with a text editor to avoid this message in the future.

If you use Firefox, it may offer to open the file in a text editor automatically:

Successful Test

If your SUSHI Connection Test is successful, you should receive a message that includes a "Service_Active":true statement.

Failed Test

If the SUSHI connection test fails, you may see various errors in the JSON file (see below) or the error may pop-up directly in the Alma interface. These errors can be investigated further via Ex Libris documentation on troubleshooting COUNTER 5 SUSHI Harvesting.

Select the Types of Reports to Harvest

Once you have verified your SUSHI Connection is working, you can add the types of reports you wish to harvest. Note that not all vendors will have all report types. If you are not sure which Reports to select the Managing COUNTER-compliant Usage Data page from Ex Libris describes each report type.

Click Add Report Type and the Reports Type Selection Box will open.

Select the Reports you want to harvest, and they will appear on the list of Active Reports.

Once you have selected all the reports, Click to Save the information at the top of SUSHI Account Details Page. This will return you to the Vendor Details Usage Data Tab. Click To Save all changes.

Return to Vendor Details Usage Data Tab and in Row Actions select Custom Harvest > enter desired date range to harvest data.

What data to harvest is a local decision: you may decide you want all COUNTER 5 data your vendor has available, or perhaps all data since "go live" in Alma (June 2020).  Note: The Harvest Now option will only harvest most recent 12 months.
 

Once you do the custom harvest, you can verify the data has been harvested. Look under Vendor Details > Usage Data > and see the uploaded files section.

After the first harvest, Alma will continue capturing data based on your schedule, based on recent month (only newest data is retrieved after first harvest).

To set up the automated schedule:

1. Go to Configuration Menu > Acquisitions > General > Acquisition Jobs Configuration
2. Set Status to Active.
3. Select from 5 available Scheduling options. Recommended: Select one of the monthly options.
4. Set up email notifications to receive job reports in your mailbox. Recommended so you will be aware if there are any issues.

Check job reports
Emailed reports with Subject “SUSHI harvesting job - Completed with Errors” if set up in configuration as recommended (see above).

Reports are also available via Alma > Admin > Manage jobs and sets > Monitor jobs > Scheduled > SUSHI harvesting job > job history from row actions

Check errors that may require you to fix problems, see common error messages and recommended actions.

Review Ex Libris' Troubleshooting Tips for COUNTER 5 SUSHI Harvesting for more complex SUSHI problems.

These reports are in Shared Folders > Carli NETWORK 01CARLI_NETWORK > E-Resource Usage Reports

Roles Required for Analytics:
Design Analytics
Analytics Administrator, or
General System Administrator

Make sure to follow the instructions to copy the reports to your institutions folder for further customization.
Usage data loaded into Alma will be available via Alma Analytics by the beginning of the following work day.

Electronic Usage by FY and Platform – COUNTER 4 and 5

This report totals usage by Fiscal Year and Platform for each type of COUNTER statistic you may be harvesting. 

Electronic Usage by Month and Platform – COUNTER 4 and 5

This report lists the usage statistics for individual titles in packages by platform and month.

ACRL Q60 Total Digital/Electronic Collection Circulation or Usage

Gathers and totals statistics to answer ACRL question 60, total Digital/Electronic collection circulation or Usage by FY.

ACRL Q63 e-Serial Usage

Gathers and totals statistics to answer ACRL question 63, total e-serials usage by FY.

Cost Per Use for eBooks

Based on individually purchased titles by Collection, this Analytic should be edited to include the Electronic Collection you are interested in reporting on. Note: A library must have POLs for the individual titles for this Analytic to work properly. 

If your institution has developed Analytic reports using COUNTER data, please feel free to share them by emailing CARLI Support.