Table of contents


Official Content

Defines a loop condition on the number of instances to be created.

Values

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.

Scope

Controls: Task

Description

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.
    • Flow condition

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.

Loop Type Property (Multi-Instance)

 

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.

Loop Type Property (Standard)
 

Runtime/Design time

This property applies only at design time.

See Also

Attribute definition
Relevant Data

 

Last update: February 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant