The Ex Libris Secure FTP Service provides a homogeneous FTP solution to all institutions while simplifying operations, improving security, and user experience. The service allows you to store data on the Ex Libris cloud platform.  Available as of the December 2020 release.  In this post we'll demonstrate how to set up an FTP connection to…

The Global Representation Changes Job offers the option to batch update various representations properties. It is a robust job that uses the Alma jobs infrastructure and allows updating several properties at once. However, in some cases a more customizable approach may be desired. In this post, a basic Python-based tool for updating representation properties via…

The PSNR File Comparison Plugin analyzes similarities between a source and target (alternative) file as part of a migration execution, allowing users to set set a minimal value below which Rosetta would consider the migrated image unsatisfactory and fail the plan. For further information, see this blog post.

The Rosetta Deposit Tool is a Java-based client that library staff can use as an alternative to the Rosetta web deposit module for submitting simple content to Rosetta from a Windows environment. It provides a configurable Dublin Core metadata form and a file upload interface for creating an IE with a single representation and one or…

This article explains how to generate and publish Handle persistent identifiers (henceforth: 'Handle PI' or 'PI') for Alma records. It assumes the existence of a functioning local Handle server (including an institution prefix) and basic knowledge of Handle. Information on how to install and configure a Handle server and the Handle framework in general is…

The Rosetta Deposit Tool is a Java-based client that library staff can use as an alternative to the Rosetta web deposit module for submitting simple content to Rosetta from a Windows environment. It provides a configurable Dublin Core metadata form and a file upload interface for creating an IE with a single representation and one or…

Institutions can customize the XSL transformation that displays collection, IE- and file-level metadata in the viewers. This gist provides examples of the exported raw XMLs that are transformed. See also Rosetta Staff User Guide, Ch. 8: Delivery XSLs.

Alma digitization flows can be configured to result in adding digital inventory to an existing bibliographic record. If the digitized content is considered worthy of preservation, libraries can choose to ingest content into Rosetta and manage in Alma as remote representations rather than ingesting into Alma. This process can be done manually, with Alma staff…

Alma March 2017 release includes a new feature that enables the service tab (ViewIt) to indicate to a patron that access to a remote representation is denied by the remote repository. Until now, such an indication was supported for Alma representations only. In order for Alma to present this indication, the remote repository must support…

Rosetta 5.1 introduces a new plugin interface: File Comparison. Plugins of this type can be used during a preservation action to compare the original and migrated files using any tool. The plugin returns a single integer. Currently only script implementations are supported. Previously, during a preservation action, Rosetta could only compare original and migrated files…

Rosetta 5.1 introduces a new version of the antivirus plugin interface. The new version supports an additional exit code, as follows: '0' - scan result is negative (= no virus found) '1' - scan result is positive (= virus found) > 1 - scan result is undetermined An 'undetermined' result should be used when the…

In this post we will show how to add a new source metadata subtype, using VRA Core as an example. If you have not worked with source metadata in Rosetta before, it is recommended to read this post first. Note: This procedure requires restarting all Rosetta REP servers to take effect (this can be done…

Rosetta 5.1 includes Collection webservice APIs for setting and deleting a collection thumbnail. The setCollectionThumbnail API accepts a base-64 encoded image as a string. The following script can be used to encode a thumbnail image and call the API: require 'savon' require 'base64' if ARGV.length < 2 puts "usage: ./set_collection_thumbnail.rb pdsHandle collectionId" exit end wsdl…

Rosetta 5.1 introduces a relatively large number of new and improved web services. The purpose of this post is to list these in one place, more elaborately than what the Release Notes format allows for. All changes are backward-compatible.   SIP Web Services getSIPStatusInfoByExternalId This new web service returns a SipStatusInfo object for a SIP…

Alma supports two types of source formats for batch loading Dublin Core records for digital inventory: XML and CSV. Working directly with XML can be straightforward when using a dedicated editor; in some cases working in a spreadsheet may be preferred. Alma support for CSV is limited to unqualified Dublin Core elements, so if your…

This post covers the various high-level aspects of working with source metadata in Rosetta, from submission to dissemination. Users should consult the official Rosetta documentation for specific details and instructions. Note: This post has been updated to reflect changes in v6.1. See here for details. What is source metadata? Generally speaking, source metadata is one…

Emails to Rosetta depositors can be customized using XSL stylesheets. This example contains the full email XML to be transformed. For further information, see the Rosetta Staff User Guide.

Rosetta's Access Rights Plugin interface enables libraries to extend Rosetta's native access rights policy conditions and apply custom logic or integrate with external DRM systems. This simple example demonstrates how a token, appended to the delivery URL, is checked against the ORCID (sandbox) system and allows access only if the token is valid (i.e. the…

Rosetta's Viewer Pre-Processor (VPP) framework allows users to manipulate data before delivery to adapt it for Viewer specifications. Rosetta's out-of-the-box viewers all come with pre-installed accompanying VPPs. The JPEG VPP utilizes ImageMagick to transform images of various formats to JPEG format for browser rendering. In some cases users may wish to apply customization that require…

While Alma manages the metadata and workflows related to print and electronic resources, digital resources are unique in that the objects themselves are also stored in Alma. Alma enables library staff to manage digital workflows and objects through its usercollection_external interface, hiding the complexity of cloud storage, and offers integrated resource delivery to patrons via…

Alma's January 2016 Release provides a brand new infrastructure for managing digital assets. This release contains core functionality to support day-to-day digital curation workflows, and additional features will be released throughout the coming years on a monthly basis. Alma uses the Amazon Web Services (AWS) Simple Storage Solution (S3) cloud storage service as the backend…

The Alma Digital Migration Tool can be used to migrate digital content from an external OAI-PMH supporting repository. The tool consists of two files: * config.rb - the configuration file * migrate.rb - the script Dependencies: Ruby (tested using v. 2.1.7) A valid AWS credentials file (see here for setup and https://developers.exlibrisgroup.com/alma/integrations/digital/almadigital on how to generate your…

Updating IE Metadata with the Update Metadata Job You can streamline IE-level descriptive metadata updates from an external source without developing an external application. Instead of submitting UpdateMD SOAP requests, you can simply place the UpdateMD files on a designated NFS location and schedule a job to process them in bulk. The job is conceptually…

A vanilla implementation of Rosetta OOTB NFS Storage Plug-in with source code is now available on github as CustomNFSStoragePlugin. All dependencies are in the dps-sdk package.

This package contains a set of RESTful APIs that provide common Rosetta functions. They can be used in a standalone REST client or embedded in an application. The Rosetta REST APIs are based on the SCAPE Data Connector APIs version 1.1. See https://github.com/openpreserve/scape-apis for more information. Only the methods described here are implemented. All requests…

Rosetta startup checker plugins are used to confirm all Rosetta critical components are available and/or functioning properly. They are run during startup and once a day at midnight. The Rosetta DiskSpaceChecker Plugin is a startup checker plugin that provides administrators with information about free space on mounted storage. While disk management is usually the responsibility…

Rosetta comes with a reporting database schema that can be used to extract data and create custom reports with BIRT. General instructions on how to set up your environment and deploy your report are provided here, and should be consulted before reading this post (or building your own report). To take full advantage of the…

Migrating your digital content to Rosetta has just become much easier with Rosetta 4.1. In the past many institutions have opted to create complex submission applications that extract data from legacy systems and create Rosetta SIPs. As of version 4.1, any repository that supports OAI-PMH can publish data for direct harvesting by Rosetta. The Rosetta…

As of the September Alma release, the Analytics API is RESTful. Like other REST APIs, documentation is available in the Alma section of this website. The following post provides some more detail for advanced users. Reports resource The reports resource (/almaws/v1/analytics/reports) requires one mandatory request parameter: path. The path is a URL-encoded full path to…

In a previous post, we saw how to create a plug-in to generate derivative JPG files from a PDF file, noting this can be used for delivery using the IA Book Reader, which requires JPG format. In this post we'll demonstrate how to use the plug-in for this purpose. Installing the plug-in Once the plug-is…

Rosetta 4.0 uses migration-tool plug-ins to generate derivative copies (instead of the legacy stream handlers). These plug-ins are used by Transformation Profiles (another 4.0 feature) which allow users to determine a many-to-one (merge) or one- to-many (split) relation between the original file and the derivative copy, in addition to the one-to-one relation, supported by the…

Note (24-Nov-2019): This post refers to Jpylyzer v1 only. Jpylyzer is a validator and feature extractor for JP2 images. It can be integrated in Rosetta as an implementation of a technical metadata extractor plugin. For more information about the tool, please see here. Jpylyzer requires Python 2.7 (earlier versions won’t work), or Python 3.2 or…

The following explains date-time format policy in Alma APIs. Although each Institution in Alma has a time-zone defined, and working with the UI displays the date/time fields after converting to its time-zone, we prefer that APIs will be more natural in a sense that the date will be returned in GMT.   GET Alma returns…

JW Player is an audio/video player that can be integrated as a Rosetta viewer. Note: It is recommend to use version 5.10, tested by Rosetta development. The viewer does not work with JWPlayer v.6 since it is HTML5 based, and Rosetta's implementation uses the flash option. To install the player, please follow these steps: Clone…

Running JHOVE validation with XML-HUL requires access to all referenced XSDs and DTDs in the xml file. This can cause significant performance issues during the validation process. In order to address this problem, the JHOVE XML-HUL plugin uses an alternative method: XML cataloging. This allows storing copies of all XSDs on the Rosetta environment and…

Overview Sentry is an Access Control System that controls entry to facilities such as libraries or reading rooms where access requires monitoring. To do so, Sentry requires user information from Alma. Alma-Sentry integration is based on a dual approach of retrieving Alma user details via web services, and exporting user details via Alma Analytics for…

A risk extractor plugin wrapper for the DRMLint tool can be used to identify DRM issues as risks in Rosetta. More information on the DRM tool can be found on github. The wrapper was developed as part of the SCAPE project and can be downloaded here. Deploy in Rosetta as custom plugin and associate with…

IIPImage is an advanced high-performance feature-rich image server system for web-based streamed viewing and zooming of ultra high-resolution images. Follow the instructions below to integrate IIPImage as an external Rosetta viewer. For more details, please visit the IIPImage website. The VPP Plugin can be downloaded from here; iipzoom.html is available here. Download and install IIPImage server…

The Alma RESTful API supplies an interface that supports direct interactions with other applications via HTTPS. Because the REST API is based on open standards, you may use any web development language to access the API. This post will help you get started developing with Alma APIs. Setting up A simple way to test your…

Rosetta allows using different storage solutions, implemented as instances of the Storage Handler plug-in. Each plug-in instance uses a list of methods that can implement HTTP requests for exchanging files, between Rosetta and the storage layer. The plug-in parameters are the unique attributes of each storage type (e.g. bucket name. secret access key in S3)…

JHOVE MD Extractor Plugins are updated as part of the Format Library update. This workflow is for customers who wish to install new JHOVE Extractor versions locally for testing purposes or to use while waiting for a FL update release.Note: The following steps must be done for each relevant JHOVE module. This will create a…

Overview Rosetta allows using different storage solutions, implemented as instances of the Storage Handler plug-in. Each plug-in instance uses a list of methods that can implement HTTP requests for exchanging files, between Rosetta and the storage layer. The plug-in parameters are the unique attributes of each storage type (e.g. bucket name. secret access key in…

The IA Book Reader is an External Viewer that can be integrated with Rosetta. The viewer has been enhanced to deliver jpg images with ALTO in the form of book pages and highlighted search terms: The VPP requires separate representations for images and ALTO files. Both representations should be included in the representation profile that…

The IA Book Reader is an External Viewer that can be integrated with Rosetta. This viewer can show images (JPEG, JP2000, PNG) in the form of book pages, which makes it a great option for delivering scanned books. The IA Book Reader VPP prepares the IE for delivery by confirming the files' format is supported, copying all…

D10SumChecker is a tool for ensuring the integrity of MXF D10 Files. It was developed as part of the PrestoPrime project. The tool code is available at the PrestoPRIME Preservation Platform repository.   The tool is wrapped here as a CustomFixity plugin and utilizes the CustomFixity plugin open interface. Please see Rosetta Release Notes v.…

General Purpose Some institutions deposit very large master PDF files. A lower-quality version needs to be created to deliver to end users. This example shows how to use the stream handler interface to create derivative copies. Product Version Compatibility 3.x. Interface Type Stream handler. Flow Create the conversion script. Create a new stream handler. Create…