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

    Configuring the Citation Linker and Fetch Item

    This information is not applicable to Primo VE environments. For more details on Primo VE configuration, see Primo VE.

    Return to menu

    Introduction

    The Citation Linker (which is also known as Fetch Item in the new UI) does not search for records in the same way as a regular Primo search, which may return many results. Instead, it allows users who have metadata (such as a title, ISBN, ISSN, and so forth) for a specific book, article, or journal to retrieve available services (such as full text or ILL) for that item only.

    When a query is submitted, the Citation Linker sends an OpenURL request based on the specified metadata to your link resolver (such as Alma or SFX) and then displays the link resolver's results on either the SFX Service page (for SFX) or the Alma Services page (for Alma). Because the link resolver returns services based on its own information, it may also return services that are not indexed in your local Primo database or are not covered by your activated Primo Central collections. In addition, your link resolver may offer other services (such as to purchase or request items that your library does not hold).

    The Citation Linker dialog box provides a tab for books, journals, and articles so that users can specify search criteria (such as volume, author, and so forth) for the selected citation type.

    CitationLinkerLightbox.png

    Citation Linker Dialog Box (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 dialog box for Alma users.

    CitationLinkerLightboxAlma.png

    Citation Linker Lightbox for Alma Users (Classic UI)

    FetchItem_Alma_NewPrimoUI.png

    Fetch Item Page for Alma Users (New UI)

    For related information, see No Results for Citation Linker Article Title Search.

    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. For more details, see Code Table Reference.

    Citation Linker Definitions mapping table

    This table defines which OpenURL fields can be entered per citation type. You can enable/disable the display of fields on the form, but you cannot change their order. For more details, see Mapping table Reference.

    The display and mapping of additional fields is not supported.

    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 (Classic 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:

      Classic 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>