Filters by field. Filtering functions.
To create a field-based filter, click on “+“ icon on the Filter panel.
|
---|
Field | Choose either Gantt or Jira field from the drop-down menu |
Operator | Select an operator (“=“, “!=“, “empty“, “not empty“, “in“, etc.) |
Value/Function | Type a value or choose a function is applicable |
Name | Provide a filter name |
For instance, you would like to see only the unassigned tasks in Gantt chart. In such case, you can create a filter based on Gantt field Resource. Note that you can use either operator “=“ or “empty“.
Resource = Unassigned or Resource is empty
Please see below.
|
---|
|
---|
Functions supported by Gantt Suite
Please note: If impersonation is enabled for a chart (configured under the Security tab), JQL filters that use functions will execute in the context of the impersonated user.
For example, the JQL filter assignee = currentUser() will return issues assigned to the impersonated user, which may differ from the currently logged-in user.
| Function | Supported fields | Supported operators | Unsupported operators | Examples | Notes |
---|---|---|---|---|---|---|
| closedSprints() | Sprint |
|
|
|
|
| currentUser() | Assignee, Reporter, Resource (Gantt) |
|
|
|
|
| endOfDay() | Created, Due, Resolved, Updated, custom fields of type Date/Time |
|
|
| endOfDay()
endOfDay("inc") where |
| endOfMonth() | Created, Due, Resolved, Updated, custom fields of type Date/Time |
|
|
| endOfMonth()
endOfMonth("inc") where |
| endOfWeek() | Created, Due, Resolved, Updated, custom fields of type Date/Time |
|
|
| endOfWeek()
endOfWeek("inc") where |
| endOfYear() | Created, Due, Resolved, Updated, custom fields of type Date/Time |
|
|
| endOfYear()
endOfYear("inc") where |
| futureSprints() | Sprint |
|
|
|
|
| linkedissue | Issue | =, != |
|
|
|
| linkedIssues() | Issue |
|
|
|
linkedIssues(issueKey)
linkedIssues(issueKey,CaseSensitiveLinkType)
linkedIssues(issueKey,CaseSensitiveLinkType, CaseSensitiveLinkType) |
| now() | Created. Due, Resolved, Updated, custom fields of type Date/Time |
|
|
|
|
| openSprints() | Sprint |
|
|
|
|
| startOfDay() | Created, Due, Resolved, Updated, custom fields of type Date/Time |
|
|
| startOfDay()
startOfDay("inc") where |
| startOfMonth() | Created, Due, Resolved, Updated, custom fields of type Date/Time |
|
|
| startOfMonth()
startOfMonth("inc") where |
| startOfWeek() | Created, Due, Resolved, Updated, custom fields of type Date/Time |
|
|
| startOfWeek()
startOfWeek("inc") where |
| startOfYear() | Created, Due, Resolved, Updated, custom fields of type Date/Time |
|
|
| startOfYear()
startOfYear("inc") where |
Once a filter is created, it is enabled.
The enabled filter is highlighted in blue as shown below.
|
---|
Note that the Filter button is highlighted in blue in case there is at least one enabled filter. This is helpful if the Filter panel is hidden and the fact that there are enabled filters is not obvious.
To enable or disable a filter, simply, click on it, or use the filter’s drop-down menu.
|
---|
Note that the filter’s drop-down menu offers the ability to edit or delete the filter.
Filter templates
The “+“ icon on the Filter panel offers quick access to filter templates such as Issue type (filter by issue type), Resource (filter by resource) and Status (filter by status).
|
---|
The filter templates have pre-selected fields and operators.
To continue with earlier example when the requirement is to see only unassigned tasks, you can use the template Resource as shown below.
|
---|
To differentiate between Gantt and Jira fields when creating a field-based filter please visit page Gantt fields
If needed a user can filter tasks by Flags, using the field-based filter.
For instance, you want to see only the tasks that have missed their deadlines.
|
---|
Advanced filter
Starting from version 7.0, the Advanced Filter feature is available, allowing you to combine multiple conditions using AND/OR operators.
To create an advanced filter:
Click Advanced in the Filter panel.
Create the first condition, then click Next.
Add more conditions by selecting either the AND or OR operator.
Once all conditions are added, enter a name for the filter and click Save.
For example, suppose you want to view unassigned tasks with high priority or tasks that are due by the end of the month.
You can create this filter by following these steps:
Click Advanced in the Filter panel.
Create the first condition: Resource is empty, then click Next.
Add the second condition using the AND operator:
Priority in Blocker, Highest, High (note: available options may vary depending on your Jira configuration), then click Next.
Add the third condition using the OR operator:
due <= endOfMonth(), then click Next.
Enter a name for the filter and click Save.