Page History

Versions Compared

Key

This line was added.
This line was removed.
Formatting was changed.

Panel

Use case

A handy option in Jira is to use issue keys in comments to reference them whenever needed. But as the amount of comments grow, it can get hard to keep track of all mentioned issues in the comments. Therefor, the following rule checks for issue keys being added to comments and automatically links them to the current issue.

UI Steps

Issue Commented event

UI Step

Excerpt Include

	DECADIS:Automation Use Case - Create Rule Step
	DECADIS:Automation Use Case - Create Rule Step
nopanel	true

UI Step

Add a trigger → Issue event → Issue Commented

UI Text Box

type	info

No further configuration needed. The automation rule is triggered every time an issue is being transitioned.

Boolean condition

UI Step
Add a Condition → Boolean Condition

UI Step

Expression

Use the following Parser Expression:

Code Block

linenumbers	true

findPattern(%{trigger.issue.lastComment},"([A-Z][A-Z0-9]+)-\\d+") !~ null

UI Expand

title	more info...

UI Text Box

icon	false
type	info

Boolean expressions are logical constructions that return true or false.

The findPattern() expression parser function extracts the issue key from the last comment.

Create issue link action

UI Step

Next to the Boolean Condition click on Add → Action → Create issue link

UI Steps

UI Step

Issue link type

Choose relates to (Relates)

UI Step

Issue selection

Choose Issue List Expression

UI Step

Use the following Parser Expression:

Code Block

linenumbers	true

issueKeysToIssueList(toString(findPattern(%{trigger.issue.lastComment},"([A-Z][A-Z0-9]+)-\\d+")))

UI Expand

title	more info...

UI Text Box

icon	false
type	info

The findPattern() expression parser function extracts the issue key from the last comment.

UI Step

Excerpt Include

	DECADIS:Automation Use Case - Enable Rule
	DECADIS:Automation Use Case - Enable Rule
nopanel	true

Screencast

This is how the configuration above should look on your screen

Multimedia

name	track-issues-mentioned-in-comments.mp4
width	700

Import the example

Import the JSON file below to get started in no time

UI Expand

title	JSON

UI Text Box

type	warning

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.

Code Block

language	js
theme	Midnight
linenumbers	true

{
    "name": "Track issues mentioned in comments",
    "description": "",
    "creator": "admin",
    "status": false,
    "triggerData": "6",
    "triggerType": "ISSUE_EVENT",
    "configuration": {
        "refs": [
            "issue",
            "system",
            "trigger.issue",
            "trigger.parent"
        ],
        "triggerType": "6"
    },
    "children": [
        {
            "sequence": 0,
            "type": "BOOLEAN_CONDITION",
            "ruleEntityType": "CONDITION",
            "configuration": {
                "refs": [
                    "issue",
                    "project",
                    "system",
                    "trigger",
                    "trigger.issue",
                    "trigger.parent"
                ],
                "expression": "findPattern(%{trigger.issue.lastComment}, \"([A-Z][A-Z0-9]+)-\\\\d+\") !~ null",
                "expressionParsingMode": "logical",
                "actingUser": "field_00020"
            },
            "children": [
                {
                    "sequence": 0,
                    "type": "LINK_ISSUE",
                    "ruleEntityType": "ACTION",
                    "configuration": {
                        "refs": [
                            "issue",
                            "project",
                            "system",
                            "trigger",
                            "trigger.issue",
                            "trigger.parent"
                        ],
                        "issueLinkType": "inwards_10003",
                        "destinationIssueSelection": "issues",
                        "destinationIssueSelectionIssues": "issueKeysToIssueList(toString(findPattern(%{trigger.issue.lastComment}, \"([A-Z][A-Z0-9]+)-\\\\d+\")))",
                        "destinationIssueSelectionIssueKeyParsingMode": "textBasic",
                        "actingUser": "field_00020"
                    },
                    "children": null,
                    "hasChildren": false
                }
            ],
            "hasChildren": true
        }
    ],
    "hasChildren": true
}

Related use cases

Page properties report

headings	Automated action, JWT feature, Label
sortBy	Title
cql	label = "use-case-auto" and label = "create-issue-link" and space = "JWTSDC"

Excerpt Include

	DECADIS:Contact support
	DECADIS:Contact support
nopanel	true

Page properties

hidden	true

JWT feature
Automated action	Create issue link action
Parser functions	findPattern() issueKeysToIssueList() toString()
Label

Page properties

hidden	true

Status

Tech review

Status


colour	Green
title	done

Style guide

Status


colour	Green
title	done

Status

title	to do

Status


colour	Green
title	done

Status


colour	Yellow
title	needs review

Status


colour	Red
title	flagged

Content

Space Tools

Versions Compared

Old Version 49

New Version 50

Key

On this page

Use case

Issue Commented event

Boolean condition

Expression

Create issue link action

Issue link type

Issue selection

Screencast

Import the example

Related use cases