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

    Adding Primo Search Box to the Alma Home Page

    Translatable

    If you are working with Primo VE, see Configuring the Discovery Search Widget to configure the search box's default search field and operator precision.

    You can add the Primo search box to the Alma Home Page so that staff users can search for items using Primo’s search interface within Alma. This dashboard provides high-level information regarding the last publish-to-Primo job.
    Primo Dashboard
    The Publishing Jobs List link provides access to the Monitor Jobs page and only displays for staff users who have one of the following roles:
    • General System Administrator
    • Catalog Administrator
    To add Primo’s search box to the Alma home page:
    1. Open the Primo Widget Search Fields code table (Configuration Menu > General > Widgets > Primo Widget Search Fields). For more information about code tables, see Code Tables.
      PrimoWidgetSearchFields_NewUI.png
      Primo Widget Search Fields Code Table
    2. Configure and enable the types of searches (such as title, subject, and so forth) that you want to allow from the search box and select Save.
      Currently, for the new Alma UI, only the default search type can be configured. The other search types will not be available in the search box.
    3. Open the Primo Widget Search Precision code table (Configuration Menu > General > Widgets > Primo Widget Search Precision). For more information about code tables, see Code Tables.
      PrimoWidgetSearchPrecision_NewUI.png
      Primo Widget Search Precision Page
    4. Configure and enable the precision operators (such as exact, contains, and so forth) that you want to allow from the search box and select Customize.
      Currently, for the new Alma UI, only the default precision operator can be configured. The other operators will not be available in the search box.
    5. Open the Primo Widget Configuration code table (Configuration Menu > General > Widgets > Primo Widget Configuration). For more information about code tables, see Code Tables.
      PrimoWidgetConfiguration_NewUI.png
      Primo Widget Configuration Page
    6. Configure and enable the URL that is used for Primo searches and select Save.
      You must configure the primo_search_box_url parameter for the Primo widget search capability to be available from the Alma home page. The value for this setting needs to be a valid URL for a Primo brief search deep link. For more information, see the following page in the Ex Libris Developer Network:
      Format the URL as follows for both the new and classic Primo UIs:
      http://<Primo_domain>/primo_library/libweb/action/dlSearch.do?institution=<Primo_institution_code>&vid=<view_code>&tab=<tab_code must be lowercase>&search_scope=<scope_code>
      The following is an example of a valid URL:
      http://Myprimo17:1702/primo_library/libweb/action/dlSearch.do?insitution=MY_INST&vid=Auto1&tab=primo_central&search_scope=PC
      • If the tab and search_scope parameters are not specified, the system will use the view's default values.
      • The query parameter should not be configured in the URL. Alma builds the query parameter from the search value and the drop-down values specified in the search box by the user.
      • If you want to use the new Primo UI, make sure that the New UI Enabled and Select View fields are configured in the Primo Back Office Institution Wizard. This forwards all deep links to the new Primo UI. Otherwise, the system will display the classic Primo UI.
    7. To have the Primo Dashboard appear on the Alma Home Page, see Managing Widgets.
    • Was this article helpful?