• Avatar Opher Kutner
  • File Comparison Plugin
    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.

    ROSETTA

    Rosetta Deposit Tool
    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…

    ROSETTA

    Generating a Handle Persistent Identifier in Alma
    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…

    ALMA

    Rosetta Deposit Tool
    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…

    ROSETTA

    Customizing Metadata Display in Your Viewer
    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.

    ROSETTA

    Preserving Digitized Alma Content with Rosetta
    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 ROSETTA

    Remote Repository Access Rights In Alma
    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…

    ALMA ROSETTA DIGITAL

    Rosetta File Comparison Plugin
    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

    Rosetta Antivirus Scan Plugin - V2
    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…

    ROSETTA

    Adding a New Source Metadata Subtype
    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

    Setting a Collection Thumbnail by API
    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

    Web Service Updates in Rosetta 5.1
    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…

    ROSETTA

    Creating Dublin Core XML Files Using Excel
    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…

    ALMA

    Working with Source Metadata in Rosetta
    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. What is source metadata? Generally speaking, source metadata is one of four administrative metadata types permitted in the administrative metadata section (amdSec) types permitted by…

    ROSETTA

    Customizing Emails to Depositors
    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

    Creating a Custom Access Rights Plugin
    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

    Customizing Image Delivery
    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…

    ROSETTA

    Migrating Your Digital Resources to Alma
    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 DIGITAL

    Calculate Your Alma Storage in Use with AWS S3 CLI
    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…

    ALMA DIGITAL

    Alma Digital Migration Tool
    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…

    ALMA DIGITAL

    Metadata Update Job
    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…

    ROSETTA

    NFS Storage Plug-In
    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.

    ROSETTA

    Rosetta REST APIs
    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

    Rosetta Storage Space Checker
    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

    Adding a BIRT Report to Rosetta
    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…

    ROSETTA

    Migrating Your Digital Repository to Rosetta
    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…

    ROSETTA

    Working with Analytics REST APIs
    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…

    ALMA

    Using the IA Book Reader to Deliver PDF Content
    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

    Creating a Migration-Tool Split Plug-in
    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…

    ROSETTA

    Jpylyzer Technical Metadata Extractor Plugin
    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 later (3.0 and 3.1 won’t work).   Installation Instructions…

    ROSETTA

    Time-zones and Dates in Alma APIs
    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…

    ALMA

    Integrating JW Player as a Rosetta Viewer
    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…

    ROSETTA

    Adding an XSD Schema to JHOVE XML-HUL
    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…

    ROSETTA

    Alma-Sentry Integration
    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…

    ALMA

    DRMLint Risk Extractor
    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…

    ROSETTA

    IIPImage Viewer VPP
    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…

    ROSETTA

    Getting Started with Alma REST APIs
    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. To learn about available resources, authentication and other…

    ALMA

    Amazon S3 Storage Plug-In
    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)…

    ROSETTA

    Updating a JHOVE MD Extractor Plugin
    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…

    ROSETTA

    NFS Pair Tree Storage Plug-In
    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…

    ROSETTA

    Integrating IA Book Reader with ALTO Support as a Rosetta Viewer
    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…

    ROSETTA

    Integrating IA Book Reader as a Rosetta Viewer
    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…

    ROSETTA

    D10 Sumchecker (as CustomFixity plugin) for MXF files
    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.…

    ROSETTA

    PDF derivative copy stream handler
    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…

    ROSETTA