SWORD

SWORD Deposits

Alma supports the SWORD v.2.0 protocol – a standard lightweight protocol for depositing content from one location to another.  It stands for Simple Web-service Offering Repository Deposit and is a profile of the Atom Publishing Protocol. For full information about SWORD, visit the SWORD website.

This page contains basic information about how SWORD is supported in Alma, namely, details about required Alma configuration and Alma’s SWORD server. After reading this, you may want to consult the following blog posts for ideas how to implement your own SWORD services with Alma.

Deposit Configuration

Before you can use SWORD to accept deposits, you must first set up one or more Deposit Profiles. Refer to Alma documentation for instructions.

Configuring your SWORD Integration Profile

Follow the instructions in Configuring the SWORD Server Integration Profile and add your username and password. These, and the BaseURL, will be required to configure your SWORD client.

Implementation

All requests to the SWORD server must also include an ‘On-behalf-of’ header with a valid Alma user.

You may include a full metadata record (MARCXML, DC or MODS) with your submitted package, in which case the file must be named metadata.xml. If no metadata file is provided in the package, a bibliographic record will be created based on the embedded dcterms properties in SWORD entry.

The following methods are supported by the Alma SWORD server:

MethodDescription
GET /sdGet Service Document
GET /edit/<deposit-id>Get Deposit details
PUT /edit/<deposit-id>Replace metadata
POST /collection/<deposit_profile_id>Create resource
POST /edit-media/<deposit_id>Add content
DELETE /edit-media/<deposit_id>/<filename>Delete content
DELETE /edit/<deposit-id>Withdraw deposit
PUT /edit/<deposit-id>
“In-Progress: false”
Submit in progress deposit

See these blog posts for implementation examples etc..