UKOLN is supported  by: SWORD: An Overview 2 nd  June 2009 Web Service Day British Library, London Adrian Stevenson SWORD ...
SWORD Quick Introduction <ul><li>Vision:  “lowering barriers to deposit” </li></ul><ul><li>S imple  W eb service  O fferin...
What is it? <ul><li>A lightweight protocol for deposit </li></ul><ul><li>A profile of the Atom Publishing Protocol </li></u...
Motivations – why? <ul><li>no standard interface for tagging, packaging or authoring tools to upload objects into a reposi...
Use Cases <ul><li>Deposit from a Desktop/Online tool </li></ul><ul><li>Multiple deposit - e.g. deposit to institutional an...
The Project Partners <ul><li>SWORD partners: </li></ul><ul><ul><li>UKOLN, University of Bath and University of York (Proje...
SWORD AtomPub Profile
Standards <ul><li>WebDAV (http://www.webdav.org/)  </li></ul><ul><li>JSR 170 (http://www.jcp.org/en/jsr/detail?id=170)  </...
“ The Atom Publishing Protocol is an application-level protocol for publishing and editing Web resources”  <ul><li>benefit...
SWORD AtomPub Profile <ul><li>SWORD profile builds on AtomPub </li></ul><ul><li>Provides set of extensions, constraint rel...
SWORD APP Package Support <ul><li>AtomPub uses MIME to describe resources </li></ul><ul><li>Inadequate for compound types ...
SWORD APP Mediated Deposit <ul><li>SWORD deposit client user may not be owner of resource </li></ul><ul><li>SWORD allows c...
SWORD APP Developer Features <ul><li>No-Op (Dry Run) </li></ul><ul><li>Verbose Output </li></ul><ul><li>Client and Server ...
SWORD APP Error Documents <ul><li>SWORD adds new class of doc to AtomPub to allow better error description </li></ul><ul><...
SWORD Profile of AtomPub <ul><li>Part B follows AtomPub specification highlighting where SWORD profile diverges </li></ul>...
SWORD v1.3 Profile Updates <ul><li>SWORD Profile Version 1.3 includes: </li></ul><ul><li>Revised deviations from AtomPub a...
How it Works <ul><li>APP/SWORD works by issuing HTTP requests (GET, POST)  </li></ul><ul><ul><li>GET Service Document (exp...
SWORD In Use
Implementations <ul><li>Repository implementations  </li></ul><ul><ul><li>DSpace  </li></ul></ul><ul><ul><li>EPrints  </li...
Web Interface
Fedora deposit
Fedora Deposit response
Validation
Deposit via Facebook
 
 
 
 
 
Netvibes Widget
 
 
Deposit in Intralibrary
FeedForward Deposit
Intralibrary preview of deposited item
OfficeSWORD Add-on <ul><li>http://www.codeplex.com/OfficeSWORD </li></ul>
SWORD in use <ul><li>In addition to the case study implementations:  </li></ul><ul><ul><li>Feedforward has already impleme...
More Info and Contact <ul><li>SWORD Website: </li></ul><ul><li>http://www.swordapp.org </li></ul><ul><li>http://twitter.co...
Questions? <ul><li>http://www.swordapp.org </li></ul><ul><li>http://www.twitter.com/swordapp </li></ul><ul><li>[email_addr...
Upcoming SlideShare
Loading in …5
×

SWORD: An Overview

3,365 views
3,315 views

Published on

Presentation and demonstration at the EThOSnet project's 'Repositories and Web Services Workshop', 2nd June 2009, British Library, London, UK.

Published in: Technology, Business
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
3,365
On SlideShare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
18
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide
  • SWORD: An Overview

    1. 1. UKOLN is supported by: SWORD: An Overview 2 nd June 2009 Web Service Day British Library, London Adrian Stevenson SWORD Project Manager
    2. 2. SWORD Quick Introduction <ul><li>Vision: “lowering barriers to deposit” </li></ul><ul><li>S imple W eb service O ffering R epository D eposit </li></ul><ul><li>Aims to provide a standard mechanism for ‘doing deposit’ into repositories </li></ul><ul><li>JISC funded project started 2007, continuation funding for SWORD 2 from June 2008 </li></ul>
    3. 3. What is it? <ul><li>A lightweight protocol for deposit </li></ul><ul><li>A profile of the Atom Publishing Protocol </li></ul><ul><li>Implementations of SWORD in IntraLibrary, Fedora, DSpace and Eprints repositories </li></ul><ul><li>SWORD clients – web-based, desktop,, Facebook client, MS Office plugin, widgets </li></ul>
    4. 4. Motivations – why? <ul><li>no standard interface for tagging, packaging or authoring tools to upload objects into a repository </li></ul><ul><li>no standard interface for transferring digital objects between repositories </li></ul><ul><li>no way to deposit into more than one repository with one ‘click’ </li></ul><ul><li>no way of initiating a deposit workflow from outside a repository system </li></ul>
    5. 5. Use Cases <ul><li>Deposit from a Desktop/Online tool </li></ul><ul><li>Multiple deposit - e.g. deposit to institutional and (mandated) funders’ repository with one action </li></ul><ul><li>Machine deposit - e.g. automated deposit from a laboratory machine </li></ul><ul><li>Migration/transfer - e.g. to a preservation service </li></ul><ul><li>Mediated deposit - e.g. deposit by a nominated representative, to additional repositories </li></ul>
    6. 6. The Project Partners <ul><li>SWORD partners: </li></ul><ul><ul><li>UKOLN, University of Bath and University of York (Project Management) – Adrian Stevenson & Julie Allinson </li></ul></ul><ul><ul><li>University of Cambridge – Jim Downing (Profile) </li></ul></ul><ul><ul><li>University of Aberystwyth (DSpace, Fedora, & clients) – </li></ul></ul><ul><ul><li>Stuart Lewis, Neil Taylor, Glen Robson, Richard Jones </li></ul></ul><ul><ul><li>University of Southampton (EPrints) – Les Carr, Seb Francois </li></ul></ul><ul><ul><li>Intrallect (IntraLibrary) –Sarah Currier, Andrew Robson </li></ul></ul>
    7. 7. SWORD AtomPub Profile
    8. 8. Standards <ul><li>WebDAV (http://www.webdav.org/) </li></ul><ul><li>JSR 170 (http://www.jcp.org/en/jsr/detail?id=170) </li></ul><ul><li>JSR 283 (http://www.jcp.org/en/jsr/detail?id=283) </li></ul><ul><li>SRW Update (http://www.loc.gov/standards/sru/) </li></ul><ul><li>Flickr Deposit API (http://www.flickr.com/services/api/) </li></ul><ul><li>Fedora Deposit API (http://www.fedora.info/definitions/1/0/api/) </li></ul><ul><li>OKI OSID (http://www.okiproject.org/) </li></ul><ul><li>ECL (http://ecl.iat.sfu.ca/) </li></ul><ul><li>ATOM Publishing Protocol (http://www.ietf.org/htmlcharters/atompub-charter.html) </li></ul>
    9. 9. “ The Atom Publishing Protocol is an application-level protocol for publishing and editing Web resources” <ul><li>benefits </li></ul><ul><ul><li>supports many parameters and requirements - file deposit </li></ul></ul><ul><ul><li>already exists and has growing support - blogs </li></ul></ul><ul><ul><li>has an extension mechanism </li></ul></ul><ul><ul><li>good fit with Web architecture </li></ul></ul><ul><li>drawbacks / risks </li></ul><ul><ul><li>retrofit? </li></ul></ul><ul><ul><li>designed for a single package/file or an atom document – means that we need to package metadata and files </li></ul></ul>
    10. 10. SWORD AtomPub Profile <ul><li>SWORD profile builds on AtomPub </li></ul><ul><li>Provides set of extensions, constraint relaxations and enforcements for: </li></ul><ul><ul><li>Clients posting compound resources (zip,tar) </li></ul></ul><ul><ul><li>When mediated deposit required </li></ul></ul><ul><ul><li>Where workflows involved </li></ul></ul><ul><li>Part A adds to AtomPub, Part B highlights how SWORD diverges </li></ul><ul><li>SWORD compliance does not preclude AtomPub compliance </li></ul>
    11. 11. SWORD APP Package Support <ul><li>AtomPub uses MIME to describe resources </li></ul><ul><li>Inadequate for compound types e.g. </li></ul><ul><ul><li>Zip, tar </li></ul></ul><ul><ul><li>METS, IMS-CP, MPEG21, DIDL packages </li></ul></ul><ul><li>SWORD extends AtomPub: </li></ul><ul><ul><li>sword:acceptPackaging element </li></ul></ul><ul><ul><li>Value taken from SWORD package types </li></ul></ul>
    12. 12. SWORD APP Mediated Deposit <ul><li>SWORD deposit client user may not be owner of resource </li></ul><ul><li>SWORD allows clients to set a HTTP header: </li></ul><ul><ul><li>X-On-Behalf-Of </li></ul></ul><ul><li>Assumes trust between owner and mediating user </li></ul>
    13. 13. SWORD APP Developer Features <ul><li>No-Op (Dry Run) </li></ul><ul><li>Verbose Output </li></ul><ul><li>Client and Server Identity </li></ul><ul><li>Auto-Discovery </li></ul><ul><li>Error Documents </li></ul><ul><li>Nested Service Description </li></ul>
    14. 14. SWORD APP Error Documents <ul><li>SWORD adds new class of doc to AtomPub to allow better error description </li></ul><ul><ul><li>ErrorContent </li></ul></ul><ul><ul><li>ErrorChecksumMismatch </li></ul></ul><ul><ul><li>ErrorBadRequest </li></ul></ul><ul><ul><li>TargetOwnerUnknown </li></ul></ul><ul><ul><li>MediationNotAllowed </li></ul></ul>
    15. 15. SWORD Profile of AtomPub <ul><li>Part B follows AtomPub specification highlighting where SWORD profile diverges </li></ul><ul><li>Part B covers: </li></ul><ul><ul><li>Protocol Operations </li></ul></ul><ul><ul><ul><li>Retrieving Service Document </li></ul></ul></ul><ul><ul><ul><li>Listing Collections </li></ul></ul></ul><ul><ul><ul><li>Creating a Resource </li></ul></ul></ul><ul><ul><ul><li>Editing a Resource - Not currently implemented </li></ul></ul></ul><ul><ul><li>Category Documents – MUST NOT be required </li></ul></ul><ul><ul><li>Service Documents </li></ul></ul><ul><ul><ul><li>SWORD requires support for service documents </li></ul></ul></ul><ul><ul><ul><li>new elements: version, verbose, noOp, maxUploadSize </li></ul></ul></ul>
    16. 16. SWORD v1.3 Profile Updates <ul><li>SWORD Profile Version 1.3 includes: </li></ul><ul><li>Revised deviations from AtomPub and Atom </li></ul><ul><ul><li>increasing requirement for persistent Atom Entry Documents </li></ul></ul><ul><li>Includes description of SWORD specific extensions </li></ul><ul><li>Removed notion of levels of compliance </li></ul><ul><li>Added sword:userAgent, sword:error, sword:service, sword:version and sword:maxUploadSize elements </li></ul>
    17. 17. How it Works <ul><li>APP/SWORD works by issuing HTTP requests (GET, POST) </li></ul><ul><ul><li>GET Service Document (explain/discover) </li></ul></ul><ul><ul><li>POST a file or package to collection URI </li></ul></ul><ul><li>HTTP response and ATOM document is returned </li></ul><ul><li>HTTP basic authentication is required </li></ul>
    18. 18. SWORD In Use
    19. 19. Implementations <ul><li>Repository implementations </li></ul><ul><ul><li>DSpace </li></ul></ul><ul><ul><li>EPrints </li></ul></ul><ul><ul><li>IntraLibrary </li></ul></ul><ul><ul><li>Fedora </li></ul></ul><ul><li>Client implementations </li></ul><ul><ul><li>command-line, desktop and web clients </li></ul></ul><ul><ul><li>Facebook Client </li></ul></ul><ul><ul><li>Deposit from within MS Word & Powerpoint </li></ul></ul><ul><ul><li>Feedforward / FOREsite and others: http://www.swordapp.org/sword/implementation </li></ul></ul><ul><ul><li>Java, PHP and .NET libraries </li></ul></ul>
    20. 20. Web Interface
    21. 21. Fedora deposit
    22. 22. Fedora Deposit response
    23. 23. Validation
    24. 24. Deposit via Facebook
    25. 30. Netvibes Widget
    26. 33. Deposit in Intralibrary
    27. 34. FeedForward Deposit
    28. 35. Intralibrary preview of deposited item
    29. 36. OfficeSWORD Add-on <ul><li>http://www.codeplex.com/OfficeSWORD </li></ul>
    30. 37. SWORD in use <ul><li>In addition to the case study implementations: </li></ul><ul><ul><li>Feedforward has already implemented </li></ul></ul><ul><ul><li>ICE project is looking at SWORD </li></ul></ul><ul><ul><li>EU PEER project implementing SWORD </li></ul></ul><ul><ul><li>Microsoft Zentity Research-Outputs Repository </li></ul></ul><ul><ul><li>Microsoft eChemistry work </li></ul></ul><ul><ul><li>OAI-ORE - FOREsite work </li></ul></ul><ul><ul><li>EM-Loader </li></ul></ul><ul><ul><li>YODL-ING – University of York </li></ul></ul><ul><ul><li>Others coming along all the time </li></ul></ul><ul><li>Collaboration with Nature Publishing Group </li></ul>
    31. 38. More Info and Contact <ul><li>SWORD Website: </li></ul><ul><li>http://www.swordapp.org </li></ul><ul><li>http://twitter.com/swordapp </li></ul><ul><li>General queries: </li></ul><ul><ul><li>Adrian Stevenson [email_address] </li></ul></ul><ul><li>Technical queries: </li></ul><ul><ul><li>Sword sourceforge list [email_address] </li></ul></ul>
    32. 39. Questions? <ul><li>http://www.swordapp.org </li></ul><ul><li>http://www.twitter.com/swordapp </li></ul><ul><li>[email_address] </li></ul>

    ×