Digital Services

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

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

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

Select Edit for a viewer and select the Service Availability Rules tab.

Service Availability Rules
Select Add Rule. The following appears:

Add Service Availability Rule
Enter a name and description.
In the Input Parameters section, select Add Parameter. The following appears:

Add Parameter
Select a name, operator, and value, and select Add parameter.
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.
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 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.
New For February! Expand Content Pane – clear to collapse the Content pane by default.
New For February! 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.
New For February! 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:

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

Customize the Alma Viewer using Primo Studio
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:

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

Universal Viewer Service Details
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:

Select Edit for the Internet Archive Book Reader.
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

New for February!

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

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.

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.

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.

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).