Differences

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

--- transformations:skiponcondition [2020/07/06 06:56] – created dmitry
+++ transformations:skiponcondition [2023/01/26 20:25] (current) – [See also] 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 last two "The condition is true..." 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.
+\\
+====Community examples====
+  * [[https://community.easymorph.com/t//1221/2|Optional calculations with columns]] ([[https://community.easymorph.com/uploads/short-url/xdMJcC4iCkM1HopeOv5m0VqEuvh.morph|Project]]; Module: //Main//; Group: //Tab 1//; Table: //Optional calculation//; Action position: //2//)
+  * [[https://community.easymorph.com/t//2306/7|Ideas for generating random password strings?]] ([[https://community.easymorph.com/uploads/short-url/lJo9Cm9I7zuTvfLiw9pMHmwoUHs.morph|Project]]; Module: //Main//; Group: //Group 1//; Table: //Latin characters//; Action position: //1//)
+  * [[https://community.easymorph.com/t//2421/8|“Merge another table” action - merge all columns (independently of the column name)]] ([[https://community.easymorph.com/uploads/short-url/jHsMLkfW9YZVmGYNYtayhOt1VkJ.morph|Project]]; Module: //Merge//; Group: //Merge//;\\ Table: //Merge tables//; Action position: //4//)
+  * [[https://community.easymorph.com/t//2667/1|Run a task only when free RAM is above threshold]] ([[https://community.easymorph.com/uploads/short-url/aU83eid5IQaSt2mJk8hybsitpw3.morph|Project]]; Module: //MemInfo//; Group: //Tab 1//; Table: //Table 1//; Action position: //5//)
+\\
+=====See also=====
+  * [[transformations:halt|Halt on condition]]
+  * [[transformations:skiponconditioninanothertable|Skip on condition in another table]]