Resource Recommender for Primo VE
If you are working with Primo and not Primo VE, see Resource Recommender for Primo.
The Resource Recommender service allows you to recommend the following resources based on searchable tags that you configure in Alma: database, website, person, library information, library guide.
When a user performs a search in which the query exactly matches the searchable tag (which may be a word or phrase), Primo VE displays up to three associated recommendations at the top of the brief results. User's can see all of the recommendations by clicking the See all suggested resources link.
Resource Recommender Service on the Brief Results Page
Currently, partial searches are not supported by the Resource Recommender.
Configuring the Resource Recommender Service
The Resource Recommender service allows you to list recommendations (such as contacts and databases) at the top of the brief results in Primo VE based on searchable tags that you define per recommendation. The Resource Recommender Configuration page lists all of the recommendation types and allows you to manage each type's recommendations. Since only three recommendations appear in the brief results initially, priority is given to the recommendation types starting at the top of the list.
To add a resource recommendation:
-
Open the Resource Recommender Configuration page (Configuration Menu > Discovery > Other > Resource Recommender Configuration).
Resource Recommender Configuration Page -
Edit the following resource types to manage their recommendations as needed:
-
Database - Displays the database recommendations on the left side of the All Suggested Resources page.
-
Person - Displays the contact recommendations on the right side of the All Suggested Resources page.
-
Website - Displays the Website recommendations on the left side of the All Suggested Resources page.
-
Library Information - Displays the library information on the right side of the All Suggested Resources page.
-
Library Guide - Displays the library guide recommendations on the right side of the All Suggested Resources page.
-
Custom 1, 2, and 3 - Displays the custom recommendations on the left side of the All Suggested Resources page.
The Resource Configuration Page opens:
Resource Configuration Page for Suggested Database -
-
On the Resource Configuration page for the selected resource type, select one of the following actions:
-
Add Resource (all resource types) - Allows you to add one or more resources manually.
-
In the Add Resource dialog box, specify the following fields:
-
Click Add and Close to add the new recommendation.
-
Click Save to return to the Resource Recommender Configuration page.
-
Continue with the next step.
-
-
Add resources from electronic collections (Suggested Database only) - Allows you to add resources from electronic collections to which your library has a subscription. With this option, the system configures the default settings (such as delivery URL and tags) for the electronic resource, which you can modify as needed later.
-
Perform an electronic collection search of the repository and then select all of the collections that you want to recommend.
Repository Search for Electronic Collections -
Click Select to save your selections and to close the Repository Search dialog box. The selected electronic resources appear in the list of recommendations on the Resource Configuration page.
Collections Added to List of Recommendations -
On the Resource Configuration page, edit the configuration fields (such as Tags) as needed for each recommendation in the list and then click Save. For more details on each field, see Resource Recommender Fields.
Edit Electronic Collection Recommendation -
Click Save to save your changes and to return to the Resource Configuration page.
-
Continue with the next step.
-
-
-
Enable each recommendation as needed.
-
Click Save to return to the Resource Recommender Configuration page.
-
Drag and drop the rows as needed to reorder the priority of the resource types
Importing Recommendations
The Resource Configuration page allows you to import recommendations per the selected resource type using an Excel file. Unless noted in the following table, all columns must be included in the specified order. For example, if you are importing recommendations for Library Guides, you must omit the image_url , email, email_text columns from the import file. You may leave any non-required fields empty.
| Order | Field | Description |
|---|---|---|
|
1 |
key (required)
|
The internal key, which is used to track the recommendations and define the recommendation's code in the Resource Recommender Data Labels code table. Since the key is used as an internal ID, it cannot be modified later.
|
|
2 |
name (required)
|
The name that displays for the resource in Primo VE. You must specify a display name for all recommendations and resource types. This field is translatable.
|
|
3 |
tags (required)
|
The search tags that trigger this resource recommendation. You must specify at least one tag per recommendation. If you want to specify multiple tags for a recommendation, separate them with a semicolon.
This field supports up to 3000 characters. |
|
4 |
description
|
The resource's description (a maximum of 300 characters), which appears for the recommendation in Primo VE. This field is translatable.
|
|
5 |
image_url
|
The URL used to display an image for the recommendation in Primo VE.
Remove this column when importing Library Guide and Library Information resource types.
|
| 6 |
url
|
The URL that is used to redirect users after they click the display name in the recommendation.
Remove this column when importing the Person resource type.
|
|
7 |
url_text
|
If the url field is specified, the system displays this text in the new UI and redirects users to the specified URL when clicked.
Remove this column when importing the Person resource type.
|
|
6 |
email
|
The email address of the contact person.
Except for the Person resource type, remove this column. |
|
7 |
email_text
|
If specified, this text displays instead of the user's email address. If left empty, the Email address of the person will be displayed.
|
|
8 |
internal_note
|
Descriptive text to explain the use of this resource to staff members who may be configuring recommendations.
|
|
9 |
views |
Select All if you want this recommendation to apply to all views. If you want to apply this recommendation to specific views, clear the All option and list the views (separated by a comma) to which you want this recommendation to apply. |
To import recommendations:
-
On the Resource Recommender Configuration page (Configuration Menu > Discovery > Other > Resource Recommender Configuration), edit the the resource type to which you want to import recommendations.
Resource Configuration Page - Database -
On the Resource Configuration page for the selected resource type, click Import.
Import Dialog Box for Resource Recommendations -
In the Import dialog box, select the file to import (for example, Database_List.xls).
Example Excel Entry -
Select one of the following buttons:
-
Add Resources – Adds recommendations to the existing list of recommendations for this resource type.
-
Replace Resources – Replace all recommendations for this resource type.
-
Cancel – Closes the Import dialog box without importing.
-
Exporting Recommendations
The Resource Configuration page allows you to export recommendations per resource type to an Excel file. This allows you to modify many recommendations at once, create translations, and import the updated Excel file into the Resource Recommender page (see Importing Recommendations).
To export recommendations:
-
On the Resource Recommender Configuration page (Configuration Menu > Discovery > Other > Resource Recommender Configuration), edit the the resource type from which you want to export recommendations.
Resource Configuration Page - Database -
On the Resource Configuration page for the selected resource type, click the Export button
and then select Excel.