Developer:WorkflowsResource

From myExperiment
Jump to: navigation, search

Index of workflow

URI: GET http://www.myexperiment.org/workflows.xml

Example output:

<?xml version='1.0' encoding='UTF-8'?>
<workflows>
  <workflow uri='http://www.myexperiment.org/workflow.xml?id=4' resource='http://www.myexperiment.org/workflows/4'>EBI InterProScan</workflow>
  <workflow uri='http://www.myexperiment.org/workflow.xml?id=5' resource='http://www.myexperiment.org/workflows/5'>DOI2PMID</workflow>
  <workflow uri='http://www.myexperiment.org/workflow.xml?id=6' resource='http://www.myexperiment.org/workflows/6'>Genome annotation pipeline demonstrator workflow for Nucleic Acids Research</workflow>
  <workflow uri='http://www.myexperiment.org/workflow.xml?id=7' resource='http://www.myexperiment.org/workflows/7'>Fetch Dragon images from BioMoby v2</workflow>
  <workflow uri='http://www.myexperiment.org/workflow.xml?id=10' resource='http://www.myexperiment.org/workflows/10'>HUMAN Microarray CEL file to candidate pathways</workflow>
  ...
</workflows>


Create workflow

URL: POST http://www.myexperiment.org/workflow.xml

Example input:

<?xml version="1.0"?>
<workflow>
  <title>Cove NetCDF visualization</title>
  <description>
    The Cove workflow reads oceanographic NetCDF data, does a simple processing
    step, writes the data out, then sends a web service message to the COVE
    visualization tool. It is a four step, sequential workflow.
  </description>
  <license-type>by-sa</license-type>
  <content-type>application/xaml+xml</content-type>
  <content encoding="base64" type="binary">
    PHdmOlNlcXVlbnRpYWxXb3JrZmxvd0FjdGl2aXR5DQogIHhtbG5zPSJodHRw
    Oi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3Jlc2VhcmNoLzIwMDcvU2NpZW50
    aWZpY1dvcmtmbG93Ig0KICB4bWxuczp3Zj0iaHR0cDovL3NjaGVtYXMubWlj
    ...
    eSBCYXkiIExpbms9Int3ZjpBY3Rpdml0eUJpbmQgV3JpdGUsUGF0aD1MaW5r
    fSIgSG9zdE5hbWU9ImxvY2FsaG9zdDoxMTIyMyIvPg0KPC93ZjpTZXF1ZW50
    aWFsV29ya2Zsb3dBY3Rpdml0eT4NCg==
  </content>
  <preview encoding="base64" type="binary">
    iVBORw0KGgoAAAANSUhEUgAAAo8AAADACAIAAADqYx68AACJH0lEQVR4nOyd
    B3gVxdqAZ+vZ089J772QQu9deq9SFBDsKF6xge23XRWvDXtBsQA2QIoiIAhI
    7ySUhJqQ3uup28s/exIQlatiEgyXfTkPz8lmM7s738xXZme+QRRFBn8V5S+f
    ...
    k+u2DMpAiPL8t7/F0YD1/PuY8IBq7R37O6uhVHvNGXmRonhPTbwKr7lUvApv
    uW7RSlvppXhNIWVVTkW07YOotZfcDwjvB10qiLukmikKwsupSr38P/JToTLY
    1NlZAAAAAElFTkSuQmCC
  </preview>
</workflow>

The full example input is over 800 lines long and is shown on a separate page for reference.

Example output:

<?xml version="1.0" encoding="UTF-8"?>
<workflow uri="http://www.myexperiment.org/workflow.xml?id=635" resource="http://www.myexperiment.org/workflows/635" version="1">
  <title>Cove NetCDF visualization</title>
  <description>The Cove workflow reads oceanographic NetCDF data, does a simple processing step, writes the data out, then sends a web service message to the COVE visualization tool. It is a four step, sequential workflow.</description>
  <uploader uri="http://www.myexperiment.org/user.xml?id=22" resource="http://www.myexperiment.org/users/22">Don Cruickshank</uploader>
  <created-at>Wed Jan 21 15:56:19 +0000 2009</created-at>
  <preview>http://www.myexperiment.org/workflow/image/635/preview.png</preview>
  <license-type>by-sa</license-type>
  <content-uri>http://www.myexperiment.org/workflows/635/download/cove_netcdf_visualization_88240</content-uri>
  <content-type>application/xaml+xml</content-type>
  <tags/>
</workflow>

You can also set sharing permissions when uploading workflows via the REST API.


Read workflow

URL: GET http://www.myexperiment.org/workflow.xml?id=173

Example output:

<?xml version="1.0" encoding="UTF-8" ?> 
<workflow uri="http://www.myexperiment.org/workflow.xml?id=173" resource="http://www.myexperiment.org/workflows/173" version="2">
  <title>Unique tags</title> 
  <description>This workflow takes a comma separated list of tags and removes duplicate entries. Tags may have multiple words in them. An example string is "carrots,handbags,carrots,cheese".</description> 
  <uploader uri="http://www.myexperiment.org/user.xml?id=22" resource="http://www.myexperiment.org/users/22">Don Cruickshank</uploader> 
  <created-at>Tue Mar 11 16:52:42 +0000 2008</created-at> 
  <preview>http://www.myexperiment.org/workflow/image/173/unique_tags_18054_2.png</preview> 
  <svg>http://www.myexperiment.org/workflow/svg/173/unique_tags_18054_2.svg</svg> 
  <license-type>by-sa</license-type> 
  <content-uri>http://www.myexperiment.org/workflows/173/download/unique_tags_18054.xml</content-uri> 
  <content-type>application/vnd.taverna.scufl+xml</content-type> 
  <tags>
    <tag uri="http://www.myexperiment.org/tag.xml?id=555" resource="http://www.myexperiment.org/tags/555">example</tag> 
    <tag uri="http://www.myexperiment.org/tag.xml?id=450" resource="http://www.myexperiment.org/tags/450">scampi</tag> 
    <tag uri="http://www.myexperiment.org/tag.xml?id=760" resource="http://www.myexperiment.org/tags/760">design pattern</tag> 
  </tags>
</workflow>


Update workflow

URL: PUT http://www.myexperiment.org/workflow.xml?id=173

Example input:

<?xml version="1.0" encoding="UTF-8" ?> 
<workflow>
  <title>Unique tags (updated)</title> 
  <description>This workflow takes a comma separated list of tags and removes duplicate entries. Tags may have multiple words in them. An example string is "carrots,handbags,carrots,cheese".</description> 
  <license-type>by-sa</license-type> 
  <content-type>application/vnd.taverna.scufl+xml</content-type>  
</workflow>


Example output:

<?xml version="1.0" encoding="UTF-8" ?> 
<workflow uri="http://www.myexperiment.org/workflow.xml?id=173" resource="http://www.myexperiment.org/workflows/173" version="2">
  <title>Unique tags (updated)</title> 
  <description>This workflow takes a comma separated list of tags and removes duplicate entries. Tags may have multiple words in them. An example string is "carrots,handbags,carrots,cheese".</description> 
  <uploader uri="http://www.myexperiment.org/user.xml?id=22" resource="http://www.myexperiment.org/users/22">Don Cruickshank</uploader> 
  <created-at>Tue Mar 11 16:52:42 +0000 2008</created-at> 
  <preview>http://www.myexperiment.org/workflow/image/173/unique_tags_18054_2.png</preview> 
  <svg>http://www.myexperiment.org/workflow/svg/173/unique_tags_18054_2.svg</svg> 
  <license-type>by-sa</license-type> 
  <content-uri>http://www.myexperiment.org/workflows/173/download/unique_tags_18054.xml</content-uri> 
  <content-type>application/vnd.taverna.scufl+xml</content-type> 
  <tags>
    <tag uri="http://www.myexperiment.org/tag.xml?id=555" resource="http://www.myexperiment.org/tags/555">example</tag> 
    <tag uri="http://www.myexperiment.org/tag.xml?id=450" resource="http://www.myexperiment.org/tags/450">scampi</tag> 
    <tag uri="http://www.myexperiment.org/tag.xml?id=760" resource="http://www.myexperiment.org/tags/760">design pattern</tag> 
  </tags>
</workflow>


Delete workflow

URL: DELETE http://www.myexperiment.org/workflow.xml?id=173

Example output:

<?xml version="1.0" encoding="UTF-8" ?> 
<workflow uri="http://www.myexperiment.org/workflow.xml?id=173" resource="http://www.myexperiment.org/workflows/173" version="2">
  <title>Unique tags (updated)</title> 
  <description>This workflow takes a comma separated list of tags and removes duplicate entries. Tags may have multiple words in them. An example string is "carrots,handbags,carrots,cheese".</description> 
  <uploader uri="http://www.myexperiment.org/user.xml?id=22" resource="http://www.myexperiment.org/users/22">Don Cruickshank</uploader> 
  <created-at>Tue Mar 11 16:52:42 +0000 2008</created-at> 
  <preview>http://www.myexperiment.org/workflow/image/173/unique_tags_18054_2.png</preview> 
  <svg>http://www.myexperiment.org/workflow/svg/173/unique_tags_18054_2.svg</svg> 
  <license-type>by-sa</license-type> 
  <content-uri>http://www.myexperiment.org/workflows/173/download/unique_tags_18054.xml</content-uri> 
  <content-type>application/vnd.taverna.scufl+xml</content-type> 
  <tags>
    <tag uri="http://www.myexperiment.org/tag.xml?id=555" resource="http://www.myexperiment.org/tags/555">example</tag> 
    <tag uri="http://www.myexperiment.org/tag.xml?id=450" resource="http://www.myexperiment.org/tags/450">scampi</tag> 
    <tag uri="http://www.myexperiment.org/tag.xml?id=760" resource="http://www.myexperiment.org/tags/760">design pattern</tag> 
  </tags>
</workflow>


Elements for workflow

  • id - the id of the workflow
  • title - the title of the workflow
  • description - a description of the workflow
  • type - the content type resource that describes the type of the workflow
  • uploader - the user that uploaded the workflow
  • created-at - the date/time the workflow was created (uploaded)
  • updated-at - the date/time the workflow details were last modified
  • preview - a URL to a preview size image of the workflow
  • thumbnail - a URL to a thumbnail size image of the workflow
  • thumbnail-big - a URL to a big thumbnail size image of the workflow
  • svg - a URL to a SVG of the workflow
  • license-type - the license resource that describes the licensing of the workflow
  • content-uri - a URL to download the workflow file itself
  • content-type - the mime type of the workflow file
  • content - contents of the uploaded workflow file encoded in base64
  • tags - a list of tag resources describing the workflow
  • taggings - a list of tagging resources (i.e. resources that describe tag resources in the context of the workflow)
  • versions - a list of versions of the workflow that have been uploaded over time
  • reviews - a list of reviews of the workflow
  • comments - a list of comments on the workflow
  • ratings - a list of ratings for the workflow
  • credits - a list of users/groups credited for the creation (intellectual property) of the workflow
  • attributions - a list of workflows/files to which the workflow attributes its creation
  • citations - a list of citations resources that cite the workflow in some publication
  • components - the component elements that make up a workflow's dataflow (e.g. Taverna has sources, sinks, processors, links and coordinations)
  • privileges - a list of access privileges the user requesting the workflow has for the resource
  • statistics - total viewings and downloads for the workflow, including a further breakdown into those accessed directly from the site and those accessed in other ways (e.g. Taverna plugin)