Versions Compared

Key

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


Page properties
hiddentrue
Tech review

Status
titletodo

Style guide

Status
titletodo

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged

Panel

On this page

Table of Contents
maxLevel2
exclude(On this page|Use case).*
stylecircle
typeflat
separatorpipe

Page properties
hiddentrue
Automated action

Add comment

Use case descriptionAdd a comment to an issue as soon as one of the selected components has been merged.

Complexity

Status
colourGreen
titleBeginner



UI Text Box
sizemedium
typeinfo

Use case

In Jira issues can be categorized not only by issue type or project, but also by components. They can be widely used and offer useful additional information for issues. But it is also possible to merge existing components. By default, you won't notice such changes. That's When a component is deleted in Jira you can "merge" it with an existing component. By default, you will not notice such a change. This is why the following automation rule will take care of these merges.

As soon as a component from the current issue has been merged, the assignee will be notified about this change in a new comment.




UI Steps

Image Modified Project event

UI Step

Excerpt Include
DECADIS:Automation Use Case - Create Rule Step
DECADIS:Automation Use Case - Create Rule Step
nopaneltrue


UI Step

Add a Trigger → Project Event → Component merged

UI Text Box
typeinfo

In this case, the Component merged event will be used. When no project is specified, the trigger will listen on every project for component merges.


Image Modified Issue Component Selector

UI Step

Add Selector → Issue Component Selector

Image Modified Add comment action

UI Step


UI Steps


UI Step

Next to the Issue Component Selector click on Add → Action → Add Comment


UI Step

Comment's text

*

Code Block
linenumberstrue
Hi [~%{selector.issue.assignee}],

the component *%{trigger.component.name}* has been merged. You may want to take a look at this merge.

Cheers!


UI Text Box
typenote

"[~" is the notation for mentioning users by their username.

"*" is the notation for making text bold.





UI Step

Excerpt Include
DECADIS:Automation Use Case - Enable Rule
DECADIS:Automation Use Case - Enable Rule
nopaneltrue




Image Modified Screencast

Multimedia
namenotify-on-component-merge.mp4
width700


Image AddedImport the example

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


UI Expand
titleJSON


UI Text Box
typewarning

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
languagejs
themeMidnight
linenumberstrue
{
    "name": "Notify on component merge",
    "description": "",
    "creator": "admin",
    "status": false,
    "triggerData": "COMPONENT_MERGED_EVENT",
    "triggerType": "PROJECT_EVENT",
    "configuration": {
        "refs": [
            "issue",
            "system",
            "trigger.issue",
            "trigger.parent"
        ],
        "triggerType": "COMPONENT_MERGED_EVENT"
    },
    "children": [
        {
            "sequence": 0,
            "type": "COMPONENT_BASED_SELECTOR",
            "ruleEntityType": "SELECTOR",
            "configuration": {
                "refs": [
                    "component",
                    "project",
                    "system",
                    "trigger",
                    "trigger.component",
                    "trigger.project"
                ],
                "actingUser": "field_00020"
            },
            "children": [
                {
                    "sequence": 0,
                    "type": "ADD_COMMENT",
                    "ruleEntityType": "ACTION",
                    "configuration": {
                        "refs": [
                            "component",
                            "issue",
                            "project",
                            "selector.issue",
                            "selector.parent",
                            "system",
                            "trigger",
                            "trigger.component",
                            "trigger.project"
                        ],
                        "comment": "Hi [~%{selector.issue.assignee}],\r\n\r\nthe component *%{trigger.component.name}* has been merged. You may want to take a look at this merge.\r\n\r\nCheers!",
                        "commentParsingMode": "textBasic",
                        "actingUser": "field_00020",
                        "commentVisibility": "everybody",
                        "sendMail": "true"
                    },
                    "children": null,
                    "hasChildren": false
                }
            ],
            "hasChildren": true
        }
    ],
    "hasChildren": true
}




Image Modified Related use cases

Page properties report
headingsAutomated action, Use case description, ComplexityJWT feature, Label
cqllabel = "use-case-auto" and label = "add-comment" and space = "JWTSDC"


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue


JWT feature

Image Added

Automated action

Add comment action

Label




Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titleto do
Status
colourGreen
titledone
Status
colourYellow
titleneeds review
Status
colourRed
titleflagged