Zones JQL Functions

Zones JQL Functions

The celix Zones Plugin provides two JQL functions myZones and myZonesUsers. Filters created with these JQL functions are reusable and can be shared. They will always refer to the user viewing the filter. We also suggest to build Dashboards which use the filters. Everybody will only see the Issues that are relevant.

myZones([Zone Role])

The JQL Function myZones returns a list of all all zones, the executing user is member of. The optional parameter is a Zone Role. If you call myZones with a Zone Role only the zones are returned where the executing user is a member of the Zone Role.

Actually myZones does not return a list of zones but a list of Groups. For additional information why this still works take a look at Zone and Zone Field.

Example Queries

In the example queries we assume that there is a Zone Field called Team. Additionally we assume that there is a Zone Role called Teamlead.

Find all issues where I am a member of the selected team (Zone Field)
Team in myZones()
Find all issues where I am teamlead (ZoneRole) of the selected team (Zone field)
Team in myZones(Teamlead)

myZonesUsers([Zone Role])

You cannot use the JQL function myZones with JIRA user fields like assignee or reporter. Therefore myZonesUsers returns all members of the zones returned by myZones, instead of the zones itself. You therefore can use myZonesUsers with JIRA user fields. The optional parameter works the same as in myZones.

Example Queries

In the example queries we assume that there is a Zone Field called Team. Additionally we assume that there is a Zone Role called Teamlead.

Find all issues where someone of my team colleagues is assigned
Assignee in myZonesUsers()
Find all issues that are assigned to someone, who is a member of team where I am teamlead.
Assignee in myZonesUsers(Teamlead)