YouTrack Server 2023.3 Help

Clear Fix Versions

This workflow removes any values in the Fix versions field when an issue is assigned a state that does not require a fix version. For states like Won't Fix and Obsolete, the Fix version is irrelevant. For Duplicate issues, the Fix versions field should be set when the duplicated issue is resolved.

Name

@jetbrains/youtrack-workflow-clear-fix-versions

Auto-attached

no

Rules

Use Case

This workflow ensures that you don't track issues for product releases if they are not fixed in any release. It also prevents you from setting a fix version for duplicate issues.

Rules

When an issue is assigned any of the states mentioned in the on-change rule, all values are removed from the Fix versions field.

Clear fix versions when state changes to "Can't reproduce", "Duplicate", "Won't fix", "Incomplete", or "Obsolete"

This on-change rule behaves in the following way:

Rule Prerequisites

Whenever an issue is created or updated in the project where the rule is active, it checks the issue for the following conditions:

Conditions

Description

Field Matches Specified Criteria

This condition block is configured with the following settings:

  • Field: State

  • Condition: changes from

  • Value: Any value

  • to: Any value

This checks for any change in the value for the State field.

Field Matches Specified Criteria

Next five condition blocks wrapped inside an OR building block check to see if the value for the State field changes to Can't reproduce, Duplicate, Won't fix, Incomplete, or Obsolete. These condition blocks are configured with the following settings:

  • Field: State

  • Condition: is

  • Value: each block is configured to check for one of the target values that are relevant to the workflow logic.

By grouping these blocks with an OR operator, only one of the conditions must be true for the workflow to continue.

Field Matches Specified Criteria

This condition block is configured with the following settings:

  • Field: Fix versions

  • Condition: is set

This checks to see if the value for the Fix versions field has been set. The workflow will only continue processing the issue if this field is not empty.

The two primary conditions and the set of conditions that are grouped inside an OR operator are joined with implicit AND operators. This means that the workflow will only apply the changes specified in the Actions section if all conditions are satisfied.

Specifically, this means that the rule only updates issues where the value for the State field is set to one of the specified target values and the Fix versions field is not empty.

Rule Actions

If all conditions are met for the current issue, the workflow automatically applies the following changes:

Action

Description

Update the Value in a Field

This action clears the value for the Fix versions field. This block is configured with the following settings:

  • Field: Fix versions

  • Mode: clear

Show an Alert

This action notifies the user that additional changes have been applied to the current issue by the workflow. This block is configured as follows:

  • Style: Acknowledgment

  • Message: 'Fix versions' have been cleared.

This means that the specified message is displayed as a standard alert in the YouTrack application interface.

Last modified: 22 March 2024