Difference between revisions of "OtfWorkflowDesigner"

From emotive
Jump to navigation Jump to search
Line 45: Line 45:
 
# The drawing page will be scrolled toward the appropriate direction to to show the unseen range, move the mouse out of the blue arrow to stop scrolling.
 
# The drawing page will be scrolled toward the appropriate direction to to show the unseen range, move the mouse out of the blue arrow to stop scrolling.
 
# Drop the activity at the valid location sothat the activity is generated in the appropriate place.
 
# Drop the activity at the valid location sothat the activity is generated in the appropriate place.
# If you want to configure the activity, please use the Properties window (see instruction below).
+
# If you want to configure the activity, please use the Properties window or the Properties dialog box.
  
 
===Adding further realisation for activities===
 
===Adding further realisation for activities===
 
An activity may have more than one realisation, see [[OTX basic concepts]], below is an example of adding further realisation for an activity:
 
An activity may have more than one realisation, see [[OTX basic concepts]], below is an example of adding further realisation for an activity:
  
# Drag an activity into the sequence and drop it on an empty flow (i.e. on a green plus sign, see example above).
+
# Drag an activity from the [[OtfToolbox|Toolbox]] into the sequence and drop it on a green plus sign (see example above).
# Drag another activity from the [[OtfToolbox|Toolbox]] into the sequence
+
# Drag another activity from the [[OtfToolbox|Toolbox]] into the sequence and drop it on the existing activity to add further realisation, a context menu will be displayed.
# Drop the new activity on the existing activity that you want to add further realisation, a context menu will be displayed.
+
# Select the entry '''"Integrate'''" in the context menu to integrate the second activity with the first activity as the further realisation.
# Select the entry "Integrate" in the context menu sothat the new activity is integrated in the existing activity.
+
# To add another realisation to the '''activity with many realisations''', drag a new activity onto {{Question|the display area of the realisations in the middle of the activity}}.
# To add another realisation to the activity with many realisations, drag a new activity onto the display area of the realisations in the middle of the activity
+
# There will be no context menu, the new activity will automtically become a realisation in the activity.
# There will be no context menu, the new activity will become a realisation in the activity.
+
# If you want to configure the realisation, click on the realisation icon in the activity with many realisation and use the Properties window or the Properties dialog box.
 +
 
 +
{{Note| Besides using a new activity to add further realisation, you can also use an existing activity to add further realisation by drag-and-drop.}}
 +
 
 +
===Replacing activities===
 +
You can replace an existing activity with another activity. If the existing activity has a specification, the new activity will inherit the same specification. To replace an activity, please proceed as follows:
 +
 
 +
# Drag an activity from the [[OtfToolbox|Toolbox]] into the sequence and drop it on an existing activity in the workflow.
 +
# When the context menu appears, select the entry "'''Replace'''" and the existing activity will be replaced with the new activity.
 +
 
 +
{{Note| Besides using a new activity to replace an existing activity, you can also use an existing activity to replace another activity by drag-and-drop.}}
 +
 
 +
===Editing a sequence===
 +
In the Workflow Designer, one or more activities (nodes) can be copied, cut, pasted , or deleted, please proceed as follows:
 +
 
 +
# Select an activity in the sequence, or select many activities by holding the '''CTRL key''' down and clicking on the all activities you want to select. You can also hold the '''SHIFT key''' and use mouse to drag a retangle to select all the covered activities.
 +
# There are many ways to copy, cut, delete or paste the selected activities:
 +
## Use the keyboard shortcuts ('''CTRL+C''': Copy, '''CTRL+X''': Cut, '''DEL''': Delete, '''CTRL+V''': Paste) with the selected activities, note that you can paste on an activity or on an empty flow.
 +
## Use the context menu by right-clicking on one of the selected activities (or on an empty flow to paste) and selecting the corresponding entry
 +
## Use the corresponding command buttons in the tab "'''Start'''" of the [[OtfMenuBar|Ribbon menu bar]].
 +
## To copy and paste activities by drag-and-drop: drag the selected activities to the position you want to copy and paste them, hold down the '''CTRL key''' and release the mouse at the position (drop the activities at the position while holding the CTRL key)
 +
 
 +
 
 +
 
 +
 
  
 
==Adjusting the navigation and presentation of the sequence==
 
==Adjusting the navigation and presentation of the sequence==
 
==Printing and capturing of sequence==
 
==Printing and capturing of sequence==

Revision as of 07:10, 29 July 2014


EDITING...

Overview

The Workflow Designer is the central interface to input and arrange OTX nodes. It helps the authors create, edit and understand the test sequences graphically. The following main tasks will be implemented with the OTX Designer:

  • Specification
  • Realization
  • Documentation

The structure and functions of the Workflow Designer are described in the following sections.

Structure

In the Workflow Designer, test sequences can be edited graphically, see the image below. The Designer may consist of one or many tabs, each tab corresponds to a procedure ( a flow sequence/a workflow???). Within a sequence, the various activities (OTX nodes) are drawn together into a sequence on a white page. These activities can be configured through the dockable Properties window or the Properties dialog box. The activities are executed sequentially from top to bottom.

...

The sequences are presented in the form of a generic flowchart. This means that the author has only the ability to add individual items to, edit and adjust the presentation details. However, it has no direct influence on the position of the elements. It may include such activities so do not move the mouse to another location, such as in MS Visio. This supports the generic approach of OTX and has the following advantages:

  • The representation is generated solely from the OTX data without further meta data
  • The depiction of the sequence is independent of the flavor of the author
  • The same OTX sequence is the same on different computers
  • The author does not have to worry about layout details

A flow consists of the head region and the drawing page. In the head region, the relevant information of the procedure are presented below:

  • Name
  • Parameter (In-, Out- and InOut- parameters)
  • ValidFor
  • Implemented Signature
  • Specification

The drawing page contains the actual sequence of a procedure. It consists of a series of activities, see the image above.

Handling activities

Adding activities

To add an activity to the sequence, please follow the instructions as described below:

  1. Find the corresponding activity from the Toolbox.
  2. Drag the activity from the Toolbox into the sequence, note that there will be green plus signs displayed at the valid locations for this activity.
  3. Drop activity on one of the plus sign sothat the plus sign is replaced by the icon of the activity.
  4. If the insertion is not in the visible range of the sequence, drag the activity on one of the blue arrows at the edges of the Workflow Designer.
  5. The drawing page will be scrolled toward the appropriate direction to to show the unseen range, move the mouse out of the blue arrow to stop scrolling.
  6. Drop the activity at the valid location sothat the activity is generated in the appropriate place.
  7. If you want to configure the activity, please use the Properties window or the Properties dialog box.

Adding further realisation for activities

An activity may have more than one realisation, see OTX basic concepts, below is an example of adding further realisation for an activity:

  1. Drag an activity from the Toolbox into the sequence and drop it on a green plus sign (see example above).
  2. Drag another activity from the Toolbox into the sequence and drop it on the existing activity to add further realisation, a context menu will be displayed.
  3. Select the entry "Integrate" in the context menu to integrate the second activity with the first activity as the further realisation.
  4. To add another realisation to the activity with many realisations, drag a new activity onto the display area of the realisations in the middle of the activity???.
  5. There will be no context menu, the new activity will automtically become a realisation in the activity.
  6. If you want to configure the realisation, click on the realisation icon in the activity with many realisation and use the Properties window or the Properties dialog box.
Icons Note.png Besides using a new activity to add further realisation, you can also use an existing activity to add further realisation by drag-and-drop.

Replacing activities

You can replace an existing activity with another activity. If the existing activity has a specification, the new activity will inherit the same specification. To replace an activity, please proceed as follows:

  1. Drag an activity from the Toolbox into the sequence and drop it on an existing activity in the workflow.
  2. When the context menu appears, select the entry "Replace" and the existing activity will be replaced with the new activity.
Icons Note.png Besides using a new activity to replace an existing activity, you can also use an existing activity to replace another activity by drag-and-drop.

Editing a sequence

In the Workflow Designer, one or more activities (nodes) can be copied, cut, pasted , or deleted, please proceed as follows:

  1. Select an activity in the sequence, or select many activities by holding the CTRL key down and clicking on the all activities you want to select. You can also hold the SHIFT key and use mouse to drag a retangle to select all the covered activities.
  2. There are many ways to copy, cut, delete or paste the selected activities:
    1. Use the keyboard shortcuts (CTRL+C: Copy, CTRL+X: Cut, DEL: Delete, CTRL+V: Paste) with the selected activities, note that you can paste on an activity or on an empty flow.
    2. Use the context menu by right-clicking on one of the selected activities (or on an empty flow to paste) and selecting the corresponding entry
    3. Use the corresponding command buttons in the tab "Start" of the Ribbon menu bar.
    4. To copy and paste activities by drag-and-drop: drag the selected activities to the position you want to copy and paste them, hold down the CTRL key and release the mouse at the position (drop the activities at the position while holding the CTRL key)



Adjusting the navigation and presentation of the sequence

Printing and capturing of sequence