Evaluation Object

Similar to the "If" actions which provide logic within the task level, the Evaluation object is a logic mechanism that allows for sophisticated decision making to take place within the Workflow level. The Evaluation object contains parameters such as Yes/No question or True/False test. It is unique in that two or more Result arrows can stem from this object, one corresponding to Yes or True, and one corresponding to No or False. More than two arrows can be used if needed. From a visual standpoint, the use of an Evaluation object in a workflow normally indicates that a complex decision is being taken, in which case it may need to be broken-down further, or replaced with the pre-defined process (i.e. task or sub-workflow).

Evaluation objects essentially provides a means for logical branching to take place within a workflow, allowing decisions to be made during workflow execution. The Evaluation object is used in conjunction with the Result arrow to evaluate a specified condition (for example, whether a specific process is running on the system), and if that condition is true, the workflow will execute Task 1. If the result of the Evaluation object is false, the workflow will alter its course and execute Task 2 instead.

Functions, Shared Variables, Shared Datasets and Shared Arrays can be specified within the properties of an Evaluation object. This allows the ability for the object to evaluate  a certain value or condition that resulted from a previous task, sub-workflow or condition. The Evaluation object's properties also accept server constants.

For more details regarding workflow logic including an assortment of examples see Workflow Logic Explained.

Using the Evaluation Object in a Workflow

  1. Drag the Evaluation object from the Available Objects pane (shown below) to the workspace.

 

 

  1. Click the field directly below the newly added Evaluation object to enter a specific name for the object.

  1. Double-click the object or right-click the object and select Edit. This will open the Evaluation object's properties dialog (shown below).

  1. Select one of the following available options:

NOTE: The variable specified must be declared as a shared variable in order for it to be properly evaluated. Shared variables are variables that are accessible throughout an entire workflow. For more details, see Shared Variables.

  1. Enter the appropriate information for the option selected.

  2. Click Ok to save changes and close the properties dialog.

Linking Objects with Result Arrows

The Workflow Result arrow (blue in color) is used along with the Evaluation object as a logical branching tool within a workflow. When a Result arrow is linked from an Evaluation object, the destination of this arrow is executed if the attached evaluation results to Yes/True, No/False, or matches the specified value. Unlike other workflow arrows (i.e. Success, Failure arrows) the Result arrow contains specific properties to allowing it to detect the contents of an Evaluation object.  

Follow the instructions below to link the Evaluation object with a Result arrow:

  1. Add existing objects from the Repository (i.e. pre-existing tasks, conditions, sub-workflows) or create new objects to add to the workspace that will be used to link the  Evaluation object to.

  2. Drag the Result arrow from the Available Objects pane onto the workspace.

  3. Drag the side opposite the tip of the arrow to the Evaluation object and point it to the desired task, condition or other available object.

  4. Double-click the Result arrow to show its properties (as displayed below).

  1. Select from the available options:

  1. Click Ok to save changes and close the properties dialog.

Repeat the above instructions to link another Result arrow (containing different results) to a separate workflow object. During execution, the path that the workflow will take will now depend on the Result arrow matching the results of the Evaluation object.

See Also     

About Creating Workflows

Building a Workflow

Workflow Logic Explained