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

    Digital Services

    1. Last updated
    2. Save as PDF
    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.

    • Universal Viewer – 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).
    • 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.

    viewer_services_details.png
    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.

    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 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.
    fullfilment_other_settings.png
    Other Settings Page under Fulfillment Configuration

    Include Representation Services Statistics in Analytics

    The Include Representation services in link resolver statistics parameter allows 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 allows 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 allows 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 allows 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’s collection page in a new tab.

    This feature is available only for Primo VE customers.

    Using Standard Identifiers

    With the Find GetIt services based on standard identifiers only parameter (Configuration Menu > Fulfillment > Discovery Interface Display Logic > Other Settings), the Primo/Primo VE Get It feature (that you select to request/discover local Alma physical holdings) uses the following strong standard identifiers:
    • ISSN
    • E-ISSN
    • ISBN
    • E-ISBN
    • LCCN
    • CODEN
    • OCLC Unique Number
    • Other System Number
    Using strong identifiers generally provides better results. For more details regarding the identifiers, see Commonly Used OpenURL Attributes for the URL Template.
    By default, this option is not selected; and the original logic for matching on title or title + author is used. This weaker matching criteria may provide less desirable Get It results.
    Note that when you select Get It from your Primo/Primo VE search results and the Find GetIt services based on standard identifiers only parameter is selected, holdings that were received from an OpenURL (in your Primo/Primo VE search results) are ignored when Alma processes the Get It request if those holdings do not include or match on any of the strong standard identifiers shown above.