YouTrack InCloud 2021.4 Help

Actions

The Workflow Constructor supports a wide variety of predefined actions. These actions let you specify the changes that should be applied when the prerequisite criteria for running the workflow rule have been satisfied.

Define the actions to be taken by dragging one or more action blocks to the Actions section of the workflow rule.

Check for Additional Conditions

This action verifies that specific conditions that were not included in the prerequisites block have also been met. If any of these checks fail, all changes are rolled back to the initial state and the specified error message is displayed in the user interface.

  • Add one or more conditions by dragging them to the body of the action block. 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.

  • Use building blocks to combine conditions in different ways. To learn more, see Building Blocks.

Use the following setting to customize this action:

Setting

Description

Error message

Stores the message text that is shown to the user when the conditions defined in this action block are not met.

Update the Value in a Field

This action sets, clears, or changes the current value for the specified field.

Use the following settings to customize this action:

Setting

Description

Field

Specifies which field to update. The available options for this setting are restricted to the set of fields that are used in the projects to which the workflow is attached.

Action

Determines which action is applied to the selected field.

The following options are available:

Option

Description

set

The value for the selected field is set to the selected value. If the field stores multiple values, any existing values are overwritten.

clear

The value for the selected field is set to an empty value.

add

Adds the selected value to the selected field. This option is only available for fields that store multiple values.

remove

Removes the selected value from the selected field. This option is only available for fields that store multiple values.

To

Stores the value to which the field should be set.

This setting is only shown when the Action is set to set, add, or remove.

Show an Alert

This action displays a message as an alert in the YouTrack web app. Alerts are displayed in the lower-right corner of the application user interface. They are shown for approximately five seconds and are dismissed automatically.

Use the following settings to customize this action:

Setting

Description

Style

Determines which style is applied to the message.

The following options are available:

Option

Description

Acknowledgment

The message is displayed as a standard alert.

Error

The specified message is displayed as an error.

Message

Stores the alert message text.

Update the Issue Visibility

This action makes the issue visible only to a specific user or group.

Use the following settings to customize this action:

Setting

Description

Action

Determines which action is applied to the visibility setting.

The following options are available:

Option

Description

Set

The issue visibility is set to the specified user or group.

Clear

The visibility restrictions are removed from the issue.

Add

The specified user or group is added to the visibility setting for the issue.

Remove

The specified user or group is removed from the visibility setting for the issue.

Visible to

Stores the user or group for which the issue visibility should be set.

This setting is only shown when the Action is set to Set, Add, or Remove.

The following options are available:

Option

Description

Issue readers

The specified action applies to the collection of users and groups who have permission to read issues in the current project.

Reporter

The specified action applies to the user who reported the issue.

User

The specified action applies to a specific user. When used, you have the option to specify whether the action applies to the current user, a user that is stored in a custom field, or a specific user.

Group

The specified action applies to a specific group. When used, you have the option to specify whether the action applies to a group that is stored in a custom field or a specific group.

Create an Issue

This action automatically generates an issue based on the definition that is stores in this action block.

Use the following settings to customize this action:

Setting

Description

Reporter

Determines which user is set as the reporter for the new issue.

The following options are available:

Option

Description

Use the current user

The workflow sets the current user as the reporter for the new issue.

Use the value from a custom field

The workflow uses the value from the specified field to find the reporter. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The workflow sets the specified user as the reporter. When used, an additional field for storing the user is added to the condition block.

Summary

Stores the summary for the new issue.

Description

Stores the description for the new issue.

Add field

Adds the selected field to the new issue. When used, you can select the values that are assigned to each field when the issue is created.

Update the Issue Description

This action modifies the current issue description by applying the changes defined in this action block.

Use the following setting to customize this action:

Setting

Description

Description

Stores the new summary description. To preserve the current description text, use :description: as a placeholder.

Update the Issue Summary

This action modifies the current issue summary by applying the changes defined in this action block.

Use the following setting to customize this action:

Setting

Summary

Description

Stores the new summary text. To preserve the current summary text, use :description: as a placeholder.

Move the Issue to Another Project

This action updates the issue by reassigning it to the specified project.

Use the following settings to customize this action:

Setting

Summary

Issue

Determines which issue to move to the target project.

  • With Use the current issue, the current issue is moved to the target project.

  • With Use a specific issue, the selected issue is moved to the target project.

Project

Stores the project that the issue moves to. The following options are available:

Option

Description

Use the project for the current issue.

The issue is moved to the issue that the current issue belongs to.

Use a specific project

The issue is moved to the selected project. When used, an additional field for storing the target project is added to the action block.

Add a Comment

This action adds a comment to an issue

Use the following settings to customize this action:

Setting

Summary

Issue

Determines which issue the comment is added to. The following options are available:

Option

Description

Use the current issue.

The comment is added to the current issue.

Use a specific issue

The comment is added to the selected issue. When used, an additional field for storing the target issue is added to the action block.

Comment text

Stores the text that is added as a comment to the target issue.

Author

Determines which user is designated as the author of the comment. The following options are available:

Option

Description

Use the current user

The comment is added on behalf of the current user.

Use the value from a custom field

The comment is added on behalf of the user who is currently stored as the value for the designated field. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The comment is added on behalf of the specified user. When used, an additional field for storing the user is added to the action block.

Add a Tag

This action adds a tag to an issue.

YouTrack adds the first matching tag that is visible to the user. If a match is not found, a new private tag is created.

Use the following settings to customize this action:

Setting

Summary

Issue

Determines which issue the tag is added to. The following options are available:

Option

Description

Use the current issue.

The tag is added to the current issue.

Use a specific issue

The tag is added to the selected issue. When used, an additional field for storing the target issue is added to the action block.

Tag

Stores the name of the tag that is added to the target issue.

Apply a Command

This action applies a command to an issue.

Use the following settings to customize this action:

Setting

Summary

Issue

Determines which issue the command is applied to. The following options are available:

Option

Description

Use the current issue.

The command is applied to the current issue.

Use a specific issue

The command is applied to the selected issue. When used, an additional field for storing the target issue is added to the action block.

Command

Stores the command that will be applied to the target issue.

Run as

Determines which user account is selected to apply the command to the target issue. When choosing a user account for this setting, pay attention to the permissions that are available to the selected user. If this user doesn't have sufficient permission to apply the specified command, the updates specified in the command are ignored.

The following options are available:

Option

Description

Use the current user

The command is applied on behalf of the current user.

Use the value from a custom field

The command is applied on behalf of the user who is currently stored as the value for the designated field. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The command is applied on behalf of the specified user. When used, an additional field for storing the user is added to the action block.

Delete All Attachments

This action deletes all of the files that are attached to an issue.

Use the following settings to customize this action:

Setting

Summary

Issue

Determines the issue from which all attachments are deleted. The following options are available:

Option

Description

Use the current issue.

All attachments are deleted from the current issue.

Use a specific issue

All attachments are deleted from the selected issue. When used, an additional field for storing the target issue is added to the action block.

Copy the Issue

This action creates a copy of an issue.

Use the following settings to customize this action:

Setting

Summary

Issue

Determines which issue to copy. The following options are available:

Option

Description

Use the current issue.

A copy of the current issue is created.

Use a specific issue

A copy of the selected issue is created. When used, an additional field for storing the target issue is added to the action block.

Project

Determines the project where the copied issue is created. The following options are available:

Option

Description

Use the project for the current issue.

The issue is created in the project that the current issue belongs to.

Use a specific project

The issue is created in the selected project. When used, an additional field for storing the target project is added to the action block.

Remove a Tag

This action removes a tag from an issue.

YouTrack searches through tags owned by the specified user first, then through all other visible tags. If the specified tag is not attached to the issue, an exception is thrown.

Use the following settings to customize this action:

Setting

Summary

Issue

Determines the issue from which the tag is removed. The following options are available:

Option

Description

Use the current issue.

The tag is removed from the current issue.

Use a specific issue

The tag is removed from the specified issue. When used, an additional field for storing the target issue is added to the action block.

Tag

Stores the name of the tag to be removed from the target issue.

Send a Jabber Message

This action sends a message to a user over Jabber.

Use the following settings to customize this action:

Setting

Summary

User

Determines which user is sent the Jabber message. The following options are available:

Option

Description

Use the current user

The Jabber message is sent to the current user.

Use the value from a custom field

The Jabber message is sent to the user who is currently stored as the value for the designated field. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The Jabber message is sent to the specified user. When used, an additional field for storing the user is added to the action block.

Message

Stores the message text that is sent to the designated user over Jabber.

Send an Email Message

This action sends an email message to the address that is stored in the user's profile.

Use the following settings to customize this action:

Setting

Summary

User

Determines which user is sent the email message. The following options are available:

Option

Description

Use the current user

The email message is sent to the current user.

Use the value from a custom field

The email message is sent to the user who is currently stored as the value for the designated field. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The email message is sent to the specified user. When used, an additional field for storing the user is added to the action block.

Subject

Stores the subject of the email message.

Message

Stores the message body of the email that is sent to the designated user.

Remove a Vote

This action removes a vote from an issue on behalf of the user who added it, if this action is allowed.

Use the following settings to customize this action:

Setting

Summary

User

Determines which user is selected for removing the vote. The following options are available:

Option

Description

Use the current user

The vote is removed on behalf of the current user.

Use the value from a custom field

The vote is removed on behalf of the user who is currently stored as the value for the designated field. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The vote is removed on behalf of the specified user. When used, an additional field for storing the user is added to the action block.

Issue

Determines the issue from which the vote is removed. The following options are available:

Option

Description

Use the current issue.

The vote is removed from the current issue.

Use a specific issue

The vote is removed from the specified issue. When used, an additional field for storing the target issue is added to the action block.

Unstar the Issue

This action removes the star from an issue for a specific user.

Use the following settings to customize this action:

Setting

Summary

User

Determines which user is selected for removing the star tag. The following options are available:

Option

Description

Use the current user

The star tag is removed on behalf of the current user.

Use the value from a custom field

The star tag is removed on behalf of the user who is currently stored as the value for the designated field. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The star tag is removed on behalf of the specified user. When used, an additional field for storing the user is added to the action block.

Issue

Determines the issue from which the star tag is removed. The following options are available:

Option

Description

Use the current issue.

The star tag is removed from the current issue.

Use a specific issue

The star tag is removed from the specified issue. When used, an additional field for storing the target issue is added to the action block.

Add a Vote

This action adds a vote to an issue for a specific user.

Use the following settings to customize this action:

Setting

Summary

User

Determines which user is selected for adding the vote. The following options are available:

Option

Description

Use the current user

The vote is added on behalf of the current user.

Use the value from a custom field

The vote is added on behalf of the user who is currently stored as the value for the designated field. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The vote is added on behalf of the specified user. When used, an additional field for storing the user is added to the action block.

Issue

Determines the issue to which the vote is added. The following options are available:

Option

Description

Use the current issue.

The vote is added to the current issue.

Use a specific issue

The vote is added to the specified issue. When used, an additional field for storing the target issue is added to the action block.

Star the Issue

This action adds the star tag to an issue for a specific user.

Use the following settings to customize this action:

Setting

Summary

User

Determines which user is selected for adding the star tag. The following options are available:

Option

Description

Use the current user

The star tag is added on behalf of the current user.

Use the value from a custom field

The star tag is added on behalf of the user who is currently stored as the value for the designated field. When used, an additional field for storing the user field is added to the action block.

Use a specific user

The star tag is added on behalf of the specified user. When used, an additional field for storing the user is added to the action block.

Issue

Determines the issue to which the star tag is added. The following options are available:

Option

Description

Use the current issue.

The star tag is added to the current issue.

Use a specific issue

The star tag is added to the specified issue. When used, an additional field for storing the target issue is added to the action block.

Last modified: 05 November 2021