spacer
spacer

Triana

Introduction

Triana is a workflow development and execution tool developed at Cardiff University.

Using Triana with EMBL-EBI Web Services

The following information refers to Triana 3.2.3, which has the required web service support.

Importing a WSDL

To access a SOAP based web service, the WSDL describing the service interface needs to be imported. To do this:

  1. Click the “Services” → “Import Service…”
  2. Copy/paste or type the WSDL URL (e.g. http://www.ebi.ac.uk/Tools/webservices/wsdl/WSDbfetch.wsdl for WSDbfetch) into the “Service location?” field
  3. Click the “OK” button

A “WebServices” folder should now appear in the toolbox (the tree of components and services on the left), in this folder the imported services appear. In the case of WSDbfetch a sub-folder called “WSDbfetch” appears containing components that can be added to the workflow for each of the operations provided by the service.

Note: services are not automatically imported when a workflow depending on them is loaded, so when using workflows which use remote services be sure to import the required WSDL descriptions before attempting to execute the workflow.

Using Service Operations

Service operations can be used the same way as any other component in Triana. For example building a workflow which uses WSDbfetch to retrieve the UniProtKB WAP_RAT entry in fasta format can be done as follows:

  1. Import the WSDL for WSDbfetch as described above.
  2. Create an new workflow using “File” → “New…”, ctrl-N or the toolbar icon.
  3. Add the component to fetch the data from the service:
    1. Open the “WebServices” → “WSDbfetch” folder in the tool box.
    2. Drag the “fetchData” component from the tool box into the workflow.
  4. Add the component to display the resulting data:
    1. Open the “Common” → “String” folder in the tool box.
    2. Drag the “StringViewer” component from the tool box into the workflow.
  5. Add the component to provide the input to the service operation and configure the input parameters:
    1. Using a generated type interface (“WSTypeGen”):
      1. Open the “Common” → “WebServices” folder in the tool box.
      2. Drag the “WSTypeGen” component from the tool box into the workflow.
      3. Double-click the “WSTypeGen” component
      4. In the dialog fill-in the data for the parameters, these are in the order specified in the WSDL: query, format and style
        1. “UNIPROT:WAP_RAT”
        2. “fasta”
        3. “raw”
      5. Click “OK”
    2. Specifying the parameters individually:
      1. Open the “Common” → “String”
      2. Drag the “StringGen” component from the tool box into the workflow, this adds a component called “StringGen”.
      3. Drag the “StringGen” component from the tool box into the workflow, this adds a component called “StringGen1”.
      4. Drag the “StringGen” component from the tool box into the workflow, this adds a component called “StringGen2”.
      5. The inputs on the “fetchData” component are in order, so the “StringGen” connected to the top input is query, the middle one is format and the bottom one is query, so rename the “StringGen” components (right-click on the component and select “Rename…”) to reflect this.
      6. Set the string for each of the inputs by double-clicking on the component, typing the string in the box and clicking “OK”
        1. query: “UNIPROT:WAP_RAT”
        2. format: “fasta”
        3. style: “raw”
  6. Execute the workflow, using the “Run” → “Run” menu item or the icon on the tool bar.
  7. View the result: double-click on the “StringViewer” component to see the result.

Examples

 
tutorials/07_workflows/triana.txt · Last modified: 2013/03/19 08:56 by hpm
spacer
spacer