Table of Contents
outline true

How To Use

General usage

1. Go to JQL Pro page
2. Build your search criteria either using Dynamic Condition Builder or by manually entering it into the text area
3. Click Find
4. Enjoy the result

Dynamic Criteria Builder

For your convenience JQL Pro Add-On has the Dynamic Criteria Builder.

...

In the end you will have something like on the screenshot below:

Checking

...

Sample JSON

As mentioned above, to perform effective search for JIRA issues by comments, attachments, links etc. – you have to know for which field to search. You can do it in two ways – either by checking JSON representation of an issue (this is exactly how JQL Pro Add-On “sees” the issues) or by checking a sample JSON issue by clicking the Show Sample button. This is how it looks:

...

For better results I suggest you to use some JSON view plugin for your browser. For example, if you want to search for the issues with type “Story”, on the screenshot below you can see how to build the path to the needed property – it will be “fields.issuetype.name”

Saving Results Into Filter

Once you are satisfied with your criteria, you can create a dynamic filter. This filter will be periodically updated by the Add-On in order to make sure you always have fresh results there. This feature is especially useful if you would like to use your search results in the dashboard, which is usually based on some filter.

To save result into a filter – click on the button of the same name in the box, which appears after you submit your query.

Image Added

To find this filter you should navigate to the Issues -> Manage Filters section, and then look for filters owned by the Add-On user (JQL Pro):

Image Added

Explaining Video