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

    Collection Discovery

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

    Collection Discovery is a feature in Primo that enables users to navigate the hierarchy of collections and subcollections to locate and view their associated items. The following rules apply to collections:
    • A top-level collection is the main collection. It cannot belong to another collection.
    • A subcollection is a collection that belongs to another collection. It may not belong to more than one collection.
    • The items are your inventory and may belong to one or more collections.
    • Links from records in collection discovery lead to an exact search in the default scope.
    Users can use the following methods to discover collections:
    • The Collection Lobby is a page dedicated to collection discovery in the Front End. It may display all of your institution's collections, a specific collection, or a collection's subcollections. Ultimately, this hierarchy allows users to view a collection's inventory in the standard results page.
    • The Primo Search Box allows users to search for collections in the existing scopes or with a dedicated collection scope (if enabled for the view). In the search results, collections contain a link that opens the collection in the Collection Lobby, and for both collections and items, the Details tab displays the complete collection path.
      In a multi-tenant environment, make sure that you do not use a general name for your dedicated collection scope (such as collections) to prevent search results that include records from other tenants. 
    This page contains the necessary information to configure collection discovery for Alma and Rosetta.

    Configuring Discovery for Alma Collections

    This section contains the steps needed to enable Alma collection discovery in the Front End. Many of the configurations are out of the box and are explained in Configuration Details for Collection Discovery.
    To configure discovery for Alma collections:
    1. Update your normalization rules in the Primo Back Office to include the changes associated with collection discovery. For more information, see Alma MARC Normalization Rules.
    2. Edit the Publish bibliographic records to Primo publishing profile in Alma (Resources > Publishing > Publishing Profiles) and make sure that the Collection option is selected. The collection data will be available after the job runs.

      Primo_Publishing_Profiles_Bibliographic.png

      Publish Bibliographic Records to Primo Publishing Profile
    3. In the Institution Wizard (Primo Home > Ongoing Configuration Wizards > Institution Wizard), set the Collection field under the Delivery Base URLs section to the same value as the API field.
      Collection_DeliveryBaseURL.png
      Collection - Delivery Base URL
    4. Add the Collection Discovery button to the Main menu in the Front End:
      1. Edit your view in the Views Wizard (Primo Home > Ongoing Configuration Wizards > Views Wizard).
      2. On the Tiles Configuration page in the Views Wizard, edit the Home Page > Main Menu tile.
        CollectionDiscovery_MainMenu.png
        Edit Main Menu Tile
      3. On the Edit Main Menu Attributes page, specify the following fields under the Create New Label section and then click Add:
        • Label - Specify Collection Discovery.
        • URL - Specify the following URL:

          Classic UI:

          /action/collectionDiscovery.do?vid=<your view>&colayout=grid&inst=<your institution>

          New UI:

          /primo-explore/collectionDiscovery?vid=<View_Code>
        • Link should open in - Select current window from the drop-down list.
    5. If you want to configure the display settings or localize any of the labels on the Front End, see Collection Discovery Configuration and Labels.
    6. If you want users to be able to search the dedicated collection scope, add it to your view in the Views Wizard (Primo Home > Ongoing Configuration Wizards > Views Wizard). 

    Configuring Discovery for Rosetta Collections

    This section contains the steps needed to to enable Rosetta collection discovery in the Front End. Many of the configurations are out of the box and are explained in Configuration Details for Collection Discovery.
    To configure discovery for Rosetta collections:
    1. Update your normalization rules. For more information, see Rosetta Normalization Rules.
      In addition, verify that the normalization rules map the Primo Institution Code to the delivery/institution field in the PNX record. For example:
      NormRuleRosetta.png
      Primo Institution Code Defined as Constant in the Normalization Rules
    2. Publish all collections and items from Rosetta.
    3. Run both pipes from the Primo Back Office: collection pipe and item pipe. For more information, refer to the following document:
      Since there is no option to selectively harvest just the collection and its items (assuming that the items have already been published to Primo), it will be necessary to run a complete set of all records.
    4. In the Institution Wizard (Primo Home > Ongoing Configuration Wizards > Institution Wizard), set the Collection field under the Delivery Base URLs section to the Rosetta base URL and port (for example, http://il-dps12:1801).
    5. Configure the ILS adaptor to support collections:
      1. On the All Mapping Tables page, edit the ILS Adaptors Template mapping table under the ILS Gateway subsystem (Primo Home > Advanced Configuration > All Mapping Tables)
      2. Configure the ILS adaptor template settings:
        For an Alma ILS, update the following fields in the row containing the ALMA_01_0028 ID:
        • XSLT file – Change to get_collections_rosetta.xsl.
        • Call Template – Change to {{collection_base}}/delivery/services/collections
        For a Voyager ILS, create and enable the following mapping row:
        • ID – Enter a unique ID.
        • Adaptor ID – Enter VOYAGER_7.
        • Service Name – Enter get_collections.
        • XSLT file – Enter get_collections_rosetta.xsl.
        • Call Template – Enter {{collection_base}}/delivery/services/collections
    6. Add the Collection Discovery button to the Main menu in the Front End:
      1. Edit your view in the Views Wizard (Primo Home > Ongoing Configuration Wizards > Views Wizard).
      2. On the Tiles Configuration page in the Views Wizard, edit the Home Page > Main Menu tile.
        CollectionDiscovery_MainMenu.png
        Edit Main Menu Tile
      3. On the Edit Main Menu Attributes page, specify the following fields under the Create New Label section and then click Add:
        • Label - Specify Collection Discovery.
        • URL - Specify the following URL:
          /action/collectionDiscovery.do?vid=<your view>&colayout=grid&inst=<your institution>
        • Link should open in - Select current window from the drop-down list.
    7. For the February 2016 release, update the delivery mapping tables:
      1. Add the following row to the GetIT! Link 1 Configuration mapping table:
        GetIt_Link1_Config_MT.png
        GetIt! Link 1 Configuration Mapping Table
      2. Add the following row to the GetIt! Tab 1 Text Configuration mapping table:
        GetIt_Tab1_Config_MT.png
        GetIt! Tab 1 Text Configuration Mapping Table
    8. If you want to localize any of the labels on the Front End, see Collection Discovery Labels.
    9. If you want users to be able to search the dedicated collection scope, add it to your view in the Views Wizard (Primo Home > Ongoing Configuration Wizards > Views Wizard). 

    Refreshing the Collection API

    The Collection API communicates with Alma and Rosetta to get information regarding their local collections. The API returns the complete collection hierarchy and the key information for every collection including the collection title, description, and link to the thumbnail.

    This information is automatically refreshed at 6 AM for your local server. For example, if you are in the APAC region, the collection information is automatically updated daily at UTC+8.

    To refresh the collection information manually:
    1. In the Institution Wizard (Primo Home > Ongoing Configuration Wizards > Institution Wizard), edit your institution.

    2. Next to the Collection field in the Delivery Base URLs section, click Refresh Collection API Response.

    Creating Deep Links for Collection Discovery

    You can use the following URL to create a deep link for the Collection Discovery page:

    • Classic UI:

      http://<Primo server and port>/primo_library/libweb/action/collectionDiscovery.do?vid=<view ID>&inst=<institution>&colayout=<type>

    • New UI:

      http://<Primo server and port>/primo-explore/collectionDiscovery?vid=<view_ID>&collectionId=<collection_ID>&lang=<lang>

    Collection Discovery deep links support the following parameters:

    • vid – the view ID.

    • inst – the institution of the view.

    • colayout – (Classic UI only) the format of the collections in the Collections Lobby. Specify either grid or list.

    • collectionId (optional) – the ID of the collection to which you want to give focus on the page.

    Examples:

    • Classic UI:

      http://myuniversity.exlibrisgroup.com/primo_library/libweb/action/collectionDiscovery.do?vid=MYVIEW&colayout=grid&inst=MYUNIVERSITY

    • New UI:

      http://myuniversity.exlibrisgroup.com/primo-explore/collectionDiscovery?vid=MYVIEW&collectionId=1757493&lang=en_US

    Disabling the Collection Path

    The Full Display page displays the full collection path for collections and their inventory out of the box.
    If you do not want to display the collection path:
    1. Edit your view in the Views Wizard (Primo Home > Ongoing Configuration Wizards > Views Wizard).
    2. On the Tiles Configuration page in the Views Wizard, edit the Full Display > Full Results tile.
      CollectionDiscovery_FullResults.png
      Edit Full Results Tile
    3. On the Edit Full Details Attributes page, edit the Collection Discovery field.
    4. Select Delete to remove the field from the Full Display page.

    Configuration Details for Collection Discovery

    This section describes the out-of-the-box configurations as well as the configurations that may require your attention to enable collection discovery in the Primo Front End.

    Alma MARC Normalization Rules

    This section describes the normalization rules that are used for Alma collection discovery. The changes are included in the Alma MARC - Template, but you may need to update these rules manually if you have localized your normalization rules. For information regarding normalization rules sets, see The Normalization Rules Sets Page.

    To support collection discovery, Alma publishes the following information about collections:

    1. The COL field includes the following subfields:

      • a - parent collection ID

      • b – collection title

      • c – collection name

      • A – the owning institution. Currently, this field is added only for centralized publishing, but it will be used for standard publishing in the future.

      For example:

      <datafield tag="COL" ind1=" " ind2=" ">
      <subfield code="a">81160000000151</subfield>
      <subfield code="b">Photographs of America</subfield>
      <subfield code="c">Photographs of America</subfield>
      <subfield code="A">WST</subfield></datafield>
    2. For standard publishing, collections are indicated by a value of C in INT subfield a.

    3. For centralized publishing, collections are indicated by a value of C in INST subfield b.

     The following table lists the relevant changes to the Alma normalizations rules. Refer to the Alma MARC Template for complete details.

    PNX Field Description
    control/colldiscovery
    Rules map information from the COL field.
    display/type
    Rule creates the type=’collection’ based on INT $$a=C / INST $$b=C
    search/cdparentid
    Rules map information from COL $$a unless the record is a collection (i.e only items are included). 
    search/searchscope
    Rules create the collections search scope, which is based on the existence of the COL field/resource type=’collection.
    dedup/t
    Because collections should not be deduped, a rule was added set t to 99 for collections.
    delivery/delcategory
    Rules map the Alma-C delivery category.

    Rosetta and Alma DC Normalization Rules

    This section describes the normalization rules that are used for Rosetta collection discovery. The changes are included in the Rosetta - Template, but you may need to update these rules manually if you have localized your normalization rules. If the Alma Dublin Core template has not been modified, you will need to update your rules.
    To support collection discovery, Rosetta and Alma publishes the following information about collections:
    1. The ID of the parent collection is indicated by the dcterms:isPartPf field when xsi=collection. This is included in subcollections and item records.
    2. The dc:type field indicates whether the record is a collection.
    Refer to the Rosetta documentation for harvesting instructions. 
    For example:
    <dc:type>collection</dc:type>
    <dcterms:isPartOf xsi:type="collection">16017873</dcterms:isPartOf>
     The following table lists the relevant changes to the Rosetta normalizations rules. Refer to the Rosetta - Template for complete details.
    PNX Field Description
    control/colldiscovery
    Rules for this field are based on the dcterms:isPartOf field and dc:type fields.
    This field also uses the PNX delivery/institution field. It is recommended to add rules for this field if they are not already defined. 
    display/type
    Rule creates the type=’Collection’ based on dc:type=collection.
    search/cdparentid
    Rules map the ID from the from dcterms:isPartOf unless dc:type=collection (only items are included in this index)
    search/searchscope
    Rules create the collections search scope, which is based on the existence of either dc:type=’collection’ or dcterms:isPartOf.
    delivery/delcategory
    Rules map the Collection delivery category based on dc:type=”collection."

    Availability and Delivery for Collections

    Delivery categories have been added to support collection discovery for Alma and Rosetta, respectively: Alma-C and Collection.
    The following table lists the changes to the Delivery mapping and code tables to support collections:
    Delivery Mapping and Code Table Changes
    Table Description
    Mapping Tables:
    GetIt! Link 1
    Configuration
    The following mapping rows configure the delivery links for Alma and Rosetta collections, respectively:
    1. Delivery Category Code: Alma-C, Data Source Code: ALL, Direct link to online resource: Y, Link field in PNX: linktocollection
    2. Delivery Category Code: Collection, Data Source Code: ALL, Direct link to online resource: Y, Link field in PNX: linktocollection
    GetIT! Tab 1
    Text Configuration
    The following mapping rows configure the text for the Alma and Rosetta delivery links, respectively:
    1. Delivery Category Code: Alma-C, Data Source Code: ALL, Tab 1 Label Code: linktocollection
    2. Delivery Category Code: Collection, Data Source Code: ALL, Tab 1 Label Code: linktocollection
    Templates

    The following mapping row configures the template that is used to create the Alma and Rosetta delivery links:

    • Code: linktocollection

    • Template Code:

      • Classic UI: {{primo_base_external}}/primo_library/libweb/action/collectionDiscovery.do?collectionId={{coll_id}}&vid={{view}}&colayout=grid&inst={{coll_institution}}

      • New UI: {{primo_base_external}}/primo-explore/collectionDiscovery?collectionId={{coll_id}}&vid={{view}}

    Code Tables:
    GetIT! Tab1

    The following table lists the codes used for the delivery of collections:

    GetIT! Tab1 Code GetIT! Tab1 Text

    default.linktocollection

    View Collection

    default.nui.getit_full.linktocollection

    Display Collection

    default.nui.brief.results.tabs.expandCollections

    View all collections

    default.nui.brief.results.tabs.moreCollection

    More from the same collection

    default.nui.brief.results.tabs.collectionTab

    Collection

    Collection Discovery Configuration and Labels

    The following table lists the mapping and code tables used either to configure mapping settings or to customize or translate display labels associated with collection discovery:
    Collection Discovery Table
    Table Description
    Mapping Tables:

    Format mean

    The following row defines the Collections resource type:

    collection > collections

    Pre_filter

    The following row defines the pre-filter drop-down list value:

    collection > collections

    facet_rtype_values

    The following row defines the Collections value under the Resource Type facet:

    Collections > collections

    Sort Fields Config

    Defines the sort types that appear in the Sort By drop-down lists on each Collection page.

     

    • For Alma-Primo environments, you must make sure that the active codes in Alma's Collection Title Sorting Routing mapping table (Configuration Menu > Fulfillment > Discovery Interface Display Logic > Collection Titles Sorting Routine) match the codes defined in this mapping table.

    • In addition, the default item in the Sort By drop-down lists is configured at the collection level in Alma by setting the Sort titles by drop-down list under the Display section on the Discovery tab of the Electronic Collection Editor to one of the following: RelevanceTitleAuthorDate - oldest, or Date - newest. If no option is selected or the selection is not relevant to sub-collections, the default sort is Relevance for Collection Discovery in Primo.

    Collection Discovery Configuration

    The Use Collection-specific display parameter indicates whether to display collection-specific display lines in the brief results for records that have the following settings: display/type = collection and delivery/delcategory = Alma-C or collection. The valid values are:
    • Yes (default) – Displays a link to the collection and overrides the display line settings for the brief results in the Views Wizard and instead displays the following information:

      • Title: display/title

      • Description: display/description

    • No – Uses the display line settings for the brief results in the Views Wizard.

    Code Tables:

    Collection Discovery

    This new code table (Front End subsystem) defines the labels on the Collection Discovery page.
    The following code displays the first node in the collection path and in the full display of an item:
    default.colldiscovery.collpath.topnode > Collections
    The following code displays the View Collection link on top-level collection page of the Collections Lobby:
    default.colldiscovery.viewcoll.toplevel > View collection
    The following code displays the View Collection link on a subcollection page of the Collections Lobby:
    default.colldiscovery.viewcoll.sub > View collection
    The following code displays the View Items link in the Collections Lobby:
    default.colldiscovery.viewitems > View items

    The following code displays the top title on the top-level collection page of the Collections Lobby and in the browser page title:

    default.nui.colldiscovery.lobby.toptitle > COLLECTIONS

    The following code displays the top description on the top-level collection page of the Collections Lobby:

    default.nui.colldiscovery.lobby.description > All Collections

    View Labels

    The following code displays the link to the collection discovery from the Main menu in the Front End:
    default.mainmenu.label.colldiscovery > Collection Discovery

    Icon Codes

    The following code displays the resource type:
    default.mediatype.collection > Collection

    Full Display Labels

    The following code displays the collection in the full display for an item:
    default.fulldisplay.collection > Collection

    Basic Media type

    The following code displays the pre-filter option for basic searches:
    default. search-simple.mediaType.option.collections > Collections

    Advanced Media type

    The following code displays the pre-filter option for advanced searches:
    default.search-advanced.mediaType.option.collections > Collections

    Facet Resource Type

    The following code displays the facet resource type for collections:
    default.facets.facet.facet_rtype.collections > Collections

    Header/Footer Tiles

    The following code displays the collection/institution name under the browser page title in the full display of any collection (including top-level collection), or collection item:

    default.nui.full.display.title > {{recordTitle}} - {{institutionName}}

    For more information, see How to Change Browser Page Title of Collection Discovery Pages in New UI.

    More from the Same Collection

    The More from the same Collection section on the Full Display page allows users to expand the search of the current title to other items in the collection and in additional collections that also contain the current title.

    Primo_MoreFromCollection.png

    More from the Same Collection Section

    The top half of this section lists all collections to which this titles belongs. A maximum of six collections display initially. Users can select the View all collections icon to view the remaining collections. Users can select a collection to open its Collection page, which allows them to view a collection's items and subcollections.

    The bottom half of this section allows users to browse items that belong to the item's related collections. Users can select any of the following:

    • the Previous and Next arrows to scroll through the items. The items are listed from left to right, and their order is based on relevance.

    • an item in the list to open its Full Display.

    Configuration Options

    The following table lists the settings used to configure this functionality.

    Element Description

    Views Wizard

    To enable this functionality in the new Primo UI, select the following field in the General section of the Views Wizard: More from the same Collection.

    Aria Labels

    The following code was added to support accessibility for this functionality:

    • default.nui.aria.moreFromTheSame.collection.tab: Navigate to More From The Same Collection

    GetIT! Tab1 code table

    The following codes were added to support this functionality:

    • default.nui.brief.results.tabs.moreCollection: More from the same Collection

    • default.nui.brief.results.tabs.collectionTab: Collection

    • default.nui.brief.results.tabs.expandCollections: View all collections

     

    • Was this article helpful?