Create a new rule

Select the Create rule button.

Create a trigger for the rule

Select the trigger Field value changed in section Issue Triggers.

The rule is triggered when one or more fields of an issue are changed.

Define fields for the trigger

Select the fields to be monitored for changes when an issue is edited:

Open

In this example, whenever the field Description is edited the rule is triggered.

Add project restriction (optional for a global rule)

Create new condition: Issue fields condition:

Open

If a rule is project-specific the restriction to that project is assumed and this condition is not needed. If a rule is global, it can still be limited to certain projects by adding this condition.

Further restriction, e.g. to issue types or via JQL could be applied.

Store issue key in variable

Select new action Create variable in section Advanced:

The variable changedIssue is used to store the issue key for use later in the rule. Specify{{issue.key}}as the “smart value”.

Process linked issues

Select new branch Branch rule / related issues:

This branch runs through all issues that are linked with a given set of link types. You need to specify the name of the link types to be considered by this rule from the point of view of the issue that is changed, not from the point of view of the related issue. The following example clarifies this:

• You have a link type that relates requirements to test cases. The name of the link type indicates the direction, which depends on the point of view. From the point of view of the requirement, you say it “is tested by” a test case. From the point of view of the test case, you say it “tests” the requirement.

• When a requirement changes, the related test case is suspect and needs to be reviewed, and you want the rule to monitor this situation.

• The rule must be stated from the point of view of the requirement (not the test case), so you should select “is tested by” as the name of the link type.

Modify linked issue

Select new action on branch: Edit issue:

Here you specify the following two changes to the linked issue to mark it as suspect:

• In the option Choose fields to set, select the label to identify the issue as suspect.

• Under More options, specify the following string in Additional fields:

{
"fields": {
"R4J Suspect": "{{issue.R4J Suspect}}Linked issue {{changedIssue}} has changed, please check effect\n"
}
}

This results in a line being added to the custom field “R4J Suspect”.

Add notification (optional)

Select new action on branch: Send email in section Notifications.

Specify the the user roles, single users or groups to be notified, as well as the subject and content of the email. Here are suggested values:

• To: Reporter, Assignee

• Subject: Issue {{issue.key}} is going suspect!

• Content: Hello Jira user, please check issue {{issue.key}} for completeness as the linked issue {{changedIssue}} was modified. Best Regards, your Jira System

Enable the rule

Provide a name for the rule and then enable it by selecting Turn it on.

Create a new rule

Select the Create rule button.

Create a trigger for the rule

Select the trigger When: Value changes for in section Issue Triggers.

The rule is triggered when a fields of an issue changes.

Define fields for the trigger

Select the Labels fields for any changes by any operation:

Select the Labels field for any change type for edit issue, create issue, assign issue and workflow transition (if they apply to your uses case)

Check the change log

Select the {{smart values}} condition:

Check if the change log contains the value “Suspect”

{{#changelog.labels}}{{fromString}}{{/}}

Check the label field

Select the Issue fields condition:

Check if the “Suspect” value is removed from the labels field.

Clear the R4J Suspect field

Execute the Edit issue action:

Select the R4J Suspect field to be cleared.

Enable the rule

Provide a name for the rule and then enable it by selecting Turn it on.