PubMan Sword

From MPDLMediaWiki
Jump to: navigation, search

This page briefly describes the SWORDSimple Web-service Offering Repository Deposit Server implementation in the PubManPublication Management solution. General Information about SWORDSimple Web-service Offering Repository Deposit can be found here.


For start the SWORDSimple Web-service Offering Repository Deposit functionality is directly implemented in PubManPublication Management. In future we should have a separate SWORDSimple Web-service Offering Repository Deposit service for all eSciDocEnhanced Scientific Documentation solutions.

PubManPublication Management implements 3 classes for the SWORDSimple Web-service Offering Repository Deposit service:

  1. PubManSwordServer - Processing of requests
  2. PubManServiceDocumentServlet - Accepting requests for the Service Document (dependent on user credentials)
  3. PubManDepositServlet - Accepting requests for the deposits (dependent on user credentials)


The PubManPublication Management SWORDSimple Web-service Offering Repository Deposit interface is deployed within the PubManPublication Management earEnterprise Archive File Formate, therefore one can access the above described servlets by the PubManPublication Management baseURL + the servlet path.

(Example with PubManPublication Management base url

Service Document


GET with user credentials


Code 200

A servicedocument describing:

  • All open collections a user may deposit to.
  • Collection identifier (mandatory for deposit)
  • Accepted formats (mandatory for deposit)
  • The workflow of a collection

Deposit Service

Parameters to send:

  • Authorization: User credentials in the form of HTTPHyperText Transfer Protocol basic access authorization (Mandatory)
    • user credentials are to be sent base-64 encoded in the format "Basic username:password"
     parameter-name: Authorization  
     parameter-value: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

  • X-Packaging: Metadata format as described in the servicedocument (Mandatory)
       parameter-name: X-Packaging
  • x-Verbose: true/false, sets the verbose output (Optional)
  • x-No-Op: true/false, Test deposit with no actual item deposit (Optional)


Code 201: Created

- Item action: Save, Submit, Release
Code 202: Accepted
- Item action: Save
- Item action: Save, Submit
Code 203:
- No user credentials were provided
- User was not recognized
Code 403:
- No collection was provided
- No rights to deposit to the provided collection
Code 415:
- Media Type not supported in PubManPublication Management
- No metadata file was provided
- Metadata could not be transformed into publication format
Code 400:
- Authentication Failure
- Validation Failure

Code 500:

- Internal Server Error

Code 413:

- Mediation not allowed

Plus an Atom Entry Document which contains information about the deposit:

 <atom:entry xmlns:atom="" xmlns:sword="">
      <atom:name>Friederike, Kleinfercher</atom:name>
   <atom:content src=""/>
   <atom:summary>item.xml ,123.pdfPortable Document Format</atom:summary>
   <atom:title>First Sword item</atom:title>
   <sword:treatment>Zip archives recognised as content
      packages are opened and the individual files contained
      in them are stored. All other files are stored as
  • The zip file may contain several files but must contain exactly one metadata file. All files not containing metadata are transformed to PubFiles and are added to the Publication item.
  • The metadatafile must have a specific file-ending: ".bib" for BibTexReference Management Software for Lists of References, ".xml" for publication (eSciDocEnhanced Scientific Documentation XMLExtensible Markup Language), ".enl" for EndNote and ".tei" for PEERPublishing and the Ecology of European Research TEIText Encoding Initiative Publications
  • The item is deposited to the collection: collectionIdentifier
  • The validation of the item depends on the collection
  • The action of deposit depends on the collection

Action Mapping

SWORDSimple Web-service Offering Repository Deposit Action PubManPublication Management Action Comment Status
Deposit Submit
Submit & Release
depending on the collection workflow and collection policies. Implemented
Edit Submit
Submit & Release
depending on the collection workflow and collection policies. Not implemented
Delete Withdraw
If item is in state released
If item is in state pending or In-Revision
Not implemented

Important Information

  • File visibility will be set to public
  • File content category will be set to Publisher Version for all pdfPortable Document Format files. Other files will get content category Supplementary Material.

Test the sword interface

  1. For testing the sword interface from the desktop you can use for example the poster firefox addon
  2. Find out for which collections you have access rights by visiting
  3. Enter the following information in the poster
    3.1. URLUniform Resource Locator:
    3.2. Under 'Content to Send' upload the file you want to ingest (metadata file plus optional fulltext), in zip format.
    Attention: accurate file extention for the metadata file may be necessary (e.g. .bib for BibTeXReference Management Software for Lists of References-files)
    3.3. Under 'Headers' enter:
    3.3.1. Name: Authorization Value: Basic username:pwd (Base64 encoded, e.g.: ZGVtbzpkZW1v for demo:demo ; complete entry would be: Basic ZGVtbzpkZW1v)
    3.3.2. Name: x-packaging Value: metadata format (check the servicedocument which are allowed, e.g. BibTexReference Management Software for Lists of References or EndNote)
    3.3.3. optional Name: x-verbose Value: true/false
    3.3.4. optional Name: x-No-Op Value: true/false
  4. Press the POST button