m (fixed typos) |
|||
Line 3: | Line 3: | ||
[[Category:Action_Library]] | [[Category:Action_Library]] | ||
− | ;Description: Used exclusively with | + | ;Description: Used exclusively with [[:Category:Variables|variables]] of <code>[[Datatypes#rows|rows]]</code>, <code>[[Datatypes#rowsColumn|rowsColumn]]</code>, <code>[[Datatypes#pictures|pictures]]</code>, <code>[[Datatypes#email|email]]</code> datatypes, to repeat the execution of commands, for each element in the list parameter |
;Action returns: void | ;Action returns: void | ||
− | ;Controlling action: <code>[[gn:act_break]]</code> used to stop | + | ;Controlling action: <code>[[gn:act_break]]</code> is used to stop <code>[[gn:act_forEach]]</code> action execution |
==Action signatures== | ==Action signatures== |
Revision as of 12:02, 2 August 2017
gn:act_forEach
- Description
- Used exclusively with variables of
rows
,rowsColumn
,pictures
,email
datatypes, to repeat the execution of commands, for each element in the list parameter
- Action returns
- void
- Controlling action
gn:act_break
is used to stopgn:act_forEach
action execution
Action signatures
Repeat the execution of commands based on list source
[gn:act_forEach]|[source;ACTIONS]
Parameter Description source
source from where the while action is using value as expression parameter - Valid sources:
ACTIONS
list of actions which will be executed continuously until all rows are iterated
Example
variable/listId
- list used for iterationvariable/listId(rowColumnName1)
- retrieving value fromrowColumnName1
column of iterated row
- ⤷
[gn:act_forEach]|[variable/listId;[gn:act_rawWriteValues]|[tableId;column1,column2;variable/listId(rowColumnName1), +id/listRow]]
- ⤷
Repeat the execution of commands based on list source with defined column name
[gn:act_forEach]|[source,column;ACTIONS]
Parameter Description source
source from where the while action is using value as expression parameter - Valid sources:
column
column name which will be internally added as parameter to source reference names in actions which will be executed in for each action. - e.g.
[gn:act_getRow]|[@variable/employee_allowedDivisions, @variable/divisionIndex;;@variable/currentDivisionText]
- to
[gn:act_getRow]|[@variable/employee_allowedDivisions(divisionName), @variable/divisionIndex;;@variable/currentDivisionText]
- Valid sources:
- hardcoded
ACTIONS
list of actions which will be executed continuously until all rows are iterated
Example
@variable/employee_allowedDivisions
- list used for iterationdivisionName
- column name[gn:act_getRow]|[@variable/employee_allowedDivisions,@variable/divisionIndex;;@variable/currentDivisionText]
- action
- ⤷
[gn:act_forEach]|[@variable/employee_allowedDivisions,divisionName;[gn:act_getRow]|[@variable/employee_allowedDivisions, @variable/divisionIndex;;@variable/currentDivisionText]]
- ⤷