Workflow Constructor
The Workflow Constructor is a no-code drag-and-drop interface that lets you build automations using predefined conditions and actions.
To access the workflow constructor:
From the Administration menu in the application header, select Workflows.
Find a workflow that was created using the constructor and select it in the list.
Click the Edit workflow button in the sidebar.
The selected workflow opens in the workflow constructor.
You can also access the page by opening a new workflow in the workflow constructor. From the Workflows list, click the New workflow button, then select Workflow Constructor.
Workflow Header
The top section of the workflow constructor displays interactive controls that let you manage the workflow that is currently displayed in the constructor.
The following controls are displayed in the header of the Workflows page:
Control | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
Workflow title | Stores the title for the current workflow. To edit the title, click the text and type your changes directly in the input field. | ||||||||
Show more | Shows the list of actions that are available for the current workflow. The following actions are available:
| ||||||||
Projects | Attaches the current workflow to the selected projects. | ||||||||
Save | Saves changes to the current workflow. | ||||||||
Open | Opens a compatible workflow in the workflow constructor. Additional options in this menu let you delete workflows or open a new workflow. | ||||||||
Fullscreen mode | Toggles fullscreen mode on and off. Fullscreen mode hides the application header and footer, giving you more space to work with the constructor. | ||||||||
Add rule | Opens a dialog where you can select a rule type, adding a rule to the current workflow. |
Each of the rules that belong to the current workflow is displayed on its own tab in the workflow constructor.
The icon indicates the rule type. The workflow constructor supports on-change, on-schedule, and action rules.
The tab displays the name of the workflow rule.
The indicator shows the current status for the workflow rule — green when active, grey when inactivated.
Blocks
The left side of the workflow constructor displays a list of blocks that you can use to build workflows.
The blocks are organized into three sections.
The Building Blocks section contains common operators and expressions. Use these blocks to combine various conditions and actions.
To learn more, see Building Blocks.
The Conditions section contains predefined checks for a variety of circumstances.
To learn more, see Conditions.
The Actions section contains all of the actions that can be applied to issues using workflows.
To learn more, see Actions.
Use the input field at the top of this panel to filter the list or blocks by name. This can help you quickly find blocks that can check for or update specific items, like comments, links, tags, and more.
Rule Header
Each rule has a set of interactive controls that let you manage the rule that is currently displayed in the workflow constructor.
The following controls are displayed in the header for each workflow rule:
Control | Description | ||||||
|---|---|---|---|---|---|---|---|
Rule type | Displays the icon for the rule type that is assigned to the current rule. To change the rule type, click the icon and select another type. You can freely switch between different rule types without losing the settings for rules that support triggers. | ||||||
Rule name | Stores the name of the current workflow rule. To edit the name, click the text and type your changes directly in the input field. | ||||||
Show more | Shows the list of actions that are available for the current rule. The following actions are available:
| ||||||
Active | Toggles the status for the current rule. Before you can activate a workflow rule, it needs to be assigned to at least one project and must be saved. As you can't save a workflow that hasn't been given a title, the title is also required. Once a rule is active in a project, the business logic that is stored in the saved version of the rule is applied to all issues in the selected projects. Unsaved changes in the workflow constructor are ignored. | ||||||
Triggers | Stores the initial conditions that initialize the workflow rule.
|
Prerequisites
This section of the constructor stores the set of conditions that must be present for the rule to run.
Define the base criteria by dragging conditions to the Prerequisites section of the workflow rule.
When adding multiple conditions, each condition is automatically connected with a logical AND operator. This means that the prerequisite for running the workflow rule is only met when all of the conditions in the Prerequisites section are met.
You can combine conditions in different ways using building blocks. To learn more, see Building Blocks.
Actions
This section of the constructor stores the set of updates that are applied to issues when the conditions in the Prerequisites section have been satisfied.
Define the actions to be taken by dragging one or more action blocks to the Actions section of the workflow rule.
Use the Check for additional conditions action to perform additional checks during the transaction. For more information, see Check for Additional Conditions.
Logging and Validation
The bottom section of the workflow constructor helps you identify and fix problems with the workflow rule.
Validity checks tell you when a rule contains references to elements that are not available in the projects where the rule is active.
For changes that can be fixed automatically, you can click the Update project and add the missing elements to the project settings without leaving the workflow constructor.
Other problems like missing tags or reference issues must be fixed by creating the missing items manually in another area of the application.
The validity checks are only shown when there are problems detected. Otherwise, the event log is active.
The event log displays any errors that have prevented the workflow rule from running as expected. Use this information to troubleshoot problems and detect conflicts with other workflow rules.
The following controls are available in the event log:
Control | Description |
|---|---|
Logging | Toggles the logging feature for the current rule. You can only enable logging for active rules. Before you can activate a workflow rule, it needs to be assigned to at least one project and must be saved. As you can't save a workflow that hasn't been given a title, the title is also required. |
Filter | Filters the list of log entries to show entries that match a substring. Click this control a second time to hide the filter. |
Refresh | Reloads the list, displaying new log entries that were added after the page was loaded. |
Download | Downloads the log entries that are currently displayed in the console as a file. |
Clear | Removes the current log entries from the event log. |