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	Clear fix versions when state changes to "Can't reproduce", "Duplicate", "Won't fix", "Incomplete", or "Obsolete" (on-change)

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.

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.

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: 29 February 2024