Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Image RemovedImage Added

First, you need to enter a field by which you’d like to perform a search. Start typing the field name into the upper input (number 1 on the screenshot). When you start typing a key, a helper-list with autocompletion will appear. The field is based on the JSON path to the needed property. For example, if you need to search by the project key field – enter “fields.project.key” (you can build the actual path either by checking JSON view of your issue from the REST API response, or by checking a sample issue – Show Sample button).

Image RemovedImage Added

After then, enter the needed value in the criteria field (number 2 on the screenshot). If you need to search for multiple project keys – you have to switch the = to the in. Then click on the appeared + button to add more keys.

Image RemovedImage Added

This query will return all issues from the two projects, which is not what you usually want. Let’s say, we need to find all open issues by the comment author in those two projects. Let’s add criteria to search issues by status and to filter them by comment author. Click on Add Condition button for every new criteria.

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

Image RemovedImage Added

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:

Image RemovedImage Added

To check it more precisely, use the REST API link, which is:

...

This is how the response would look like:

Image RemovedImage Added

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”

Image RemovedImage Added

Saving Results Into 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 RemovedImage 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 RemovedImage Added

Explaining Video

...