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

    Adding Links to the PNX

    This information is not applicable to Primo VE environments. For more details on Primo VE configuration, see Primo VE.
    Links that relate to a specific record are always stored in the links section in the PNX. As noted above, the links can be static and transferred with no change from the source record, or they can be a template as shown below:
    <links>
        <openurl>$$Topenurl_journal</openurl>
        <backlink>$$Taleph_backlink$$Ebacklink</backlink>
        <linktorsrc>$$Uhttp://purl.access.gpo.gov/GPO/LPS70411$$DOn campus access only</linktorsrc>
        <thumbnail>$$Tamazon_thumb</thumbnail>
        <thumbnail><links>$$Tgoogle_thumb</links></thumbnail>
        <linktotoc>$$Tamazon_toc$$Elinktotoc</links></linktotoc>
        <openurlfulltext>$$Topenurlfull_journal</openurlfulltext>
        <linktoholdings>$$Taleph_holdings</linktoholdings>
        <linktouc>$$Tamazon_uc$$Eamazon</linktouc>
        <linktouc>$$Tworldcat_isbn$$Eworldcat</linktouc>
    </links>
    Static links should be prefixed by $$U, as shown in the following example:
    <linktorsrc>$$Uhttp://purl.access.gpo.gov/GPO/LPS70411$$Don campus access only</linktorsrc>
    Template codes should be prefixed with $$T, as shown in the following example:
    <linktotoc>$$Tamazon_toc$$Elinktotoc</linktotoc>
    The template codes are defined in the Templates mapping table. For more details, see Mapping Table Reference.
    In addition to the URL and template codes, the link fields can include the following prefixes:
    • $$D or $$E (local records only) – These prefixes enable you to configure the text that displays for links that display in the record's full display. The text can be mapped to the PNX either as simple text (which must be prefixed with $$D) or as a code (which must be prefixed with $$E), which allows you to customize/translate the display text with the Full Display Labels code table.
    • $$F/$$G or $$E (CDI only) – For the links/linktorsrc and links/linktorsrcadditional PNX fields only, CDI returns the following prefixes only if CDI has provider information:
      • $$F – Contains the Access_content_in code, which enables you to customize/translate the link's display text in the Full Display Labels code table.
      • $$G – Contains the provider's name, which is used in the display of the link if the {{provider}} parameter is included in the links configuration for $$F. Note that the provider's name cannot be customized, but it can be omitted.
      If no provider is available in CDI, CDI returns only the following information:
      • $$E – Contains the View_full_text_in_collection code, which enables you to customize/translate the link's display text in the Full Display Labels code table.
    • $$H (CDI only) – contains an open access indication if included in the links/linktorsrcadditional field. This subfield should include the text free_for_read if the link is Open Access.
    • $$I – allows you to add an institution code to links. This will ensure that the link is visible and used only by users who belong to the institution in $$I. Only one institution can be defined.

      For example, there is a dedup record to an online e-book that requires a subscription to access it and the Primo installation is a consortium. You can add $$I to the link so that it only displays in the Details tab and is only used by the delivery manager for users belonging to INST1 and INST3. These links may appears as follows in the PNX record:

      Links/linktorsrc $$Uhttp://www.ebsco.com/book1$$DElectronic version$$IINST1
      Links/linktorsrc $$Uhttp://www.ebsco.com/book1$$Delectronic version$$IINST3
    • $$A - $$Z/$$a - $$z/$$0 - $$9 – allows you to include data required for the link. In most cases, the data that is required for the link is present in the PNX (such as the source system number or ISBN). If this is not the case, it is possible to add this data to the link field using the prefix $$, followed by any digit or English letter. The digit or letter can then be used in the template as a placeholder. This option does not apply to static links.

      For example, if the template is defined as follows:
      http://purl.opac.access/Vakka/search.action?series={{$$1}}}&avain={{control/addsrcrecordid}}}
      And the PNX record contains the following link information:
      <links>
      <backlink>$$TMYINST_ds1_backlink$$Eds1_backlink$$1AY</backlink>
      </links>
      The system will display the URL in the FE as follows:
      http://purl.opac.access/Vakka/search.action?series=AY&avain=SARK__5401.SARK