Ready to Learn?Ex Libris products all provide open APIs

Tech Blog

 

Rosetta Deposit Tool

Opher Kutner on August 10th, 2017

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 more files. The tool requires Java 8 or higher.

Instructions for Rosetta Administrators

Rosetta administrators will need to provide users with a deposit.properties configuration file that contains the settings that will allow each user to deposit content using the appropriate material flow. 

Also, since communication with the Rosetta deposit server is via FTP and credentials need to be provided to the staff user, administrators may wish to create a user with appropriate permissions.

The deposit.properties file should contain the following parameters:

  • deposit.url - http://<deposit-load-balancer-host>:<port>/dpsws/deposit/
  • repository.url - http://<rep-load-balancer-host>:<port>/dpsws/repository/
  • backoffice.url - http://<rep-load-balancer-host>:<port>/dpsws/backoffice/
  • institution - the staff user's institution code, e.g. INS00
  • material.flow - the material flow ID that will be deposited to. See below.
  • deposit.temp.dir - a tmp directory on the local PC.
  • ftp.host - Rosetta deposit server host.
  • ftp.port - ftp port, e.g. 22
  • ftp.temp.di - the submission format path.

An example file is available here.

 
The material flow must comply with the following:
  • Automatic
  • An NFS submission format
  • A simple set of files (SoF) content structure
  • A single Access Rights Policy

 

Instructions f‚Äčor Rosetta Users

Installation and Configuration 

  1. Download and unzip the tool.
  2. Open metadata.txt and select Dublin Core properties for your form. You can also include a default value:
    metadata
  3. Open edit uilabels.txt to make any changes to the tool's UI labels.
  4. Replace the content of deposit.properties with the file provided to you by your administrator.

 

Running the Tool

The tool comes with a run.bat file. Click on it to run the tool.

Enter your Rosetta username and password, and your FTP user and password as provided to you by your administrator.

Add metadata and upload your files.

upload1

Click Submit. The tool will submit content to Rosetta and provide you with a Deposit Activity ID and SIP ID for tracking. 

upload2

 

 

The tool is not an official part of the Rosetta system and is provided as is. The code is available in this Github Repository