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

    Configuring the Citation Linker and Fetch Item

    The Citation Linker (which is also known as Fetch Item in the new UI) does not search for records the same way as a regular Primo search does, instead it creates an OpenURL request based on specified metadata, submits the request to your link resolver (such as Alma or SFX), and then displays the link resolver's results. This is useful when looking for a specific book, article, or journal that may not be indexed in your local Primo database or covered by your activated Primo Central collections. In addition, your link resolver may offer other services to purchase or request items that your library does not hold.

    The Citation Linker lightbox provides a tab for books, journals, and articles. This allows users to specify search criteria (such as volume, author, and so forth) for the selected citation type in order to view full text or request additional services (such as ILL).
    Citation Linker Lightbox (Classic UI)
    FetchItem_NewPrimoUI.png
    Fetch Item Page (New UI)
    Because Alma only supports the Exact precision option for title searches (see below), the precision drop-down field will not appear in the lightbox for Alma users.
    Citation Linker Lightbox for Alma Users (Classic UI)
    FetchItem_Alma_NewPrimoUI.png
    Fetch Item Page for Alma Users (New UI)
    After the user clicks Go to begin the search, Primo sends a request to the link resolver defined for the institution to request the results. For SFX, the results return in the SFX Service page. For Alma, the results return in a page that is based on the Alma Services Page.

    Back Office Configuration

    The following table lists the changes that are needed in the Back Office to configure the Citation Linker/Fetch Item functionality:
    Configurations for the Citation Linker
    Configuration Page Description
    Citation Linker Labels code table
    This table allows you to personalize the text that displays in the Citation Linker lightbox.
    Citation Linker Definitions mapping table
    This table defines which OpenURL fields can be entered per citation type. You may remove fields or change the order of fields.
    Views Wizard > Home Page > Main Menu tile
    This page defines the links that display in the main menu.
    To add the Citation Linker button to the main menu if it has not already been defined:
    1. Enter the following fields in the Create new Label section:
      • Label – Enter citationlinker. This field initially defines the Label and Code fields. You can rename the label later.
        Do not use the citationlinker code if you want to link to the Citation Linker as a stand-alone page. Instead, specify a unique code, add a stand-alone link to the URL field as explained in Linking to the Citation Linker, and specify whether you want the Citation Linker to open in the same window or another window.
      • URL – Enter the following URL:
        /action/citationLinker.do?openInSeperateWindow=Y&isCitationLinker=Y
        If you want to use the CSS defined for your Services Page view (not the default Services Page defined in Alma), append the following parameter to the URL:
        &spvid=<view_id>
      • Link should open in – Indicates whether the results open in the current window or a new window/tab. This field is relevant only for the links that open a stand-alone Citation Linker page. The default value is current window.
    2. Click Add.
    3. Change the Label field to Citation Linker in the Contents of Main Menu Tile section.
    4. Click Save & Continue.
    5. Click Continue to deploy.
    6. Click Deploy Now.
    If the Citation Linker button already exists and you want to modify the URL information (such as including your own Services Page view), delete the existing Citation Linker row and then perform the above procedure to update the URL.

     

    Linking to the Citation Linker

    Primo allows you to access the Citation Linker using the following linking options:

    • Linking to the Citation Linker lightbox via a deep link (Old UI only) – The following parameter can be added to any Primo deep link to open the Citation Linker lightbox:

      &openCitationLinker=true

      You can also pre-fill the fields in the Citation Linker by including the names of the OpenURL fields as parameters (which are defined in the Citation Linker Definitions mapping table), using the following format:

      &rft.<mapping table field>=<value>

      For Alma customers, you can use the CSS defined for your Services Page view by adding the following parameter to the link:

      &spvid=<services_page_view_id>

      For example:

      http://myInst:1701/primo_library/libweb/action/dlSearch.do?institution=VOLCANO&query=any,contains,leukemia&vid=Auto1&fromPreferences=false&openCitationLinker=true&rft.jtitle=leukemia&spvid=services_page
    • Linking to a stand-alone Citation Linker page – Use the following links to access a stand-alone page of the Citation Linker:

      Old UI:

      http://<primo server:port>/primo_library/libweb/action/citationLinker.do?vid=<view_code>&openInSeperateWindow=Y

      You can also pre-fill the fields in the Citation Linker by including the names of the OpenURL fields as parameters (which are defined in the Citation Linker Definitions mapping table), using the following format:

      &rft.<mapping table field>=<value>

      For Alma customers, you can use the CSS defined for your Services Page view by adding the following parameter to the link:

      &spvid=<services_page_view_id>

      For example:

      http://myInst:1701/primo_library/libweb/action/citationLinker.do?vid=Auto1&openInSeperateWindow=Y&rft.jtitle=test1&spvid=services_page

      New UI:

      http://<primo server:port>/primo-explore/citationlinker?vid=<view_code>