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

    Digital Services

    Translatable

    Configuring Viewer Services

    To configure viewer services, you must have one of the following roles:
    • General System Administrator
    • Fulfillment Administrator
    You can configure the digital file viewers that may appear after selecting to view a digital file (after selecting View It on the search results page; see Link Resolver for Institutions Using Distributed Electronic Resources). For more information, see the Developer's Network documentation at https://developers.exlibrisgroup.com/alma/integrations/digital/almadigital/access. Also see the parameter delivery_service_allowed_origins in Configuring Other Settings.

    Out of the box, Alma supports the following digital viewers:

    • Alma Viewer – Alma’s default viewer uses the browser’s HTML5 players, which are capable of displaying any format that is natively supported by the browser (such as various video, audio, and image formats). For other formats, it provides a download option. The Alma Viewer supports the display of captions. For information about configuring captions, see see Managing Digital Files from the Digital Representation Resource Editor.

    • Universal Viewer – This is an open-source project that is deployed in Alma.This type of viewer is based on IIIF (International Image Interoperability Framework) and provides advanced capabilities for viewing high-resolution images for tiff, jpeg, and jpeg2000 formats (such as rotate and zoom-in/zoom-out actions), as well as PDFs and audio and video files. (New for May!) In addition, the Universal Viewer supports the 3D formats .glb and .gltf. (Note that for .gltf, only files that actually contain the data are supported, not those that are just pointers to the actual file.) The Universal Viewer supports the display of captions. For information about configuring captions, see Managing Digital Files from the Digital Representation Resource Editor.
    • Internet Archive Book reader – This type of viewer is based on IIIF and provides capabilities for viewing images. In addition, it allows users to perform text searches in digital files when a full text file is uploaded to Alma. 
    You can enable, disable, edit, add and remove digital viewers on the Viewer Services page (Configuration Menu > Fulfillment > Discovery Interface Display Logic > Viewer Services).
    viewer_services.png
    Viewer Services
    Drag the services and rearrange their order to change the order in which they appear on the View It tab.
    To add a digital viewer, select Add Service.
    add_viewer.png
    Add Digital Viewer

    Configuring the Service Availability Rules for a Viewer

    You can configure the service availability rules for a viewer.

    To configure the service availability rules for a viewer:
    1. Select Edit for a viewer and select the Service Availability Rules tab.
      service_availability_rules.png
      Service Availability Rules
    2. Select Add Rule. The following appears:
      add_service_availability_rule.png
      Add Service Availability Rule
    3. Enter a name and description.
    4. In the Input Parameters section, select Add Parameter. The following appears:
      add_parameter.png
      Add Parameter
    5. Select a name, operator, and value, and select Add parameter.
    6. In the Output Parameters section, select True or False from the Display drop-down list to determine if the viewer is displayed when the rule is true or when it is false.
    7. Select Save.
    The rule is added to the list of service availability rules.

    Configuring the Alma Viewer

    You can configure the Alma Viewer.

    To configure the Alma Viewer:

    Select Edit for the Alma Viewer and select the Service Details tab.

    Alma Viewer.
    Alma Viewer Service Details
    The following configuration options are available:
    • Hide Repeated Labels – display repeated labels in a list under the label.
      If you enter a delimiter in the Delimiter for Grouping Repeated Delivery Metadata field located at Configuration > Fulfillment > Discovery Interface Display Logic > Other Settings, this field does not appear. To have it appear, you must remove the delimiter. For more information, see Configuring Other Settings.
    • Use New Viewer – display digital resources using the New Alma Viewer.
    • Hide Fulltext – Hide the display of full text in the New Alma viewer.
    • Expand Content Pane – clear to collapse the Content pane by default. 
    • Expand Description Pane – clear to collapse the Description pane by default. 
      When the panes are collapsed, the buttons and file label are all located in the same toolbar.
    • PDF Default Zoom – select an option from the drop-down list to set a default zoom for PDF files

    Customizing the Alma Viewer Using Primo Studio

    You can customize the Alma Viewer using Primo Studio.

    To customize the Alma Viewer using Primo Studio:
    1. Select Edit for the Alma Viewer and select the Customization tab.
    2. Select a Primo View and a Representation ID to use as an example when configuring the viewer.
    3. Select Generate Link. The Open Primo Studio link appears.

      customization_tab.png

      Customize the Alma Viewer using Primo Studio
    4. Select Open Primo Studio to open Primo Studio and customize the viewer.

    For more information on using Primo Studio, see Using Primo Studio.

    Configuring the Universal Viewer to Display the Download Original File Icon

    You can configure the Universal Viewer to display the Download Original File icon.

    To configure the Universal Viewer to display the Download Original File icon:
    1. Select Edit for the Universal Viewer and select the Service Details tab.
      display_original_image_download_link.png
      Universal Viewer Service Details
    2. Select the Display Original Image Download Link to display the Download Original File icon in the Universal Viewer.

    Configuring the Default Display of the Internet Archive Book Reader

    You can configure the default display of the Internet Archive Book Reader.

    To configure the default display of the Internet Archive Book Reader:
    1. Select Edit for the Internet Archive Book Reader.
    2. From the Default Display drop-down list, select one of the following options:
      • Single-page
      • Two-page
      • Thumbnail view

    Configuring Right-to-Left Paging for the Internet Archive Book Reader

    You can configure the Internet Archive Book Reader to display right-to-left paging when reading books in right-to-left languages. To configure this feature, select Paging Direction by Content Language from the Service Details tab (Configuration > Fulfillment > Discovery Interface Display Logic > Viewer Service > Internet Archive Book Reader).

    paging_direction_by_content_language.png

    Paging Direction by Content Language

    When selecting Paging Direction by Content Language, Alma checks the 008 field or the dc:language field of the bibliographic record of the book. If the language code is one of the following right-to-left languages, the book is displayed with right-to-left paging:

    • ara - Arabic
    • arc - Official Aramaic (700-300 BCE); Imperial Aramaic (700-300 BCE)
    • aze - Azerbaijani
    • div - Divehi; Dhivehi; Maldivian
    • per - Persian
    • fas - Persian
    • hau - Hausa
    • heb - Hebrew
    • kas - Kashmiri
    • khw - Khowar
    • kur - Kurdish
    • pus - Pushto; Pashto
    • sam - Samaritan Aramaic
    • syc - Classical Syriac
    • syr - Syriac
    • urd - Urdu
    • yid - Yiddish

    Configuring Other Settings

    On the Other Settings page (Configuration Menu > Fulfillment > Discovery Interface Display Logic > Other Settings), additional settings are available to configure how Alma information appears in Primo and Primo VE. Depending on your institution's settings, different options may display.
    PVE_DisplayLogic_OtherSettings.png
    Other Settings Page under Fulfillment Configuration

    Enable Display of License Information

    Alma enables you to display an electronic resource's license information in View It. The displayed terms of the license can be configured in Alma, as well as the license-related labels that display in View It. See Displaying License Information.

    Enable Display of Access Model

    To control the presentation of the access model to patrons via Alma Link Resolver, institutions can use a designated configuration. Select the checkbox Enable Display of Access Model to display in Primo and Primo VE the access model information located on the portfolio. The Enable Display of Access Model option is disabled by default. Institutions that want to control the presentation of the access model to patrons via Alma Link Resolver, need to select the Enable Display of Access Model option. See also Managing Access Models.

    Include Representation Services Statistics in Analytics

    The Include Representation services in link resolver statistics parameter enables you to include representation services usage in analytics link resolver statistics.

    Enable Delivery Login

    You can determine if the delivery login link from the Alma Viewer and from digital services in the link resolver is displayed. For more information, see The Alma Viewer.

    Configure Maximum Number of Representations in ViewIt/Primo

    The Max. Number of Representations in View It parameter enables you to define the maximum number of digital representations that appears in View It. If there are more representations to display than the number configured here, a More... link appears. The patron can select More... to display the full list of representations available in a new browser tab.

    Configure Order of View It Services

    The Order of ViewIt Services parameter enables you to configure whether electronic or digital services appear first in View It. Select Electronic, Digital or Digital, Electronic.

    Configure How Representations are Grouped in ViewIt/Primo

    To configure how representations are grouped in View It, select an option from the Group Representation Delivery Services by drop-down list:
    • Viewer – representations are grouped by viewer
    • Representation – representations are listed separately with the available viewers for each representation.

    Configure a Delimiter for Grouping Delivery Metadata with Repeated Labels

    To configure a delimiter for metadata with repeated labels in digital viewers, enter a delimiter to the Delimiter for Grouping Repeated Delivery Metadata field.

    If you enter a delimiter in the Delimiter for Grouping Repeated Delivery Metadata field, the Hide Repeated Labels checkbox for the Alma Viewer in Configuration > Fulfillment > Discovery Interface Display Logic > Viewer Services > Alma Viewer does not appear. To have it appear, you must remove the delimiter. For more information, see Configuring Digital File Viewer Services.

    Use Primo VE Metadata Fields for Delivery

    For Primo VE customers only, you can configure the metadata fields that appear in Alma viewers with the same page that you use to configure the metadata fields for Primo VE. This enables you to display the same descriptive information in Alma viewers as you do in Primo VE. To enable this feature, select the Use Primo Metadata Fields for Delivery check box. For information on how to configure metadata for Primo VE, see Configuring the Details Service for Primo VE.
    AlmaViewer_DescriptiveInformationExample.png
    Descriptive Information in the Alma Viewer

    When this check box is selected, the method used to configure metadata for Primo VE replaces the Alma method, and the following options are disabled:

    • The Delimiter for Grouping Repeated Delivery Metadata field on this page is disabled.

    • The Delivery Profiles Metadata page (Configuration > Fulfillment > Delivery Profiles Metadata) is hidden. For more information on this method, see Configuring Delivery Profiles Metadata.

    Display Collection Path in Viewer

    Select the Display Collection Path in Viewer checkbox to display the collection path at the bottom of the Descriptive Information pane for all viewers. Selecting the path opens Primo VE’s collection page in a new tab.

    This feature is available only for Primo VE customers.

    Find GetIt services based on standard identifiers only

    Primo/Primo VE Get It (used to request/discover local Alma physical holdings) uses specific standard identifiers. For more information see Using Standard Identifiers.

    Enable Inactive Representations for Thumbnails

    Select the Generate thumbnails from inactive representations checkbox if you want to enable the use of inactive representations to generate thumbnails for your records in Primo and Primo VE. 

    Configuring the Collection Title Sorting Routine

    The Collection Title Sorting Routine mapping table (Configuration Menu > Fulfillment > Discovery Interface Display Logic > Collection Title Sorting Routine) configures the sort options that display in the Sort titles by drop-down list on the Discovery tab of the Electronic Collection Editor (Resources > Manage Collections > Edit Collection > Discovery Tab). For more details, see Configuring the Default Sorting for Titles in Collections.

    Alma_CollectionTitleSortingRoutine_MT.png

    Collection Title Sorting Routine

    For Alma-Primo environments only, the active codes in this table must match the codes defined in Primo's Sort Fields Config mapping table (Primo Home > Advanced Configuration > All Mapping Tables > Sort Fields Config).