SWORD (version 2) Server

SWORD (Simple Web-service Offering Repository Deposit) is a protocol that allows the remote deposit of items into repositories. DSpace implements the SWORD protocol via the 'sword' web application. The specification and further information can be found at http://swordapp.org/.

SWORD is based on the Atom Publish Protocol and allows service documents to be requested which describe the structure of the repository, and packages to be deposited.

Enabling SWORD v2 Server

To enable DSpace's SWORD v2 server, just make sure the {{\[dspace\]/webapps/swordv2/}} web application is available from your Servlet Container (usually Tomcat).

Configuring SWORD v2 Server

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="b7c54204-05c0-4d27-9e8d-6a6d6e7d5bc7"><ac:plain-text-body><![CDATA[

Configuration File:

[dspace]/config/modules/sword2-server.cfg

]]></ac:plain-text-body></ac:structured-macro>

Property:

url

Example Value: 

url = http://www.myu.ac.uk/swordv2

Informational Note:

The base url of the SWORD 2.0 system. This defaults to ${dspace.baseUrl}/swordv2 (where dspace.baseUrl is defined in your dspace.cfg file).

Property:

collection.url

Example Value: 

url = http://www.myu.ac.uk/swordv2/collection

Informational Note:

The base URL of the SWORD collection. This is the URL from which DSpace will construct the deposit location URLs for collections. This defaults to ${dspace.baseUrl}/swordv2/collection (where dspace.baseUrl is defined in your dspace.cfg file).

Property:

servicedocument.url

Example Value: 

url = http://www.myu.ac.uk/swordv2/servicedocument

Informational Note:

The service document URL of the SWORD collection. The base URL of the SWORD service document. This is the URL from which DSpace will construct the service document location urls for the site, and for individual collections. This defaults to ${dspace.baseUrl}/swordv2/servicedocument (where dspace.baseUrl is defined in your dspace.cfg file).

Property:

accept-packaging.collection

Example Value: 

accept-packaging.collection.METSDSpaceSIP = http://purl.org/net/sword/package/METSDSpaceSIP
accept-packaging.collection.SimpleZip = http://purl.org/net/sword/package/SimpleZip
accept-packaging.collection.Binary = http://purl.org/net/sword/package/Binary

Informational Note:

The accept packaging properties, along with their associated quality values where appropriate.

Property:

accept-packaging.item

Example Value: 

accept-packaging.collection.METSDSpaceSIP = http://purl.org/net/sword/package/METSDSpaceSIP
accept-packaging.collection.SimpleZip = http://purl.org/net/sword/package/SimpleZip
accept-packaging.collection.Binary = http://purl.org/net/sword/package/Binary

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="55c58f8e-076d-42a6-b679-e498d71b25bc"><ac:plain-text-body><![CDATA[

Informational Note:

The accept packaging properties for items.   It is possible to configure this for specific collections by adding the handle of the collection to the setting, for example accept-packaging.collection.[handle].METSDSpaceSIP = [http://purl.org/net/sword-types/METSDSpaceSIP]

]]></ac:plain-text-body></ac:structured-macro>

Property:

accepts

Example Value: 

accepts = application/zip, image/jpeg

Informational Note:

A comma-separated list of MIME types that SWORD will accept. 

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III

Property:

PPP

Example Value: 

EEE

Informational Note:

III 

FINISH DOCUMENTING ALL CONFIGS in {{\[dspace\]/config/modules/sword2-server.cfg}}