Loop

Loop 64x64

Short description

Ports

Metadata

Loop attributes

Details

Examples

Compatibility

See also

Short description

The Loop component allows repeated execution of a group of components or repeated processing of records.

Same input metadata Sorted inputs Inputs Outputs Each to all outputs Java CTL Auto-propagated metadata

2

2

It is highly important to manage token flow correctly. For example each token sent to the loop body must be navigated back to the Loop component. The token cannot be duplicated or cannot disappear. If these rules are not strictly followed, your jobflow processing can easily stuck in a deadlock situation.

Ports

Port type Number Required Description Metadata

Input

0

Entry point for loop processing.

Any

1

Tokens from the loop body must be returned back to the Loop component via this port.

Any

Output

0

Tokens which do not satisfy While condition are sent to this port to end up the looping.

Any

1

Tokens which satisfy While condition are sent to this port to start loop body.

Any

Metadata

All input and output ports have arbitrary but identical metadata.

Loop attributes

Attribute Req Description Possible values

Basic

While condition

yes

While this condition is satisfied, the iterating token is repeatedly sent to the loop body (second output port), otherwise the token is sent out of the loop (first output port).

While condition is a CTL2 expression which is evaluated against two records.

The first record ($in.0) is the token incoming from one of the input ports (either a loop initializing token or a token incoming from the loop body).

The second record ($in.1) is an artificial input for the condition evaluator with just a single field $in.1.iterationNumber which is automatically populated by the number of iteration of the current token. So for example, if the loop should be executed exactly five times, the condition could look like $in.1.iterationNumber < 5.

CTL expression

Advanced

Logging level

no

Decides on which level token processing information should be logged.

INFO (default) | DEBUG | TRACE | OFF

Details

The Loop component processes records (or tokens) one by one.

  1. The record enters the Loop component.

  2. The record is checked to fulfill the loop condition. If the condition is not fulfilled, the record is sent out to the first output port and the processing continues from step 1 using the next record. If the condition is met, the record is sent out to the second output port.

  3. The record is processed by components in the loop body.

  4. The record enters the Loop component through the second input port.

  5. Processing continues from the step 2.

Edge Types

All edges in loop are automatically converted to fast-propagate version. See Types of Edges.

Examples

Repeating Actions in Jobflow - Login
LoopExample
Figure 422. Example of Loop component usage

This jobflow simply generates an initial token by the DataGenerator component. The Loop component applies While condition on this initial token. If the condition is not satisfied, the token is sent out of the loop. On the other hand, if the condition is satisfied, the token is sent to the loop body, where the token is processed by other components. The token must be routed back to the Loop component, where While condition is evaluated again. The token looping is performed until the condition is not satisfied. Once the token is sent out of loop, another initial token is read from the first input port.

Compatibility

Version Compatibility Notice

4.0.0

Loop is now also available as an ordinary Component. Before, Loop was available as a Jobflow Component only.