From wiki.ginstr.com
Jump to: navigation, search
m (fixed typos)
Line 3: Line 3:
 
[[Category:Action_Library]]
 
[[Category:Action_Library]]
  
;Description: Used exclusively with <code>[[Variables]]</code> 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
+
;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 forEach action execution  
+
;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 stop gn: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
ACTIONS list of actions which will be executed continuously until all rows are iterated

Example

variable/listId - list used for iteration
variable/listId(rowColumnName1) - retrieving value from rowColumnName1 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
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]
ACTIONS list of actions which will be executed continuously until all rows are iterated

Example

@variable/employee_allowedDivisions - list used for iteration
divisionName - 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]]