Bulk handling of issues

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. For example, 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:

Behavior

Option checkedJQL returnsBehavior
Yes5 issuesthe rule will only run once passing the list of issues through
Yes0 issuesthe rule will still run once but there won't be any issues in context
No5 issuesthe rule will run 5 times - once against each issue
No0 issuesthe 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.

Bulk handling of related issues

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

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 valueBulk handling behaviorNormal behavior
{{issue}}Returns the first issue in the list of issuesReturns 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.

Last modified on Jun 24, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.