YouTrack InCloud 2021.4 Help

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:

  1. From the Administration menu in the application header, select Workflows.

  2. Find a workflow that was created using the constructor and select it in the list.

  3. 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.

The YouTrack 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 header for the workflow 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:

Action

Description

Convert to code

This action converts the current workflow to its JavaScript representation. Once a workflow that has been created in the visual editor has been converted to code, it is only available for editing in the web-based workflow editor that supports JavaScript. For more information, see Web-based Workflow Editor.

Export

This action downloads the current workflow as a ZIP archive.

Delete workflow

Following a confirmation prompt, permanently deletes the current workflow from YouTrack.

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 sidebar for the workflow constructor.

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 header for a rule 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:

Action

Description

Clone

Adds a clone of the current rule to the workflow.

Delete rule

Following a confirmation prompt, permanently deletes the workflow rule.

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.

  • On-change rules are initialized whenever an update is applied to an issue. No additional triggers are taken into consideration.

  • An on-schedule rule is triggered on a set schedule. The triggers section for this rule type lets you choose a Schedule and add an optional filter that determines which issues are eligible for processing. For more information, see On-schedule Rules.

  • An action rule is triggered when users select the corresponding action in an issue or apply the action in a command. The triggers section for this rule type lets you enter the name of the custom Action. For more information, see Action Rules.

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 in the workflow constructor.

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.

Event log in the workflow constructor.

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.

Last modified: 27 October 2021