evaluation

Task Purpose

The evaluation task controls the job execution path according to runtime conditions.

Figure 1: Evaluation Task

If the condition specified in the task is met, the task outputs the value true. Execution then continues down any success transitions bound to the task.

Figure 2: Evaluation Task Output Success

Otherwise, the task outputs the value undefined and execution continues down any failure transitions bound to the task.

Figure 3: Evaluation Task Output Failure

In this guide, you will learn:

• How to set the condition of the evaluation task.
• How to construct the expressions (evaluations) used to determine if that condition has been met.
• The properties that can be used in these evaluations.

Condition

First, set the task condition. The condition is an "if" statement, reading as follows:

"If <any | all> of the following are met:"

When the condition is completed with any, the task will output the value true if any of its evaluation groups resolve as true. Likewise, if the condition is completed with all, the task will only output the value true if all of its evaluation groups resolve as true.

To set the condition:

1. Click the dropdown arrow in the condition statement located at the top of the task configuration window.
2. Select an option from the menu that appears.

Evaluations

After the task's condition has been set, you can begin constructing the evaluations that will be compared against it. Evaluations are expressions that consist of two operands (A and B) and a comparison operator. When the task executes, operand A is compared to operand B, yielding a result of true or false.

All evaluations are members of an evaluation group, which resolves to true or false by logically combining its evaluation results. Each evaluation group has its own conditional statement -- this operates in the same manner as the task condition.

To construct an evaluation:

1. If one does not already exist, create an evaluation group by clicking the + Add Evaluation Group button.
2. Click the + Add Evaluation button in the desired evaluation group.
3. Define operand A:
   • If its source is static, a data type and value must be defined.
   • If its source is a job variable, select the desired job variable from the dropdown menu that appears.
   • If its source is a previous task, select the desired task and its relevant variable from the dropdown menu that appears.
4. Select the operator that will be used to compare the operands via the Operator dropdown menu.
5. Define operand B.

Evaluation Properties - Operators

The behavior of each operator is dependent on the data type(s) of its operands; for more information, see the tables below.

Contains

Does not contain

Greater than

Less than

Equals

Does not equal

Greater than or equal to

Less than or equal to

Example Evaluations

The following table provides sample evaluations and their results.

References

For more information on using regular expression syntax:

• Regular Expressions Syntax Cheatsheet
• Regular Expressions
• RegExp JavaScript