• Products
  • Get started
  • Documentation
  • Resources

Automation conditions

You can specify conditions that must be met for your rule to continue running. For example, your rule will only escalate an issue if it is high priority.

Conditions can be placed anywhere in the rule chain. If a condition fails, no actions following it will be performed. The exception is with the If/else block condition. Not all rules need to have conditions.

Issue fields condition

  • Use smart values here: No

Checks whether an issue field meets a certain criteria.

This condition doesn’t require you to write smart values or JQL, and supports most common Jira fields. Use this condition ahead of the JQL and Advanced compare conditions, where possible.

The fields available on the Issue fields condition

Advanced compare condition

  • Use smart values here: Yes

Compares two values, using smart values and regular expressions.

While the Issue fields condition will meet most needs, this condition provides extra options, such as the use of regular expressions and functions.

For example, if you wanted to re-open an issue when a customer comments, you would start with the Issue commented trigger. You could then add this condition to compare the comment’s author with the issue reporter, and add another condition to check if the issue status is Done. Once these conditions are satisfied, the issue will transition to In progress.

The fields available on the Advanced compare condition

The comparison methods available are:

  • Equals (e.g. the assignee equals John)

  • Does not equal (e.g. the assignee does not equal John)

  • Starts with (e.g. the reporter's name starts with J)

  • Contains (e.g. the summary contains December)

  • Does not contain (e.g. the summary does not contain December).

You can use regular expressions on this condition to test for patterns. For example, check whether a field value contains, exactly matches, or doesn’t contain what is in the regular expression field.

An example of the Advanced compare condition

Affected services

Checks if an issue’s affected services field matches the set criteria.

You can configure this condition to check against the service tier, services name or dependent services of the affected services.

This condition is only available on IT Service Management projects, for issues types that contain an affected services field type.

The fields available on the Affected services condition

If/else block

Performs alternate actions based on whether certain conditions match or don’t match.

This powerful condition allows you to add as many if/else conditions as you want. The if block executes the specified actions within that block when all the set conditions are met. If the conditions are not met, the else blocks will be evaluated.

An example of the If/else block condition

Issue attachments

  • Use smart values here: No

Checks if the comment or description fields of an issue contains attachments.

For example, you may want to check whether a customer has included a screenshot, or if a vendor has included an invoice – if there are no attachments, you could leave an automated comment requesting more information.

The fields available on the Issue attachments condition

You can combine this condition with the JQL condition to check if the filename of a specified format. You can also include a conditional compare on some properties of your attachments, including:

JQL

  • Use smart values here: Yes

Before getting started with a JQL condition, check if you can use the Issue fields condition for your rule instead. It is easier and quicker to set up.

Checks to see if an issue matches a specified JQL query.

For example, checking that the status category of a status for a given issue is Done.

1 statusCategory = Done
The fields available on the JQL condition

Click Validate query on this condition to check that your JQL query is working correctly. If you’re using smart values, you won’t be able to check if your JQL is valid.

  • Use smart values here: No

Checks if related issues exist on the trigger issue (e.g. parent, sub-tasks, epics, stories, etc.) or matches a specified JQL query.

The fields available on the Related issues condition

User

  • Use smart values here: Yes (Criteria)

Checks whether a user exists or is in a specified group.

You can add additional criteria to this condition, and select the logic of whether all or any of the criteria must be matched.

For example, before reopening an issue, you could check if the user who added a comment to the issue is the reporter of the issue OR is a member of the participants custom field.

The fields available on the User condition

 

Last modified on Mar 31, 2020
Cached at 5:36 AM on Oct 27, 2020 |

Additional Help

Ask the Community