Loops. While. Loops can be used:

Transcription

1 Loops Loops can be used: to repeat a sequence of actions until some condition is met (While, Retry) or a defined number of times (Repeat) to iterate through lists and tables (For Each) and contain other actions (clicks, drags, keystrokes) as their children. Loops in Actions Library Types of Loops While Repeat Retry For Each While This loop will keep running until the indicated conditions become false.

2 In the example above, the While loop is used to scroll a page until a specific button is found, afterwards the loop will be finished and bot will execute a mouse click. If the While condition contains a variable which value is not modified in the loop body, this can cause an infinite loop. In the example above, the ${isimgfound} variable is modified in the Find Image action it is used to save the action result (true or false). Properties Boolean expression - compare values of two variables, or of a variable and a specific value. Actions nested in this loop will continue to be executed while this expression is true. First operand - variable or string Comparison operator: equals (=) not equals (!=) greater than (>) greater than or equals (>=) less than (<) less than or equals (<=) contains (substring) not contains (substring) empty value not empty value matches regexp not matches regexp Second operand - variable or string (if available) How to Use Comparison Operators String type String 1 equals (=) String 2 String 1 is equal to String 2. String 1 not equals (!=) String 2 String 1 is not equal to String 2. String 1 greater than (>) String 2 String 1 is greater than String 2. String 1 greater than or equals (>=) String 2 String 1 is greater than or equal to String 2. String 1 less than (<) String 2 String 1 is less than String 2.

3 String 1 less than or equals (<=) String 2 String 1 is less than or equal to St ring 2. String 1 contains String 2 String 1 contains String 2. String 1 not contains String 2 String 1 does not contain String 2. String 1 is empty N/A String 1 is an empty string value. String 1 is not empty N/A String 1 is not an empty string value. String 1 matches regular expression Regular expression, e.g [A-Za-z]* String 1 not matches regular expression Regular expression, e.g. [A-Za-z0-9]* String 1 matches the regular expression. String 1 does not match the regular expression. = and!= are case sensitive. >, >=, <, <= operators compare strings' length. In case lengths are equal, each character is compared by its Unicode number from left to right. Number type Number 1 equals (=) Number 2 Number 1 is equal to Number 2. Number 1 not equals (!=) Number 2 Number 1 is not equal to Number 2. Number 1 greater than (>) Number 2 Number 1 is greater than Numbe r 2. Number 1 greater than or equals (>=) Number 2 Number 1 is greater than or equals Number 2. Number 1 less than (<) Number 2 Number 1 is less than Number 2. Number 1 less than or equals (<=) Number 2 Number 1 is less than or equals N umber 2. Number 1 matches regular expression Regular expression, e.g. [0-9]* Number 1 not matches regular expression Regular expression, e.g. [1-5]* Number 1 matches the regular expression. Number 1 does not match the regular expression. List type List 1 equals (=) List 2 Size of List 1 equals size of List 2 and all elements of List 1 are the same as in List 2. List 1 not equals (!=) List 2 Size of List 1 is not equal to size of List 2 or all elements of List 1 are not the same as in List 2. List 1 greater than (>) List 2 Size of List 1 is greater than size of List 2. List 1 greater than or equals (>=) List 2 Size of List 1 is greater than or equals size of List 2.

4 List 1 less than (<) List 2 Size of List 1 is less than size of L ist 2. List 1 less than or equals (<=) List 2 Size of List 1 is less than or equals size of List 2. List 1 contains String List 1 contains text from String. List 1 not contains String List 1 contains text from String. List 1 is empty N/A Size of List 1 is 0. List 1 is not empty N/A Size of List 1 is greater than 0. Table type Table 1 equals (=) Table 2 Number of columns, number of rows and content in cells are the same in Table 1 and Table 2. Table 1 not equals (!=) Table 2 Number of columns, number of rows and content in cells are different in Table 1 and Table 2. Table 1 is empty N/A size of Table 1 is 0. Table 1 is not empty N/A size of Table 1 is greater than 0. Date type Date 1 equals (=) Date 2 Date 1 is equal to Date 2. Date 1 not equals (!=) Date 2 Date 1 is not equal to Date 2. Date 1 greater than (>) Date 2 Date 1 is greater than Date 2. Date 1 greater than or equals (>=) Date 2 Date 1 is greater than or equals Date 2. Date 1 less than (<) Date 2 Date 1 is less than Date 2. Date 1 less than or equals (<=) Date 2 Date 1 is less than or equals Date 2. Boolean type Boolean 1 equals (=) Boolean 2 Boolean 1 is equal to Boolean 2. Boolean 1 not equals (!=) Boolean 2 Boolean 1 is not equal to Boolean 2. Date, Table, List in operands should be defined as variables: ${invoice_date}, ${customer_table}, ${contact_list} String, Number, Boolean in operands can be defined: explicitly: Some text, , false or as a variable: ${string_1}, ${account_number}, ${is_enabled} Repeat This loop is used to repeat a set of actions a given number of times.

5 Possible use cases: click through pagination, repeat key press (DOWN_ARROW or TAB 7 times), etc. Properties Number of repeats - you need to know the exact number of repeats. If the exact number is unknown, use the While loop or For Each. Retry The nested actions will be repeated until no exceptions occur or the maximal number of retries is reached. Properties Maximal number of retries - this parameter is needed to avoid infinite loop.

6 For Each This loop runs once for each element in a List or row/column in a Table. Inside of this loop, you can use the ${element} variable which contains the current List or Table element. Properties Temporary variable name default name is ${item}. You can choose any other name that differs from existing variables. List or table variable this variable will be used for iteration. Each column/each row (for tables only) choose whether to perform these actions on each column or each row of the table (iterate horizontally or vertically). Filter enter one or more specific numbers or ranges. e.g. 1, 5, All items outside these ranges will be excluded. Usage Use the ${item} variable defined in the For Each loop in its nested actions (e.g. Enter Keystrokes) when you are iterating over a Table or List.

7 List Example This example can be used to populate an Excel column with values from a List variable Variable: ${mylist} : [Hydrogen, Helium, Lithium] Excel initial state: For Each ${item} in ${mylist} Enter Keystrokes (DOWN) Enter Keystrokes ${item} Action Flow Iterations Result Arrow down Hydrogen Arrow down Helium Arrow down Lithium When using variables for actions inside a For Each loop with tables, an additional Index field is displayed. This happens because you are iterating by table rows or columns, which are Lists.

8