tLoop Standard properties

These properties are used to configure tLoop running in the Standard Job framework.

The Standard tLoop component belongs to the Orchestration family.

The component in this framework is available in all Talend products.

Basic settings

For	Select this option to have the task or Job being executed for the defined number of iteration. From: enter the first instance number which the loop should start from. A start instance number of 2 with a step of 2 means the loop takes on every even number instance. To: enter the last instance number which the loop should finish with. Step: enter the step the loop should be incremented of. A step of 2 means every second instance. Values are increasing: select this check box to only allow an increasing sequence. You need also to type a positive integer in the Step field. Be sure to set the loop step and the Values are increasing option in one of the following ways to avoid infinite loops or other unexpected results. To allow an increasing sequence, type a positive integer in the Step field and select the Values are increasing option. To allow a decreasing sequence, type a negative integer in the Step field and make sure the Values are increasing option is not selected.
While	Select this option to have the task or Job being executed until the condition is met. Declaration: enter an expression initiating the loop. Condition: enter the condition that should be met for the loop to end. Iteration: enter the expression showing the operation to be performed at each loop.

For

Select this option to have the task or Job being executed for the defined number of iteration.

From: enter the first instance number which the loop should start from. A start instance number of 2 with a step of 2 means the loop takes on every even number instance.
To: enter the last instance number which the loop should finish with.
Step: enter the step the loop should be incremented of. A step of 2 means every second instance.
Values are increasing: select this check box to only allow an increasing sequence. You need also to type a positive integer in the Step field.

Be sure to set the loop step and the Values are increasing option in one of the following ways to avoid infinite loops or other unexpected results.

To allow an increasing sequence, type a positive integer in the Step field and select the Values are increasing option.
To allow a decreasing sequence, type a negative integer in the Step field and make sure the Values are increasing option is not selected.

While

Select this option to have the task or Job being executed until the condition is met.

Declaration: enter an expression initiating the loop.
Condition: enter the condition that should be met for the loop to end.
Iteration: enter the expression showing the operation to be performed at each loop.

Global Variables

Global Variables	ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box. CURRENT_VALUE: the current value. Only available for a For type loop. This is a Flow variable and it returns an integer. CURRENT_ITERATION: the sequence number of the current iteration. This is a Flow variable and it returns an integer. A Flow variable functions during the execution of a component while an After variable functions after the execution of the component. To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from it. For more information about variables, see Using contexts and variables.

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

CURRENT_VALUE: the current value. Only available for a For type loop. This is a Flow variable and it returns an integer.

CURRENT_ITERATION: the sequence number of the current iteration. This is a Flow variable and it returns an integer.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from it.

For more information about variables, see Using contexts and variables.

Usage

Usage rule	tLoop is to be used as a start component and can only be used with an iterate connection to the next component.
Connections	Outgoing links (from this component to another): Row: Iterate. Trigger: On Subjob Ok; On Subjob Error; Run if; On Component Ok; On Component Error. Incoming links (from one component to this one): Row: Iterate; Trigger: On Subjob Ok; On Subjob Error; Run if; On Component Ok; On Component Error; Synchronize; Parallelize. For further information regarding connections, see Using connections in a Job.

Usage rule

tLoop is to be used as a start component and can only be used with an iterate connection to the next component.

Connections

Outgoing links (from this component to another):

Row: Iterate.

Trigger: On Subjob Ok; On Subjob Error; Run if; On Component Ok; On Component Error.

Incoming links (from one component to this one):

Row: Iterate;

Trigger: On Subjob Ok; On Subjob Error; Run if; On Component Ok; On Component Error; Synchronize; Parallelize.

For further information regarding connections, see Using connections in a Job.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here