Defines a loop condition on the number of instances to be created.
| Multi-Instance | Specifies the number of times the task will be executed. The condition is evaluated once and returns the number of instances that must be created. Two properties are added to be configured. |
| None | No loop condition is defined. The task is executed once and continues the flow. This is the default value. |
| Standard | A standard loop activity has an associated Boolean expression that is evaluated after each loop cycle. Three properties are added to be configured. |
Controls: Task
You can configure the Loop type property for a Task control included in a Business Process Diagram object.
The possible values of this property are described below:
1) Multi-Instance
Specifies the number of times the Task will be executed.
The condition is evaluated once and returns the number of instances that must be created.
When selecting this value, the following two properties are added:
1.1) Expression Type property
Values:
- Rule: Allows you to specify an expression rule that will determine the number of times the task should be repeated. It accepts characters, attributes, and relevant data (e.g. "Customer registration number"+CustomerId+&relevantData).
- Procedure: Allows you to specify a Procedure object to determine the number of times the task should be repeated. This Procedure must have the following Parm rule:
parm(in:&WorkflowProcessDefinition,in:&WorkflowProcessInstance,in:&WorkflowWorkitem,out: &numberofinstances);
where the &numberofinstances variable must be Numeric (10).
1.2) Ordering property
Values:
- Sequential: The instances are executed one at a time.
- Parallel: The instances are all executed at the same time.
None
For each completed instance, a parallel path will be followed.
One
When the first instance is completed, the flow will continue. The other instances will continue running, but they will not create a new path when they are completed.
All
The flow will only continue when all instances have been completed (synchronization).
This is the default value.
Complex
Defines an expression that will be executed when each instance is completed to check whether it should continue.
2) None
No loop condition is defined. The task is executed once and continues the flow. This is the default value.
3) Standard
When selecting this value, the following three properties are added to the Properties window:
3.1) Test Time property
Values:
- Before: The condition is evaluated before executing the Task.
- After: The condition is evaluated after executing the Task.
3.2) Condition Type property
Values:
- Rule: Specifies a rule to evaluate the condition. It accepts characters, attributes, and relevant data (e.g. "Customer registration number"+CustomerId+&relevantData).
- Procedure: Allows you to specify a Procedure object to evaluate the condition. This Procedure must have the following Parm rule:
parm(in:&WorkflowProcessDefinition,in:&WorkflowProcessInstance,in:&WorkflowWorkitem,out: &code);
Where the &code variable must be Numeric (4.0). If the &code variable returns 1, the loop will continue; otherwise, if it
returns 0, the task will be completed, and the flow will continue.
3.3) Maximum Iterations property
Defines a maximum of loops. This property ignores the condition.
This property applies only at design time.
Attribute definition
Relevant Data