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

    Configuring Facets

    If you are working with Primo VE and not Primo, see Configuring Discovery Views for Primo VE.

    Return to main page.

    In general, the basic configuration is the same for all kinds of facets. Additional configuration is needed to configure static facets.

    To configure facets to display in the Front End:

    1. Configure the facets in the Facets section of the normalization rules. For more information, see Facets Section in The PNX Record.

    2. Configure static facets as needed. For more information, see Configuring Static Facets.

    3. Configure top-level facets as needed. For more information, see Configuring Top-Level Facets.

    4. Configure the views to display facets in the Front End. For more information, see Displaying Facets.

    5. Configure the facet labels that display in the Front End and Back Office. For more information, see Modifying Facet Labels.

    Facets Section in The PNX Record

    Primo uses the normalization rules to store a source record’s facet information in the Facets section of the PNX record. The normalization rules templates provide out-of-the-box rules for each facet type, but some types (such as collections and libraries) may need customization. For more information on the Facets section, see The Facets Section in the Primo Technical Guide.
    After you update the facets section in the normalization rules, run a No Harvesting – Update Data Source pipe and re-index your records. For more information, see Configuring Pipes.

    Displaying Facets

    The Refine My Results tile of the Views wizard (see Edit Facets Attributes Page) is used to configure which facets to display in the following sections of the Brief Results page:
    To display facets in the Refine My Results section:
    The facet is added to the list of facets to display in the Front End.
    1. On the Primo Home > Ongoing Configuration Wizards > Views Wizard > Tiles Configuration page, select Brief Display in the Page drop-down list.

      The tiles that configure the Brief Results page appear in the list (see Tiles Configuration Page (Brief Display Tiles)).

      TilesConfigurationPage.gif

      Tiles Configuration Page (Brief Display Tiles)
    2. Click Edit Tile in the row that contains the Refine My Results (Facets) tile.

      The Edit Facets Attributes page opens (see Edit Facets Attributes Page).

      RefineMyResultsTile.gif

      Edit Facets Attributes Page
    3. In the Facets to display section, select a facet on the Facet Type drop-down list and click Create.
    4. Update the following columns for the new facet:

    5. Items to display – Specify the number of items that you want to display for the facet. The default value is 5.

      Because the system creates five groups for the Creation Date facet, a value greater than 5 will only display five groups. For information on how facet groups are created for the Creation Date facet, see Facets Section in the Primo Technical Guide.

    6. Sort – Specify the type of sort for the facet. The following values are valid:

      • alpha_numeric – Sorts the facet’s values alphabetically.

      • by_size – Sorts the facets by the number of matching records, in descending order.

    7. Tabs – Select the check box for each tab in which you want to display the facet.

    8. Click Save & Continue.

      The Tiles Configuration page opens (see Tiles Configuration Page (Brief Display Tiles)).

    9. Click Continue to deploy the changes to the Front End.

    Modifying Facet Labels

    Primo allows you to modify the facet labels that display above each list of facets in the Front End (see Facet Labels in the Front End), the labels and buttons that display in the More options lightbox in the Front End (see Facet Labels in the Front End), the items in the Facet Type drop-down lists in the Back Office (see Facet Type drop-down list in the Back Office).

    FacetLabelExample.png

    Facet Labels in the Front End

    MoreOptionsLightbox.png

    More Options Lightbox in the Front End

    FacetTypeExample.gif

    Facet Type drop-down list in the Back Office

    The following code tables allow you to modify the facet labels that display in the Front End and Back Office per view and language:

    • Facet Labels – Configures the facet labels that display on the results page in the Front End (see Facet Labels Code Table).

      FacetLabels.gif

      Facet Labels Code Table
    • Results Tile – Configures the labels and buttons that display in the More options lightbox (see Facet Labels Code Table).

      ResultsTile.png

      Results Tile Code Table
    • Facet Code Fields – Configures the facet labels that appear in the Facet Type drop-down list in the Back Office (see Facet Code Fields Code Table).

      FacetCodeFields.gif

      Facet Code Fields Code Table

    Enabling the Creation Date Facet Categories

    Primo allows you to enable the Creation Date facet categories, which are disabled out of the box. In its place, Primo displays the date slider, which provides more precision.

    CreationDateFacetCategoriesEnabled.png

    Creation Date Facet Categories Enabled
    For information on hiding the Date slider, refer to the Primo Technical Guide.
    To enable the Creation Date facet:
    1. Log on to the Back Office server as the primo user.

    2. Enter the following commands to access and open the CSS file that is used to customize your view:

      fe_web
      cd css
      vi <custom_css/>.css

      It is not recommended to modify the default Primo CSS, which can be overwritten during updates. For more information regarding the customization of Primo views, see the Primo Technical Guide.

    3. Change display: none to display: block in the following element in the CSS file:

      .EXLFacetContainer ol li.EXLHiddenFacetCreationDate
      display: block;}
    4. Save the changes to the CSS file.

    5. On the Primo Home > Deploy All page, select all options and click Deploy.

    6. Perform a search to verify that the Creation Date facet appears in the view.

    Facet Search Engine Parameters

    The following parameters on the Primo Home > Advanced Configuration > Search Engine Configurations page (see Facet Parameters on Search Engine Configurations Page) allow on-premises customers to control how the system builds and displays facets:

    • Number of Top Hits for Facet Creation – This field specifies the number of top-ranked records the system will use to create the list of facet values that are displayed in the Refine My Results section of the Front End. Currently, this field is no longer configurable and is set to 2000 internally. For CDI, all records in the results set participate in facet count calculation for the top 20 values displayed for CDI.

    • Maximum Number of Displayed Facets – This field specifies the maximum number of facets that can be displayed in the FE (for example, when More is invoked).

    • Full Facets Cache – This field indicates whether cache is used to increase the maximum value of the Number of Top Hits for Facet Creation field to 5000. For more information on adding additional memory, see Full Facets Cache (on-premises installations only). For multi-tenant customers, this value may be set as high as 10,000.

    SE_Config_Facets.gif

    Facet Parameters on Search Engine Configurations Page

    Sorting Facets

    The system uses custom sort definitions for both search results and facets if you configure custom sorting in the Sorting section on the Search Engine Configuration page and store the necessary sort definitions in the following directory, which is accessible to on-premises customers only:

    ../ng/jaguar/home/profile/analysis/sort/user_defined

    The system uses the SE Char conversion mapping table to normalize the sort keys that are stored in the Sort section of the PNX for search results only. This mapping table is not used for sorting facets.

    For more information on the normalization of characters, see the Primo Technical Guide.

    • Was this article helpful?