User Tools

Site Tools


action:For_Each

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
action:For_Each [2017/09/07 01:44]
peternlewis [See also]
action:For_Each [2021/10/12 23:24] (current)
peternlewis
Line 1: Line 1:
-{{:​action:​for-each-icon.png?​nolink |}} 
 ====== For Each Action ====== ====== For Each Action ======
  
  
-The For Each action loops over a set of [collections](:​Collections) of items, setting a variable to each value and executing the contained actions. ​+The *For Eachaction loops over a set of [collections](:​Collections) of items, setting a variable to each value and executing the contained actions
 + 
 +It is one of several Actions that _loop_ through a set of other Actions until some criteria is met.
  
 Whenever you need to deal with a list of things (lines, files, volumes, numbers, etc), the For Each action is a good place to start. ​ Whenever you need to deal with a list of things (lines, files, volumes, numbers, etc), the For Each action is a good place to start. ​
Line 18: Line 19:
   - Add a collection by clicking the green + button beside //New Collection//​ to select from a list of available collections. You can learn more about the available collections on the [[:​Collections]] page.   - Add a collection by clicking the green + button beside //New Collection//​ to select from a list of available collections. You can learn more about the available collections on the [[:​Collections]] page.
   - When you choose a specific collection, further options may become available.   - When you choose a specific collection, further options may become available.
-  - Drag one or more actions into the //No Action// (which means no actions have been added yet) area.+  - Add one or more actions into the //No Action// (which means no actions have been added yet) area.
     * These actions will operate on each item in the Collection that is stored in the Variable from Step #2     * These actions will operate on each item in the Collection that is stored in the Variable from Step #2
  
 You can break out of the loop, retry this iteration, or skip to the next iteration with the [[actions:​Redirect_Control_Flow|actions:​Redirect Control Flow]] actions. You can break out of the loop, retry this iteration, or skip to the next iteration with the [[actions:​Redirect_Control_Flow|actions:​Redirect Control Flow]] actions.
 +
 +There is an option in the action (gear) ⚙ menu to display the progress of the For Each action (v10.0+).
  
 ===== Examples ===== ===== Examples =====
Line 44: Line 47:
 * [[action:​Until|Until]] action * [[action:​Until|Until]] action
 * [[action:​While|While]] action * [[action:​While|While]] action
-* [[Redirect_Control_Flow|actions:Redirect Control Flow]] actions+* [[action:Assert|Assert]] action
 * [[:​Actions|See all actions]] * [[:​Actions|See all actions]]
  
Line 51: Line 54:
 * [[trigger:​Typed String|trigger:​Typed String]] * [[trigger:​Typed String|trigger:​Typed String]]
 * [[:​Triggers|See all triggers]] * [[:​Triggers|See all triggers]]
- 
  
 ==== Forum ==== ==== Forum ====
action/For_Each.1504763071.txt.gz · Last modified: 2017/09/07 01:44 by peternlewis