Viewer Services

Overview and instructions for creating digital resources and adding representations.

Viewing Digital Representations

You can view digital representations that you discover when searching the repository.

To view a digital representation:

Perform a search in the repository for digital titles.
Alma attempts to display a thumbnail image for the titles. If the title has a digital file, a thumbnail of that file appears. If no thumbnail is available, a generic image of the material type (book, video, music, etc.) appears.
- Alma viewers cannot preview files larger than 1GB. Files larger than 1GB will increase delivery time and cause the viewer to time out before previewing the file.
- Alma is not always successful in generating thumbnails from Microsoft Office documents, due to the technical limitations of the third-party tool being used for this.
- Files of auxiliary representations are not taken into account for thumbnail generation. If a title has only auxiliary representations, the standard thumbnail service for a non-digital title is applied, as described in Customizing the Thumbnail Display. The user can choose the thumbnail for each representation by selecting a thumbnail from file.
Select View It for a title. For each representation, the number of files and the file type appear.
- You can configure if representations are grouped by available viewers or listed separately. For more information, see Configure How Representations are Grouped in ViewIt/Primo.
- The results that appear in the View It tab are determined according to the display logic rules for the representation delivery service. For more information, see Configuring Display Logic Rules for the Representation Delivery Service.
If you do not have access rights to the representation, a notification appears.
This message is customizable when configuring the access rights for the representation.
If you have copyrights configured for the representation, an icon appears when selecting View It. This can be configured: for Primo at Configuration > Fulfillment > Discovery Interface Display Logic > Labels and for Primo VE at Configuration > Discovery > Display Configuration > Labels > View Labels.
Select the link to open the Digital Viewer (see The Digital Viewer).

The Digital Viewer

Alma includes a tool to view digital representation files called the Digital Viewer. The viewer displays JPG, GIF, and PNG images, PDF documents (with browser support), Microsoft Word documents, ePub books, and audio/video formats supported by HTML5 (the list may vary between browsers).

The viewer contains three panes:

The left pane appears only for representations with multiple files. The pane displays the files of the representation. Select an image to display it. Select the icons at the top of the pane to switch between thumbnail and list view.
The center pane displays the image, controls for an audio file or video file, or the text of a PDF file. Select the arrows at the top of the pane to move between files. If a file cannot be displayed, a download link appears. For example:
Unsupported File Type Download Link
The right pane displays bibliographic information.

You can perform the following actions from the Digital Viewer:

Select Download to download the currently-displayed file.
Select Language to change the language.
Select Share to display a link to the representation for sharing on social media or by email. To configure the social network sharing buttons, see Configuring Viewer Share Buttons.
Select Copyrights to display copyright information about the file (if any).
If you are not logged in to Alma, the Guest link appears. Select it to display the Sign In link. Select Sign In to display a login page. For information concerning configuring this feature, see Enable Delivery Login and Configuring Patron User Authentication.

On mobile devices the panes appear vertically.

An administrator can configure the labels in the viewer; see Configuring Viewer Labels.

The New Digital Viewer

In March 2020, a new Digital Viewer was introduced, with enhanced features over the legacy version. For information on configuring Alma to use the new viewer, see Configuring Viewer Services.

The new viewer has similar features as the legacy version, with the following enhancements:

Full-Text Display — the new viewer can display a full text file along with the digital one. To expand the pane with the full text, select the separator on the left side of the pane. To hide the full text file, select the Hide fulltext check box in the Digital Viewer configuration (Configuration > Fulfillment > Discovery Interface Display Logic > Viewer Services > Digital Viewer).
File-level Delivery — when selecting Share Focused File for a file in the new viewer and clicking Copy URL, the link provided opens to the selected file of the representation. Note that the Share Focused File checkbox appears only when there are multiple files in the representation.
Share Focused File
Closed Captions — select a captions language from the closed captions icon at the bottom of the viewer to display captions in that language. To turn off captions, select Captions Off.
For more information about configuring captions for video files, see Managing Digital Files from the Digital Representation Resource Editor.

The NDE Viewer

The NDE Viewer provides a streamlined and modern way for institutions to peruse digital content within the Next Discovery Experience (NDE). Designed to align with the updated NDE interface, this viewer enhances the user experience by offering direct access to supported digital formats, reducing reliance on external viewers, and simplifying navigation across representations. Clients benefit from improved consistency, faster access to content, and a more intuitive interface for exploring digital resources.

Supported Formats

The NDE viewer supports a set of digital formats most commonly used in archiving:

Images: JPEG, JP2, PNG, TIFF

Videos: MP4 (with captions and transcription)

Audio: WAV

Documents: PDF, TXT

Unsupported formats are handled via link-outs to the external viewer pages. A new viewer page opens in the browser, and a download link is provided. In order to support the use of the external viewer, the view_for_digital_viewer customer setting (Discovery > Other > Discovery Customer Settings) should be set with the non-NDE view to be used for the Digital viewer (in the format INST_NAME:VIEW_NAME).

Viewer Behavior

The viewer is embedded directly into the Full Display page, and can be expanded or collapsed. The default state of the Viewer can be configured in Configuration Menu > Fulfillment > Discovery Interface Display Logic > Display Logic Rules. If the Viewer is collapsed, select the "Digital Content" section to preview the content.

When a user selects a digital item from search results, the viewer automatically loads if the content is in a supported format, and the content is displayed in the viewer.

The viewer can be set to not display files larger than a certain threshold. If a file exceeds the threshold, the viewer will provide a download option for it. This feature is turned off by default and needs to be turned on in the Configuration Menu > Fulfillment > Discovery Interface Display Logic > Display Logic Rules.

The viewer may initially be expanded or collapsed for an item, depending on the configuration of Discovery Interface Display Logic rules (Configuration Menu > Fulfillment > Discovery Interface Display Logic > Display Logic Rules): if Representation Quick Access is configured to hide the item, the viewer is initially collapsed. Otherwise, it is initially expanded. When the digital item has multiple representations, if all the representations are configured to have the viewer initially collapsed, it is initially collapsed. If one or more of the representations is not configured to have the viewer initially collapsed, the viewer is initially expanded and the first representation of this kind is displayed in it. For information about configuring the Discovery Interface Display Logic rules, see Configuring Discovery Interface Display Logic for Primo VE.

By default, the title of the viewer is Digital Content. This title can be configured in the nde.digital.viewer.digitalContent label (Discovery > Display Configuration > Labels).

If the content is not supported, the system provides a link to an external viewer in which the user can view the resource. Institutions should configure a fallback viewer for this purpose during setup to ensure all formats are properly redirected.

Titles with digital loans (short term and long term) will not be supported in the embedded viewer in Primo NDE, rather will link out via the Digital Versions to support the full existing flows previously available.

The viewer offers different ways to preview the content:

Single: A single page is shown
Book: Two pages are shown side-by-side to improve the reading experience
Gallery: View all the titles as images on a single screen

Video and audio previewing

The Viewer enables you to open video and audio files without link-outs or sharing. You can even upload a transcript for your video and view it as full text. When previewing video resources, the viewer provides some additional features like:

Timestamp sharing and linking
Captions enhancement
Multilingual caption support
Transcript enhancement

Representations

The viewer initially displays the first supported representation of a digital item.

If multiple representations exist, or the only representation is not in a supported format, these representations can be accessed from the Digital Versions section below the viewer, as follows:

Representations that can be opened in the viewer have a Display in Viewer button (). If the representation is not currently open in the viewer, select the button (or the file name) to open it.
- If there are multiple representations, the user can turn through them directly in the right-hand side panel.
Representations in formats that are not supported by the viewer are identified by an arrow icon (). Select the arrow (or the file name) to open the representation in an external viewer.
If you are not logged into Primo VE, representations that can only be opened by logged-in users are identified by a lock icon () and the label, You do not have permission to view this object.

When an NDE page is accessed via link with a specific Representation ID (RepID), the viewer only displays the specific representation, and not every representation for the title. If the requested Representation is not accessible to the user, the system automatically falls back to the next available Representation based on the predefined order. Manual selection of a different Representation overrides the original RepID-based selection.

The Digital Versions section may be hidden in the Full Display of an item, depending on the configuration of Discovery Interface Display Logic rules (Configuration Menu > Fulfillment > Discovery Interface Display Logic > Display Logic Rules): if Representation Delivery Service is configured to hide the item, the section is hidden. Otherwise, it is included in the page. When the digital item has multiple representations, if all the representations are configured to have the Digital Versions section hidden, it is hidden. If one or more of the representations is not configured to have the section hidden, the section is displayed, but only those representations that are not configured to be hidden appear in it.

The priority for representation selection for processing is as follows:

First derivative
First primary
First modified primary
If none of these are available, the system takes the first representation that is

With titles with multiple representations in the Alma backend, users can page between all available representations directly within the RHS (Right-Hand Side).

Preview Features

Zoom controls: Use the zoom in or zoom out buttons in the viewer, or mouse scroll up or down while hovering on the representation to zoom in or out on the previewed resource. To reset the zoom to its original size, select the reset zoom button in the viewer's control panel.

Scroll preview: Move through representations by selecting the next item and previous item buttons in the viewer.

Download option: download the resource in the represented format by selecting the download button on the left-hand side of the viewer.

Expand to full-screen view: To view the resource across the entire screen, select the full-screen button on the left-hand side of the viewer.

Preview layout: Users can change between single tile, gallery, page, book, or scroll view by selecting the views icon on the left-hand side of the viewer. The Book view previews two pages at a time, for an optimal viewing experience. The Scroll view enables the continuous scroll, and is suitable for large IIIF resources.

Content Exploration Features

Index: The index option shows all the resources tied to the title that are available for viewing. To view the list of resources, select the Content button in the viewer.

Search: Primo NDE viewer supports in-image text search if the institution has uploaded full text for their digital content. To search for text in the resource, select the search button in the viewer.For more information, see Tesseract OCR Extraction and ALTO Generation.

Copyright: Primo NDE Viewer enables the user to preview resource copyright limitations. To view the copyrights, select the copyrights button on the left-hand side of the viewer.

Additional Features

Sharing: Share the resource by selecting the Share button on the upper right-hand side above the viewer and choosing the method of sharing.

The extended IIIF Share options from the viewer enable representation-level sharing options. Includes copy of Manifest and direct link to representation.

Share options are removed for staff. They are only available on the Primo NDE end-user facing viewer.

Citation: Create citations for the record in various formats by selecting the Citation button on the upper right-hand side above the viewer and choosing the citation format from the dropdown.

Export: To export the resource, select the Export button on the upper right-hand side above the viewer and choose the export format.

Saving: Add the representation to saved records by selecting the Add to Saved Records button on the upper right-hand side above the viewer.

Usage OBI Analytics: The viewers' actions: view, download and share in Primo NDE are now tracked via the OBI Analytics for digital content.

Accessibility: Options include: rotate, flip, brightness, contrast, greyscale, saturation, invert colors, and revert image.You can also select the view layout: single title, book, or gallery layout.