Loop Expression Action

Declaration

<AMLOOPEXPRESSION EXPRESSION="text [valid BASIC expression]" CONDITION="text [options]">
  (block of steps to loop)

See Also

Loop, End Loop, Loop Files, Loop Windows, Loop Processes, Loop Dataset, Loop List, Break

Description

Loops while or until the expression specified is true. With each successive loop, the expression is reevaluated. The loop ends after the expression condition is met or when a Break is encountered.

Practical Usage

To continue to execute a block of steps while or until a condition is true.

Parameters

General Tab

Condition

Text [options], Optional default: while
MARKUP: CONDITION="until"

Specifies whether the loop should continue while the expression is true or until it is true.

The available options are:

Window Handle Variable

Text, Required
MARKUP: EXPRESSION="thenumber = 55"

Specifies a valid BASIC expression that should be evaluated on each loop.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Examples

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<!--- simple incrementing counter --->
<AMVARIABLE NAME="mycounter">1</AMVARIABLE>
<AMLOOPEXPRESSION EXPRESSION="mycounter=5" CONDITION="until">
<AMINCREMENTVARIABLE RESULTVARIABLE="mycounter">
</AMLOOP>