annotate synapseGetDataset.xml @ 56:2a240b005731

better instructions on browser
author jingchunzhu
date Fri, 18 Sep 2015 11:03:59 -0700
parents 60efb9214eaa
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
1 <tool id="synapseGetDataset" description="Get a specified dataset and metadata from Synapse" name="Get Synapse Data" version="0.0.1">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
2 <description>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
3 Retrieve a dataset from Synapse
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
4 </description>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
5 <requirements>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
6 <requirement type="package" version="1.0">installXena</requirement>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
7 </requirements>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
8 <command interpreter="python">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
9 synapseGetDataset.py $synapseId $username $metadataFile $dataFile
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
10 #if $loginType.type == "password"
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
11 --password $loginType.password
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
12 #else
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
13 --apiKey $loginType.apiKey
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
14 #end if
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
15 </command>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
16 <inputs>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
17 <param type="text" name="synapseId" label="Synapse ID" optional="false"/>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
18 <param type="text" name="username" label="Synapse Username or Email" optional="false">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
19 <sanitizer sanitize="False"/>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
20 </param>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
21 <conditional name="loginType">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
22 <param type="select" name="type" label="Login Type">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
23 <option value="apiKey">Email Address and API Key (Recommended)</option>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
24 <option value="password">Email Address and Password</option>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
25 </param>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
26 <when value="password">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
27 <param type="text" name="password" label="Password" optional="false">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
28 <sanitizer sanitize="False"/>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
29 </param>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
30 </when>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
31 <when value="apiKey">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
32 <param type="text" name="apiKey" label="API Key" optional="false">
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
33 <sanitizer sanitize="False"/>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
34 </param>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
35 </when>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
36 </conditional>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
37 </inputs>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
38 <outputs>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
39 <data format="txt" name="metadataFile" label="${synapseId}.json"/>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
40 <data format="tabular" name="dataFile" label="${synapseId}" />
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
41 </outputs>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
42 <help>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
43 This module downloads a dataset from Synapse, given the Synapse ID of the dataset and user authentication. The user authentication can take one of two forms: email address and Synapse password, or email address and Synapse API key. We recommend logging in with the email address and Synapse API key, for greater security. The Synapse API key is specific to each user, and is available from the Synapse Settings page.
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
44
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
45 Note that this module is limited to single-file Synapse datasets. Synapse Projects and Folders must be downloaded with a separate mechanism.
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
46 </help>
60efb9214eaa Uploaded
melissacline
parents:
diff changeset
47 </tool>