JQL Search Checklists
Smart Checklist supports JQL as an approach for searching checklist values and checklist progress. Switch to Advanced Search and use the approaches described below.
For Version 5.0.0 and higher
Since version 5.0.0 Smart Checklist for Jira Server and Data Center provides the possibility to examine a more precise JQL search, like search by status or by checklist item, using custom JQL functions.
JQL function | Usage Example |
---|---|
| Search for issues where ALL checklist items are Closed
|
| Search for issues where ALL checklist items are Open
|
| Search for checklists by Progress
Available operators: >, <, >=, <=, = Use percent value from 0 to 100 āš¼NOTE: Smart Checklist all available operators: >, <, >=, <=, = will be put out of the brackets soon. We will notify you via email about JQL changes but recommend to already use the following syntax: |
Ā | |
| Search for particular checklist items in a particular status
Search for particular checklist items in a particular statuses
Search for checklists that contain particular checklist item
|
| Since version 6.1.0 Smart Checklist ā~ā (LIKE operator) could be used for search with this function.
|
| Search for Assignee(s) mentioned in checklist item
Allowed parameters
Ā |
| Search for fixed Date, indicated in checklist item
Allowed formats
The āitemDateā function accepts dates entered in ISO format only |
| Search by Relative Date
Allowed parameters: [n]d, [n]w, -[n]d, [-n]w
Search for date in between of time range:
read: search for the checklist item that has date set between today and 2 week ahead |
| Search for checklist items with assignee, date and in a particular status
Allowed parameters
|
For versions 4.16.0 and below
To use this functionality you need to set-up "Checklists" custom field, or "Smart Checklist Progress". It depends on what main criteria you'd like to search for.
Smart Checklist supports JQL as an approach for searching checklist items values and checklist progress.
If you set up "Checklists" (multi-line text field) and "Smart Checklist Progress" (single-line text field) which are both custom fields - you can easily apply all JQL search patterns.
Search examples
JQL Search | Usage Examples |
---|---|
| To search for issues with opened checklists (not all checklist items completed). Ā |
| To search for issues with ALL completed checklists |
| ToĀ search forĀ all issues that contain checklists on your instance: Ā |
| ToĀ search for checklists containing specific items |
Searching for Jira issues where a specific checklist item has completed/ incompleted status is unavailable in versions below the 5.0.0. This happens due to the following limitation:Ā Jira does not index the special character of - and +Ā
Special characters + - & | ! ( ) { } [ ] ^ ~ * ? \ : Special characters aren't stored in the index, which means you can't search for them. The index only keeps text and numbers, so searching for "\\[Jira Software\\]"Ā andĀ "Jira Software"Ā will have the same effect - escaped special characters ([]) will be ignored in the search.
Source:Ā https://confluence.atlassian.com/jirasoftwareserver0712/search-syntax-for-text-fields-959315338.html