...
Contents 👇🏻
Guide to set up custom fields:
🏢 Company-managed projects:
...
👥 Next-gen projects:
| Panel |
|---|
|
☝🏼 NOTE: If you are using the next-gen project, make sure that the added custom fields has a global context. To add global context to your custom fields, follow the official Atlassian guide. |
Search examples:
📊 Search by checklist progress:
JQL Search option | JQL query |
|---|
Issues with opened checklists (not all checklist items completed)
| Status |
|---|
| colour | Blue |
|---|
| title | Smart cHECKLISt progress |
|---|
|
| Status |
|---|
| colour | Blue |
|---|
| title | FIELD required |
|---|
|
| "Smart Checklist Progress" ~ "-Done"
|
Issues with ALL completed checklists
| Status |
|---|
| colour | Blue |
|---|
| title | Smart cHECKLISt progress |
|---|
|
| Status |
|---|
| colour | Blue |
|---|
| title | FIELD required |
|---|
|
| "Smart Checklist Progress" ~ "Done"
|
Issues where there is at least one completed (checked) checklist item
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].hasClosedChecklistItems = 'true'
|
Issues where all checklist items are open (unchecked)
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].hasClosedChecklistItems = 'false'
|
Issues where there is at least one open checklist item
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].hasOpenChecklistItems = 'true'
|
Issues where all checklist items are completed
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].hasOpenChecklistItems = 'false'
|
🗒 Search by checklist items:
JQL Search option | You type |
|---|
Search for checklists containing specific items
| Status |
|---|
| colour | Blue |
|---|
| title | cHECKLISts FIElD required |
|---|
|
| "Checklists" ~ "your item value"
or
"cf[Checklists CustomFieldID] ~ "your item value"
|
Search for an exact phrase in the checklist items or exact checklist items
| Status |
|---|
| colour | Blue |
|---|
| title | cHECKLISts FIElD required |
|---|
|
| "Checklists" ~ "\"your item value\""
or
cf[Checklists CustomFieldID] ~ "\"your item value\"
|
Search by number of items
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].totalChecklistItems > 5
|
☝🏼 Note: Available operators could be used: >, >=, <, <=, =, !=. |
Search by not empty or empty checklists | Status |
|---|
| colour | Blue |
|---|
| title | cHECKLISts FIElD required |
|---|
|
| "Checklists" is not EMPTY
or "Checklists" is EMPTY
|
Search by a specified due date
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].itemsDates ~ '2022-11-11'
|
☝🏼 Note:
Allowed formats: YYYY-MM-DD, YYYY/MM/DD, DD/MM/YYYY, DD-MM-YYYY. | Panel |
|---|
| Date format used in JQL search should match the date format in the checklist item. |
If you are searching for a date: '2022-11-11', it will only match for '2022-11-11', not for '2022/11/11', '11/11/2022' or any other. |
Search by checklist items in the particular status
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].itemsStatus ~ 'Todo'
|
☝🏼 Note:
The query returns all the issues where there is at least one checklist item in Todo status. Use default status (Todo, Done, Skipped, and In Progress) or custom statuses. | Panel |
|---|
| Text is case insensitive, so DONE, Done, or done will return the same results. |
|
🙋🏽♂️ Search by checklist assignees:
JQL Search option | You type |
|---|
Search by currently logged user
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].assignees ~ currentUser()
|
Search by any user
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].assignees ~ UserId
|
☝🏼 Note: don’t use “@” symbol |
Search by custom mention
| Status |
|---|
| colour | Purple |
|---|
| title | no fields required |
|---|
|
| issue.property[SmartChecklist].assignees ~ HRTeam (or your custom mention)
|
Operator | JQL Search option | You type |
|---|
AND | Search for not competed checklists with specific number of items | "Smart Checklist Progress" ~ "-Done" AND issue.property[SmartChecklist].totalChecklistItems > 5
|
Search for not competed checklists with a specific due date | "Smart Checklist Progress" ~ "-Done" AND issue.property[SmartChecklist].itemsDates ~ '2022-11-11'
|
Search for not completed checklists which contains specific items | "Smart Checklist Progress" ~ "-Done" AND "Checklists" ~ "your item value"
|
Search for checklists with mentioned current logged user and due date | issue.property[SmartChecklist].assignees ~ currentUser()
AND issue.property[SmartChecklist].itemsDates ~ '2023-08-01'
|
Search for checklists with items in the particular status and due date | issue.property[SmartChecklist].itemsStatus ~ 'Todo' AND issue.property[SmartChecklist].itemsDates ~ '2023-08-01'
|
OR | Search for checklists with items in particular statuses | issue.property[SmartChecklist].itemsStatus ~ 'Todo' OR issue.property[SmartChecklist].itemsStatus ~ 'In progress'
|
will return checklists that includes items with | Status |
|---|
| colour | Blue |
|---|
| title | in progress |
|---|
|
or statuses |
Search for checklists with mentions of current logged user and somebody else | issue.property[SmartChecklist].assignees ~ currentUser()
AND issue.property[SmartChecklist].assignees ~ UserId
|
will return checklists that includes mentions of the current logged user or somebody else |
...