Transition affected issues when releasing a version (manually)

Use case

During new software releases you get to the point where all related issues within Jira have to be released. You could do this using a project event trigger as described in this use case. If you want to have a more fine-grained control you might want to kick-off this process manually. At this point our Manual Trigger comes in handy!

The following rule will build on the project event use case but instead use the manual trigger.

⚒️ Configuration

Manual trigger

Create a new rule and name it appropriately.

Providing a description will help you to identify what the rule does but this step is optional.

Add a Trigger → Manual

No further configuration needed. The rule will only be executed if a user hits the Execute button.

JQL selector

Add Selector → JQL Selector

JQL Query

Use the following Expression:

Bash

fixversion = nnnnn
# Replace nnnnn with the actual version that got released

Transition issue action

Next to the JQL Selector click on Add → Action → Transition issue

Mode

Choose Transition to status

Status

Choose Done

The target status has to be reachable from the current status, otherwise, the action will not be executed.

📹 Screencast

This is how the configuration above should look on your screen

📤 Import the example

Import the JSON file below to get started in no time.

JSON

After importing the JSON file, make sure to check the configuration of the rule. Non-existing configuration elements (issue types, fields, values etc.) will be highlighted.

JavaScript

{
    "name": "Transition affected issues when releasing a version",
    "description": "",
    "creator": "admin",
    "status": false,
    "triggerData": "",
    "triggerType": "MANUAL",
    "configuration": {
        "refs": [
            "issue",
            "system",
            "trigger.issue",
            "trigger.parent"
        ],
        "actingUser": "field_00020",
        "triggerType": ""
    },
    "children": [
        {
            "sequence": 0,
            "type": "JQL_SELECTOR",
            "ruleEntityType": "SELECTOR",
            "configuration": {
                "refs": [
                    "system"
                ],
                "jql": "project = TIS and fixVersion = 1.9",
                "jqlParsingMode": "jql",
                "actingUser": "field_00020"
            },
            "children": [
                {
                    "sequence": 0,
                    "type": "TRANSITION_ISSUE",
                    "ruleEntityType": "ACTION",
                    "configuration": {
                        "refs": [
                            "issue",
                            "issues",
                            "selector.issue",
                            "selector.parent",
                            "system"
                        ],
                        "option": "status",
                        "status": "10012",
                        "actingUser": "field_00020"
                    },
                    "children": null,
                    "hasChildren": false
                }
            ],
            "hasChildren": true
        }
    ],
    "hasChildren": true
}

📚 Related use cases

Title	Automated action	Label
Close tickets after version release	Transition issue action	STAFF PICK
Transition issues when assigned to a developer	Transition issue action
Transition affected issues when releasing a version (manually)	Transition issue action
Transition affected issues when releasing a version (automatically)	Transition issue action	STAFF PICK
Schedule the escalation of overdue issues	Transition Issue
Schedule issues for re-submission	Transition issue action
Resolve issues when all options of a checklist are checked	Transition issue action
Re-open issue when a new comment is added	Transition issue action
Keep the status of parents and sub-tasks in sync	Transition issue action	STAFF PICK
Close epic when stories are done	Transition issue action
Automatically close sub-tasks when parent is completed	Transition issue action	STAFF PICK
Close stories when epic is done	Transition issue action
Automatically close parent when all sub-tasks are done	Transition issue action	STAFF PICK