Description

Loops through an Automated Workflow array, populating the specified Automated Workflow variable with the current element to perform an action on each element of data in an array. Supports looping the array "horizontally" (row by row, column by column) or "vertically" (column by column, row by row). Supports any size array of any dimensions. Optionally populates a dataset with the array name and current index.

Declaration

<AMLOOP TYPE="ARRAY" ARRAY="Text" RESULTVARIABLE="Text" DIRECTION="Text" DATASET="Text">

Example

<AMLOOP TYPE="ARRAY" ARRAY="myarray" RESULTVARIABLE="ArrayElement" DIRECTION="vertical" DATASET="ArrayIndexDS">

General Tab Parameters

Array name: Specifies the name of the array to loop. The array must be created and populated in earlier steps using the Create Array action and the Set Variable action.

Text, Required
MARKUP: ARRAY="myarray"

Populate variable with current element value: Specifies an already-created variable that should be populated with the next data element on each successive loop. The variable must be created in an earlier step using the Create Variable action.

Text, Required
MARKUP: RESULTVARIABLE="varname"

Create and populate dataset with current indexes: Specifies the name of a dataset to be created and populated with the current index.

Text, Optional
MARKUP: DATASET="ArrayIndexDS"

Ordering: Specifies the direction of looping.

• First dimension first (horizontal looping): first dimension first, row by row, column by column.

• Last dimension first (vertical looping): last dimension first, column by column, row by row.

Text, Optional - Default horizontal
MARKUP: DIRECTION="vertical"