From wiki.ginstr.com
Jump to: navigation, search
(Action signatures)
Line 8: Line 8:
 
==Action signatures==
 
==Action signatures==
  
===Repeat the execution of commands based on value===
+
===Repeat the execution of commands based on list source===
  
 
;<code>[gn:act_forEach]|[source;ACTIONS]</code>
 
;<code>[gn:act_forEach]|[source;ACTIONS]</code>
Line 35: Line 35:
 
<code>[gn:act_forEach]|[variable/listId;[gn:act_rawWriteValues]|[tableId;column1,column2;variable/listId(rowColumnName1),+id/listRow]]
 
<code>[gn:act_forEach]|[variable/listId;[gn:act_rawWriteValues]|[tableId;column1,column2;variable/listId(rowColumnName1),+id/listRow]]
 
</code>
 
</code>
 +
<hr>
 +
 +
===Repeat the execution of commands based on list source with defined column name===
 +
 +
;<code>[gn:act_forEach]|[source,column;ACTIONS]</code>
 +
 +
{| class="wikitable sortable" style="font-size: 85%; text-align: left;"
 +
|-
 +
! scope="col" | Parameter
 +
! scope="col" | Description
 +
|-
 +
| [[source]]
 +
| [[source]] from where the while action is using value as expression parameter
 +
* Valid [[source|sources]]:
 +
** [[Datatypes#rows|rows]]
 +
** [[Datatypes#rowsColumn|rowsColumn]]
 +
|-
 +
| [[configuration.xml#Column|column]]
 +
| [[configuration.xml#Column|column]] name which will be internaly added as parameter to [[source]] reference names in actions which will be executed in forEach action.
 +
:e.g.
 +
:<code>[gn:act_getRow]|[@variable/employee_allowedDivisions,@variable/divisionIndex;;@variable/currentDivisionText]</code>
 +
:to
 +
:<code>[gn:act_getRow]|[@variable/employee_allowedDivisions(_id),@variable/divisionIndex;;@variable/currentDivisionText]</code>
 +
 +
* Valid [[source|sources]]:
 +
** hardcoded
 +
|-
 +
| [[Action_Library|ACTIONS]]
 +
| list of actions which will be executed continuously until all rows are iterated
 +
|-
 +
|}
 +
 +
====Example====
 +
<code>@variable/employee_allowedDivisions</code> - list used for iteration<br>
 +
<code>_id</code> - column name<br>
 +
<code>[gn:act_getRow]|[@variable/employee_allowedDivisions,@variable/divisionIndex;;@variable/currentDivisionText]</code> - action<br><br>
 +
<code>[gn:act_forEach]|[@variable/employee_allowedDivisions,_id;[gn:act_getRow]|[@variable/employee_allowedDivisions,@variable/divisionIndex;;@variable/currentDivisionText]]</code>
 
<hr>
 
<hr>

Revision as of 09:58, 7 April 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

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 internaly added as parameter to source reference names in actions which will be executed in forEach action.
e.g.
[gn:act_getRow]|[@variable/employee_allowedDivisions,@variable/divisionIndex;;@variable/currentDivisionText]
to
[gn:act_getRow]|[@variable/employee_allowedDivisions(_id),@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
_id - column name
[gn:act_getRow]|[@variable/employee_allowedDivisions,@variable/divisionIndex;;@variable/currentDivisionText] - action

[gn:act_forEach]|[@variable/employee_allowedDivisions,_id;[gn:act_getRow]|[@variable/employee_allowedDivisions,@variable/divisionIndex;;@variable/currentDivisionText]]