Bulk handling of issues

Currently only available in Server

Due to performance considerations, bulk handling of issues is not available in Cloud. We hope to deliver this in the future.

Rather than running a rule against each issue in a list, it is possible to treat the list as a single unit to process. This feature is usually used to provide summary information for a list of issues. E.g. send out a weekly email with a list of issues returned by a JQL query.

Scheduled triggers with JQL

When using a scheduled trigger with JQL to provide a list of issues, there is an option to process issues in bulk:

scheduled trigger

Behaviour

Option checked JQL returns Behaviour
Yes 5 issues the rule will only run once passing the list of issues through
Yes 0 issues the rule will still run once but there won't be any issues in context
No 5 issues the rule will run 5 times - once against each issue
No 0 issues the rule will not run

Actions and conditions (components) that work on issues will still apply to each individual issue. I.e. the "Edit issue" action will edit each issue in the bulk processed list.

When branching, a branch will be created for each issue provided by the trigger, regardless of this option.

Conditions behave slightly differently when bulk processing tickets (via a trigger or a branch).
In this case, issues that do not match the condition will be filtered out. And, issues that do match will continue to flow through the rule.

When branching on a list of issues you can also decide to process this list as a single unit, just like the scheduled trigger.

branch bulk

The behaviour of the sub-branch follows the same logic as described above for the scheduled trigger.

Smart value changes

The behaviour of the {{issue}} smart value changes when the bulk handling option is turned on.

Smart value Bulk handling behaviour Normal behaviour
{{issue}} Returns the first issue in the list of issues Returns the issue in context
{{issues}} Returns the list of issues.
For more on lists, see working with lists
Does nothing

Example: Sending an email with a list of issues

In this example we have a scheduled trigger with the "Bulk processing" option checked. Every week it will find all issues that were resolved during the previous week and send a single email to
all the assignees and Jira administrators containing a list of issues and links to them.

resolved issues