Differences

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

--- transformations:skiponcondition [2020/07/06 06:56] – created dmitry
+++ transformations:skiponcondition [2021/06/04 13:25] – craigt
@@ Line 1: / Line 1: @@
-===== Skip actions on condition =====
+{{ transformations:SkipOnConditionAction.png}}
+====== SKIP ACTIONS ON CONDITION ======
+Category: Workflow / Internal \\
-This action skips the rest of actions in table if the specified condition is not fulfilled.
+\\
+=====Description=====
+This action skips the rest of the actions in the table if the specified condition is not fulfilled.\\
-For a detailed explanation see [[https://community.easymorph.com/t/announcement-the-skip-actions-on-condition-action/1915|Announcement: the "Skip actions on condition" action]].
+\\
+=====Use cases=====
+Provides a simpler way to arrange conditional workflows by avoiding unnecessary actions based on a condition.
+\\
+=====Action settings=====
+^Setting^Description^
+|Skip the rest of actions if|Select the condition under which the the remaining actions in the table are skipped.  See table below.\\  Options:  //Skip if table is empty//, //Skip if table is NOT empty//, //Skip if the condition is true for EVERY row//, or\\ //Skip if the condition is true for ANY row//.|
+|If actions are skipped,\\ the final dataset is|In cases when actions are skipped, select what to use for the final dataset.  Options:  //The output of the\\ last calculated action// or //Empty//.|
+\\
+====Skip conditions====
+^Condition ^Description ^
+|The table is empty|This option skips the remaining actions in the table if the dataset is empty at the point of the Skip action.|
+|The table is NOT empty|This option skips the remaining actions in the table if the dataset is NOT empty at the point of the Skip action.|
+|The condition is true for EVERY row|This option skips the remaining actions in the table if the entered condition evaluates to TRUE for every row in the dataset at the time of the Skip action.|
+|The condition is true for ANY row|This option skips the remaining actions in the table if the entered condition evaluates to TRUE for any row in the dataset at the time of the Skip action.|
+For either of the "condition" options, select how EasyMorph will react //if the condition refers to a field, but the table has no rows// (e.g. data) at the time of the Skip action.  Options:  //Skip anyway// or //Do NOT skip//.\\
+\\
+=====Examples=====
+In the table below, the condition of the //Skip on condition// action is not fulfilled (evaluates to FALSE), therefore the following actions have been executed and their pictograms look usual.\\
+{{https://community.easymorph.com/uploads/default/original/2X/f/f8a71586752280bf4e2b0e52b9ee3c1ae4178c5f.png  }}
+\\ \\ \\ \\ \\ \\ \\ \\ \\
+\\
+Using the same table, but this time the condition is fulfilled (evaluates to TRUE). The actions after the //Skip on condition// action are skipped.\\
+\\
+{{https://community.easymorph.com/uploads/default/original/2X/e/e46c6d229aeb1049cb0c359bc4f9afb0452c3f4f.png  }}
+\\ \\ \\ \\ \\ \\ \\ \\ \\
+\\
+Notice 2 things:
+  * The small “fast forward” icon over the skipped actions’ pictograms.
+  * The icon of the “Skip actions on condition” action looks different when the condition is fulfilled.
+\\
+=====See also=====
+  * [[transformations:halt|Halt on condition]]