Overview
The Starting Rule is the first step in every workflow. Its purpose is to start the workflow automatically when a specific event happens.
How it Works
A starting rule works as follows:
|
System Event Trigger:
|
|
|
Conditions Validation:
Recorded Workflow:
Output Path:
|
Type of Triggers
| Type | Description |
| Scheduled trigger | It is a time-based trigger that defines when the Workflow record runs, based on CRON expressions. |
| Event trigger | Its system event-based trigger that defines when the Workflow record runs, based on a monitored system Object and a specific event related to that Object. |
Path
Each Path represents a possible outcome or branch based on WHEN Conditions.
A Condition is composed of WHEN Conditional blocks.
- WHEN the condition is TRUE → the workflow continues through the corresponding path.
- WHEN the condition is FALSE → the following path condition is evaluated.
For more information on WHEN Conditionals please read: How it Works the WHEN Conditional
How to Configure a Starting Rule Node
To configure a Starting Rule node follow these steps:
Here's an interactive tutorial
- In the Workflows Editor, locate the Starting Rule node and click on its card. The Edit Starting Rule panel is displayed.
- Enter or change the starting rule Name*.
Trigger Type
- Select the Trigger Type: Scheduled trigger or Event trigger.
- Scheduled trigger: Runs the Workflow at set intervals. If the Scheduled trigger option is selected, enter a valid Cron Expression. The workflow will be triggered according to the schedule.
- Event trigger: Triggers the Workflow based on specific events. If the Event trigger option is selected, select the Object and the Event Type that will be monitored. The workflow will be triggered every time the event occurs.
- A Cron Expression is a string consisting of subexpressions (fields) that describe individual details of the schedule.
- In the Cron Expression field, make sure to enter an expression that follows the correct CRON syntax to ensure the Workflow starts at the intended times or intervals.
- A built-in Cron Generator is coming soon.
- The Object dropdown displays all Objects that have a dependency relationship with the Target Object configured during workflow creation.
- The Event Type dropdown lists the events related to the selected Object.
Ending
- (Optional) Click the +ENDING button to add a criteria that defines when the Workflow will be ended.
- Select the Workflow ending criteria that will be applied: After or Stop On.
- After: If the After option is selected, enter an integer number of Occurrences (>0). That specific value is the number of Occurrences (or runs) that the workflow will go through. Once the workflow has run this number of times, it will stop and be considered finished.
- Stop On: If the Stop On option is selected, enter or select the Stop On date (MM/DD/YYYY). The workflow will continue to run until it reaches that date, at which point it will automatically stop.
Conditions
- Enable the Conditions toggle switch to configure WHEN Condition(s) that will define the node output(s).
- Each starting rule can have one or more Paths.
- The Paths are evaluated simultaneously, and only the first matching Path will be followed during the running workflow.
- Click the ellipsis icon next to the WHEN Condition to copy the setup from a configured Template
Listed templates are saved WHEN Conditions, as outlined in step 10.
OR
- Configure a WHEN Condition to evaluate a field value against the condition.
- Click the
next to the WHEN condition.
- Select an Object.
- Click the
next to the Object’s name.
- Select a Field or a Relationship and then a Field.
- Click the
next to the Field’s name.
- Select an Operator.
- Click the
next to the Operator’s name.
- Enter the Value.
Optional: Build Multiple Conditions (AND / OR)
- Click the
next to the entered value.
- Select the AND or OR operator to build another Conditional, and configure it as outlined in step 7-8.
Delete elements within a WHEN Conditional by clicking the icon on the displayed label.
- (Optional) Click +PATH to add a new WHEN Conditional and configure it as outlined in step 7-8.
- (Optional) Click the ellipsis icon
next to the built WHEN Conditional to save the WHEN Conditional as a template. Once saved, it can be reused as outlined in step 7.
Save
- Click SAVE to save the setup. The rule was edited successfully message appears.
The SAVE button is enabled when all the mandatory fields have been completed in the Edit Starting Rule panel.