ForEach Tab

When you create ForEach Workflows, you specify the loop details on its ForEach tab. You can access it by right-clicking the Start node and selecting Properties.

  • Iteration Source

    • Variable object

      The VARA object is used as the source for the number of loop iterations.

      The ForEach task chain is processed once for each column entry of a VARA object.

      If the column or variable does not include an entry, the status of the START object is Empty. The tasks are skipped and their status within the Workflow is Unprocessed (neither tasks are created nor RunIDs are assigned).

      If the VARA object cannot be accessed because its Agent is not available, the Workflow switches to Waiting for Agent status.

    • PromptSet/Script array

      An array is used as the source. The task is processed once per element (value) of the specified array.

      You can create arrays using either PromptSets (use the checkbox element) or a script.

  • Name

    Name of the variable object or array, depending on the selected source.

    • For variables: You cannot limit the selection to a variable type.
    • For arrays: It must be specified without a leading & character. You can use empty index brackets [].

  • Column

    Available only if the source is a variable object. Column of the selected VARA object. Specifying a value is mandatory.

    Important! Do not enter 0 here. If you do so, the system changes it to 1.

    Specifying column 1 has the effect that the Key column (in static VARA objects) or the result column (in dynamic variables) will be used.

  • Publish Value as

    The name of the VARA object that is used to provide the source value to the Workflow.

    Depending on the source this will be either the entry of the Variable object or the value of the array that is currently used and complies with the loop cycle.

    Since the object variable is passed on to the Workflow, it can be used within the workflow tasks.

    Requirements: The Inherit from Parent setting must be activated in the objects. It is not possible to use this value to change the alias of a task in the Workflow.

See also: