Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Discovery Customer Settings

    For Alma-Summon environments, see Configuring Discovery Customer Settings.

    Return to menu

    Setting Discovery Customer Parameters

    The Discovery Customer Settings mapping table (Configuration Menu > Discovery > Other > Customer Settings) contains global settings that pertain to discovery. Each row of the table contains a parameter, which can be customized to change settings or enable/disable functionality.

    PVE_DiscoveryCustomerSettingsParameters.png

    Discovery Customer Settings Mapping Table

    Most of the linking templates for Central Index collections (CDI) are now configured in the Custom linking for Central Index databases mapping table (Configuration Menu > Discovery > Other > Custom linking for Central Index databases). For more details, see Configuring the Central Index Linking Templates for Primo VE.

    To customize a parameter:
    1. Select the Customize row option if you have not already done so. Otherwise, select the Edit row option.

      The following parameters are configurable:

      Discovery Customer Settings
      Parameter Key Description

      add_keywords_stemming_to_query

      When set to true, stemming is activated in queries to boost searches that return few results. The default setting is false. For more details, see Stemming.

      allow_start_with_for_call_number

      When set to true, users are allowed to search for call numbers that start with a specified value in Advanced Search. The default setting is false, which disables this functionality.

      PVE_StartsWith_HoldingCallNumber.png

      Call Number - Starts With Option Enabled

      To use this functionality, you must also enable the Holding Call Number search index in the Advanced Search Configuration tab on the View Configuration page (Configuration > Discovery > Display Configuration > Configure Views). For more details, see Configuring Discovery Views for Primo VE.

      alphabetical_sort_pickup_inst_lib

      When set to true, the pickup locations are listed alphabetically on the Request Form, starting with the available pickup locations.  

      • If pickup locations are configured by campus, the pickup locations are grouped by campus and sorted alphabetically by campus and pickup location. If the patron is associated with a specific campus, that campus appears first in the list, followed by the other campuses in alphabetical order.
      • In a fulfillment network, the pickup locations for the patron's institution are sorted alphabetically and appear first in the list. The remaining pickup locations are grouped by institution and sorted alphabetically by institution and pickup location.

      app_authorization_token

      The authorization token used to enable secured access between Primo VE and campusM. To complete the handshake, this same value must also be defined in campusM (App Manager > Product Integrations > Add Product Integration > Primo VE > Authorization Code). A valid token may contain any character except for whitespace (such as tabs, spaces, and line breaks) and must be at least 8 characters long (for example, q58151J4bD).

      For more information, see Integrating Primo VE with campusM.

      auto_switch_quicklinks

      This parameter has been added to the February 2024 release to indicate whether Quicklinks will be automatically enabled in the May 2024 release.  By default, it is set to true to automatically enable Quicklinks.

      If you do not want Quicklinks enabled automatically in the May 2024 release, set this parameter to false prior to the May 2024 release.

      brief_results_journal_coverage

      When set to true, coverage information for electronic journals appears in the availability statement on the Brief Results page, reducing the need for users to view a journal's details to see the coverage information.

      Coverage information is based on the resource's portfolios. It appears mostly for Journals, but it may also appear for other types of resources that contain portfolios.

      You can use the Calculated Availability Text Labels code table (Configuration Menu > Discovery > Display Configuration > Labels) to customize or translate the display labels for the following coverage statuses:

      • delivery.code.coverage – Coverage: {0}

      • delivery.code.coverage.from – From {0}

      • delivery.code.coverage.until – Until {0}

      • delivery.code.coverage.and_more – and more

      • delivery.code.coverage.year_not_available – Most recent {0} year(s) not available

      • delivery.code.coverage.year_available – Most recent {0} year(s) available

      • delivery.code.coverage.month_not_available – Most recent {0} month(s) not available

      • delivery.code.coverage.month_available – Most recent {0} month(s)  available

      • delivery.code.coverage.year_month_not_available – Most recent {0} year(s) {1} month(s) not available

      • delivery.code.coverage.year_month_available – Most recent {0} year(s) {1} month(s) available

      broaden_availability_status

      When set to true, the system uses the enhanced availability statuses in the brief display of the search results instead of the Not available status: 

      • Not available - Acquisition
      • Not available - Claimed Returned
      • Not available - Hold Shelf
      • Not available - Loan
      • Not available - Lost
      • Not available - In Process
      • Not available - Missing
      • Not available - Resource Sharing Request
      • Not available - Technical - Migration
      • Not available - Transit
      • Not available - Requested

      The default value is false.

      You can use the Calculated Availability Text Labels code table (Configuration Menu > Discovery > Display Configuration > Labels) to customize or translate the display labels.

      cjk_segmentation

      This parameter configures the way that search strings with Chinese characters are divided into searchable tokens since words are not separated by spaces. The following search methods are supported:

      • OnegramWithBasis – ("A B C D") OR ("A B" "C D") OR (A B C D)

      • Basis – ("A B C D") OR ("A B" "C D")

      • Onegram – ("A B C D") OR (A B C D)

      db_results_by_institution_in_campus_view

      For multi-campus configurations, this parameter indicates whether the Database Search page displays results from the entire institution or the user's campus. When set to true, results are based on the entire institution. By default, this parameter is set to false so that results are based on the user's campus.

      Regardless of this setting, the category tree on the Database Search page displays categories at the institution level, not per campus.

      default_sort_newspaper_by_date_newest

      When set to true, the default sort for results in Featured Newspapers changes from Relevance to Date-newest.

      default_user_search_history_off

      Set this field to true to disable the following additional personal settings in My Library Card by default:

      • Allow saving my search history

      • Use my search history for the recent search suggestions

      When not specified or set to false, the above settings are enabled by default unless overridden by the user.

      direct_login_transfer_all_parameters

      For consortia only,  set this field to true if you want to redirect to the other institution and retain context and page settings (such as search terms and filters/facets) from the original page.  The default setting is false, which redirects to the other institution without transferring page settings from the original page. 

      This functionality requires the Allow direct login to other institutions option to be set on the View Configuration page (Configuration > Discovery > Display Configuration > Configure Views).

      disable_link_for_empty_linking_parameter

      Disables links for empty linking parameter defined for Link to Request templates defined on the Discovery Import Profile page. For more details, see Configuring Import Profiles for Primo VE.

      disable_synonyms

      When set to true, this parameter disables the use of synonyms in search queries. By default, this parameter is set to false.

      For more information, see Linguistic Features for Primo VE.

      discovery_display_resource_sharing_when_electronic_available

      When set to false, resource sharing requests are enabled in the How to get it section on the record's Full Display page when the record has no electronic and no physical holdings in the library.

      When set to true, resource sharing requests are enabled in the How to get it section on the record's Full Display page when the record has electronic holdings and no physical holdings in the library. If display logic rules in Alma prevent resource sharing requests, the How to get it section displays a message indicating that this item does not have any available services.

      discovery_facet_limit

      By default, facets in Primo VE return up to 20 facet values for local searches and up to 20 more facet values for CDI in blended searches. This parameter enables you to increase the maximum number of facet values to 50 for local searches only. The valid values are 20–50.

      CDI continues to display a maximum of 20 values in blended searches.

      display_856_in_the_holdings_as_viewit

      For a record to be considered as an online record, it should have electronic or digital inventory in Alma. Otherwise, the record is considered a print record by default. This functionality enables you to treat records with an 856 subfield u in the holdings as online records, even if they do not have electronic or digital inventory in Alma.

      This parameter configures the treatment of holdings records that have an 856 u field:

      • true – If the holdings record has an 8564 u field and the second indicator is not 2, the View It service appears and contains a link based on the 856 u field.

      • false – The View It service does not display for the holdings record, and these records are treated as physical items only.

      • IgnoreFirstIndicator – If the holdings record has an 856 u field and the second indicator is not 2, the View It service appears and contains a link based on the 856 u field.

      As a result, the availability status in brief display is displayed as Available online, and those records are included in the Available online facet.

      The online status and delivery are in addition to any physical availability indication.

      display_actions_personal_settings

      When set to true, all available library notices display in My Library Card > Personal Details.  For more information, see Additional Library Card Configurations for Primo VE.

      To allow users to select which library notices to receive or not, you must select the Enable Edit My Library Card option on the View Configuration page (Configuration Menu > Discovery > Display Configuration > Configure Views). For more details, see Enabling Users to Edit Personal Details

      display_location_level_in_getIt_single_location

      When set to true, the Locations page in Get It opens by default when there is only one location available. Otherwise, the Location Items page opens by default when there is only one location available. The default setting is false.

      display_sms_wanted

      When set to true, the SMS Wanted checkbox appears in My Library Card > Personal Details, allowing users to have notifications sent to  their preferred SMS number. If no SMS number is already configured,  the user must specify a preferred SMS number before selecting the checkbox.

      This field defaults to false, which hides the SMS Wanted checkbox from the user.

      display_user_settings

      Set this field to true to enable the My Library Card > Personal Details and Settings tab, which enables users to change additional settings. This functionality is disabled by default. For more details, see Configuring the Personal Details and Settings Tab.

      This setting also enables the My Personal details and settings link in the User Area menu of the UI.

      editions_eni_linking

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      enable_guest_user_for_dlr

      When set to true, display logic rules are applicable to guest users when service restrictions pertain to user groups.

      enable_login_event

      When set to true, enables institutions to track successful Primo patron logins in reports. Institutions may opt out of this option of Primo logins appearing in the report by setting the parameter to false.

      expand_my_results_when_no_results

      When set to true, search results are automatically expanded to include CDI records from sources other than those that have been activated for your institution if no results are returned without expansion.

      expanded_db_search

      When set to true (default value), searches on the Database Search page are expanded to match information in all fields instead of only the record's title. If you prefer searching by title only, set this parameter to false.

      For additional information, see Configuring Database Search for Primo VE.

      filter_dedups_from_discovery_browse

      When set to true (default value), deduped records are filtered from Browse Search results and may display different results from Alma's Browse Shelf Listing. If you prefer to see similar results in both Alma and Primo VE, set this parameter to false.

      gale_linking

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      getit_group_by_library

      When set to true, the available libraries are listed in alphabetical order in Get It if there is more than one available library with holdings. Otherwise, Get It displays all available locations in alphabetical order as it does for the default setting.

      The default setting is false, which does not group locations by library.

      GetIT! Tab1 Labels code table (Configuration Menu > Discovery > Display Configuration > Labels) defines the Libraries group heading in Get It.

      holdings_fields_display_in_locations_list_view

      When set to true, users can view holdings information on the Get It > Locations tab instead of having to open the Location Items tab. The default value is false.

      For more details about the configuration of holdings information, see Configuring Holdings Display Fields for Primo VE.

      ignore_ui_language_for_
      search_time_language_recognition

      This parameter enables you to disable language recognition during searches so that the same results are returned for every UI interface language.

      index_5XX_authorithy_fields

      When set to true, the system uses 5XX fields from your records to enrich the authority records. The default value is false. For additional information, see Search Section Mapping.

      infobase_linking

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      kanopy and kanopy_latest

      Kanopy is an on-demand streaming service that enables institutions to provide access to a large collection of films. During the activation of these services, you must also configure the template that CDI uses to link users to these streams.

      To configure these templates, you must replace <INSTITUTIONID> with your site-specific base URL prefix.

      http://<INSTITUTIONID>.kanopystreaming.com/node/{{control/sourcerecordid}}

      For example, if the prefix for the University of Testing is unt, your template would look something like the following:

      http://unt.kanopystreaming.com/node/{{control/sourcerecordid}}

      marc_field_for_additional_service

      Indicates which MARC field and subfield that holds the associated locations for the May Also Be Held By service and enables the use of the May Also Be Held By mapping table. For more information, see Configuring the "May Also Be Held By" Service in Primo VE.

      max_holding_per_record

      In the Get It section of a record's full display, Primo VE displays a maximum of 10 holdings. If you set this parameter to a value from 11-100), the system displays the Show More Locations link under the list of holdings if there are more than 10 holdings. Users can select this link to view all the holdings. The valid values are 1-100.

      mendeley_application_id

      After you have registered your Primo VE server with the Mendeley application (see Registering Your Primo VE Institution), enter your Mendeley application ID to configure the connection between your Primo VE server and the Mendeley application.

      mendeley_redirect_uri

      After you have registered your Primo VE server with the Mendeley application (see Registering Your Primo VE Institution), enter the secret value for your Mendeley application to configure the connection between your Primo VE server and the Mendeley application.

      mendeley_secret

      After you have registered your Primo VE server with the Mendeley application (see Registering Your Primo VE Institution), enter the redirect URL for your Mendeley application to configure the connection between your Primo VE server and the Mendeley application. Use the following format for your Primo server: 

      <Primo_VE_host_name>/primaws/mendeleyPost?vid=<Primo_VE_view_code>

      For example:

      https://myInst.primo.exlibrisgroup.com/primaws/mendeleyPost?vid=01WRLC_INST:01WRLC_VIEW

      moazine_linking

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      naxos_jazz_library

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      naxos_music_library

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      naxos_spoken_word

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      naxos_video

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      nichigai_linking

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      number_of_representations_in_viewit

      The maximum number of representations that display by default in the View Online section of a record's full details. The default value is 5.

      If the number of representations exceeds this setting, the Show More button displays below the list of representations and enables users to view the remaining representations by selecting it.

      online_payment_link

      When set to true, the link to the WPM Education E-Pament System is enabled in My Library Card to enable patrons to pay fines and fees online. For more information, see Configuring the WPM Education E-Payment System.

      primo_ve_remove_parentheses_from_query

      Search queries that include single terms enclosed in parentheses, may unexpectedly return a "No records found" message to users and also log a Solr exception. Set this field to true to remove the parentheses prior to sending the query to Solr and to return matching results.

      This setting applies only to exact field searches.

      psychotherapynet_video_links

      Not used. For configuration information, see Configuring the Central Index Linking Templates for Primo VE.

      resource_recommender_tags_min_coverage

      The percentage of search terms (excluding stop words) that must match the defined tag to return its resource recommendation. The default value is 75

      For example, if the tag is Harry Potter and the Philosopher's Stone, the user must enter at least three of the following words: Harry, Potter, Philosopher's, and Stone.

      save_users_search_history

      When set to true, recent search suggestions are enabled for all your institution's views.

      If you want to let users enable/disable this option on the My Library > Personal Details and Settings tab, set the display_user_settings parameter to true.

      show_recent_search

      When set to true, search history is saved between sessions and used for recent search suggestions. When set to false, existing search history is retained, but only current session entries are used for suggestions.

      If you want to let users enable/disable this option on the My Library > Personal Details and Settings tab, set the display_user_settings parameter to true.

      At any time, end users can delete entries from the Search History by selecting the delete option.

      Syndetics_Unbound_Customer_ID

      Specify the license ID that was received during the registration of the Syndetics Unbound service. When this field is defined, you can enable this service at the view level (Configuration Menu > Discovery > Display Configuration > Configure Views).

      For more information regarding Syndetics Unbound, see Setting Up Syndetics Unbound in Primo VE.

      Use Controlled Vocabulary Search Expansion
      Select this field to enable controlled vocabulary search expansion. For more information, see Search Expansion With Controlled Vocabulary.

      use_facet_in_creator_hyperlink

      Out of the box, selecting the author's hypertext link in a record's details returns results based on the creator and the record's creator facets.

      PVE_CreatorDetails1.png

      Author Details on the Record's Full Display Page

      This parameter enables you to return all records associated with the selected creator and not filter by the record's creator facets. Out-of-the-box, this functionality is disabled. The following values are valid:

      • true (default) – Indicates that the Author link includes the filter for the record's creator facets. For example: 

        https://myInst.alma.exlibrisgroup.com/discovery/search?
        query=creator%2Ccontains%2CRowling%2C%20J.%20K.%2CAND&tab=
        Online_Access&search_scope=Online_access&vid=PRIMO_OAP_INST%
        3AAlma&facet=creator%2Cexact%2CRowling%2C%20J.%20K.&lang=en&
        mode=advanced&offset=0

      • false – Indicates that the Author link excludes the filter for the record's creator facets. For example:

        https://myInst.alma.exlibrisgroup.com/discovery/search?query=creator%2Ccontains%2CRowling%2C%20J.%20K.%2CAND&tab=
        Online_Access&search_scope=Online_access&vid=PRIMO_OAP_INST%
        3AAlma&lang=en&mode=advanced&offset=0

      view_to_libraries_for_collection_discovery

      When set to true, collections are filtered by library/view as follows:

      • On the Collection pages, only the collections/sub-collections that are associated with the relevant library are displayed.

      • When searching for items from the Collections Lobby page, only the items that are associated with the relevant library are displayed.

      • The collection path that displays for an item on the Full Display page, includes only the paths to collections that are associated with the relevant library.

      • The More from the same collection area shows only items that are associated with the relevant library.

      You must also map your views to libraries in your institutions so that they can be filtered accordingly for collection discovery on the Primo view mapped into Alma libraries mapping table (Configuration Menu > Discovery > GetIt Configuration > Primo View to Libraries). For more details, see Configuring the Location Filter List for Get It.

      WestlawUK_linking

      Westlaw UK is an online legal information service. During the activation of this service, you must also configure the template that CDI uses to link users to this collection. To configure the template, replace <sponsorcode> with the sponsor code that is provided by Westlaw UK:

      http://login.westlaw.co.uk/maf/wluk/ext/app/document?crumb-
      action=reset&docguid={{control/sourceid}}&sp=<sponsorcode>
    2. Enter a value in the parameter value field.

    3. Select Save to save your changes to the table.

    Search Expansion with Controlled Vocabulary

    The Controlled Vocabulary service is an external Primo service (similar to AutoComplete) that expands user searches with words and phrases that constitute variations of the search term with the same meaning, thereby increasing the accuracy of the users' searches. This service is similar to the expansion with synonyms feature but is more robust. The expansions are visible on the screen and add, for example, variations of the search term with the same meaning (for example ADHD and attention deficit disorder, or name variations such as assata shakur and asata shakur). Users are provided with an option to revert to using only their original search term. All customers see this expansion above the results in searches that include the CDI search scope or local search scopes. Over time, the controlled vocabulary repository is extended so that users see more expansions in their search results.

    For example, if the user enters heart attack in the query, Primo also returns results that include myocardial infarction. If the user is interested only in results that include heart attack, the user can select the link to the right of the recommendation.

    ControlledVocabulary_PrimoVE.png

    Vocabulary Expansion as Shown in a Simple Library Search within a CDI Scope

    If the query contains more than one term that can be expanded, the system expands only the longest term. For example, if a user searches for informatics heart attack, the system expands heart attack (12 characters), because it contains more characters than informatics (11 characters).

    • If the user's query contains Boolean operators (for example, heart attack AND surgery), the system does not provide an expansion for the term (for example, myocardial infarction is not included).

    • Regardless of the phrase's context, expansions are added.

    • Expansions are not usually bi-directional (for example, the term myocardial infarction is not expanded to the term heart attack).

    • This functionality is supported only for simple and advanced library searches within CDI scopes.

    • This functionality is disabled when search queries include Boolean operators or exact phrases.

    To enable this functionality, select the Use Controlled Vocabulary Search Expansion parameter.

    Additional Configuration Options

    Controlled vocabulary suggestions are realized through the Automatic Query Expansion feature in CDI, which utilizes mappings adopted from various controlled vocabularies including LCSH (Library of Congress Subject Headings) and MeSH (Medical Subject Headings). In general, CDI suggestions are more conservative. CDI maintains a curated synonym list that is regularly updated. Requests to add new controlled vocabulary terms are welcomed and evaluated on a case-by-case basis.

    The following codes in the Results Tile Labels code table enable you to modify or translate the labels for this service:

    • nui.results.controlVocabulary.includingIncluding {{equivalentTerm}}.
    • nui.results.controlVocabulary.searchOnlyJust search {{query}}