Skip to main content
ExLibris
  • Subscribe by RSS
  • ExLibris Dev

    Adding Primo’s Search Box to the Alma Home Page

    Translatable
    Alma enables you to 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. In addition, 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 (Administration > General Configuration > Configuration Menu > Widgets > Primo Widget Search Fields).
      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 click Save.
    3. Open the Primo Widget Search Precision code table (Administration > General Configuration > Configuration Menu > Widgets > Primo Widget Search Precision).
      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 click Customize.
    5. Open the Primo Widget Configuration code table (Administration > General Configuration > Configuration Menu > Widgets > Primo Widget Configuration).
      Primo Widget Configuration Page
    6. Configure and enable the URL that is used for Primo searches and click 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 instructions regarding how to format the URL, see the following page in the Ex Libris Developer Network:
      Format the URL in the following manner:
      http://<host[:port]>/primo_library/libweb/action/dlSearch.do? <parametersList>
      The following is an example of a valid URL:
      http://Myprimo17:1702/primo_library/libweb/action/dlSearch.do?institution=PRIMO&vid=Auto1&search_scope=
      blend&onCampus=false&indx=1&bulkSize=5&dym=true&highlight=true&lang=eng&group=GUEST&displayField=creator
      • There are mandatory parameters such as institution, vid, onCampus, indx, and bulkSize that must be configured.
      • The query parameter should not be configured in the URL. Alma adds the query parameter when searching using the widget. The components of the parameter are taken from the search value and the drop-down values.
    7. If the Primo Dashboard does not display on the Alma Home Page, click Add Widget on the Alma Home Page.

      The Add Widget Lightbox opens.
      Add Widget Lightbox
    8. Select the row containing the Primo Dashboard widget and click Close. A yellow check mark indicates that a dashboard is selected.
    • Was this article helpful?
    //doorbell.io feedback widged