Adding new SUSHI credentials

Watch our video guide:

Step-by-step instructions:

To add new SUSHI credentials, navigate to "SUSHI management" in the left sidebar menu and click on the green "ADD NEW SUSHI" button.

The following dialog will open with all relevant data. Please note that you can only have one set of credentials for one platform per organization and COUNTER version. 

The first step is to choose the platform you are adding credentials for. Please note that CELUS already knows most of the SUSHI platforms and all of the platforms registered under Project COUNTER Registry. In case you cannot find the platform in our list anyway, you can Add a custom platform (however, we advice you to really try to find the platform in our list first, as it keeps CELUS clean and also provides your platforms with automatic updates). 

If you choose a platform included in the Counter Registry, you will see an outclick icon next to it. This icon will take you to the corresponding page in the Counter Registry.

Next, you have to fill the required minimum of parameters before it is possible to save the credentials. Your provider should give you all information that you will need on this page. The dialog contains the following entries:

Title

Your name for the set of credentials. This field is completely optional and does not have to be filled.
  

Organization

The organization will be prefilled with the one currently active.

Platform

You may select amongst all available platforms, but if you select a platform for which credentials for all supported COUNTER versions are already present, it will not be possible to select COUNTER version and save the record.

Requestor ID

It identifies the party requesting the data. For some platforms, it matches the Customer ID, for some it is different from it and for some it might even be empty. The  icon means that according to the Counter Registry, this platform requires a Requestor ID to harvest SUSHI data.

Customer ID

Identifies the organization for which data should be downloaded. This is a mandatory field. The  icon means that according to the Counter Registry, this platform requires a Customer ID to harvest SUSHI data.

API key

Fill only if the API key was provided by the platform.

COUNTER version

This drop-down menu contains only the values that are supported by the system, and which don’t already have a record set up for this organization and platform. In case credentials for all supported COUNTER version are already defined, there will be no value to select, and the credentials cannot be saved. You have to instead edit the matching existing record.

URL

The URL of the SUSHI server. This is a mandatory field. If the URL provided to you by the provider ends with /reports/, remove this part as it will be supplied automatically. If the URL was prefilled by the system, it is most likely the correct URL for SUSHI harvest. Please, do not change this value unless you are absolutely sure that yours is correct. 

Extra attributes - platform

If you have been provided with some extra parameters for accessing SUSHI, this is the right place to put them. Usually this is only considering the “Platform” parameter (e.g. Elsevier platforms use this parameter to distinguish between Engineering village, ScienceDirect, and so on). 

Active report types

A list of reports that are available for the selected COUNTER version (note that if no COUNTER version is selected, the list here will be empty). Check at least one of them you wish to download. The  icon means that according to the Counter Registry, this report type is supported by this platform.

Automatic harvesting

Tick this box if you wish for CELUS to automatically download the data through these credentials every month. Please notice that the box is clicked by default. 

Purchased outside of consortium

Marks credentials that are for platforms for which access was bought directly by the organization and not through the consortium. Only Master organization member or superuser users may switch this off.

HTTP authentication – only for Counter 4

Some providers add extra protection to their SUSHI data. Here you can supply the username and password for HTTP authentication if it was given to you by the provider explicitly for the purpose of accessing SUSHI. Valid only for Counter 4!

The bottom of the dialog window has the following buttons:

Only visible if the credentials were already saved. Removes the credentials from the system.

Closes the dialog. If the content was not saved, it will be lost.

Saves the credentials and opens a dialog that allows immediate testing of the supplied credentials. It is considered good practice to immediately test newly created credentials. 

Saves the credentials and closes the dialog.

If the credentials are not working for you, see Debugging SUSHI.