JIRA Client provides multiple ways to find issues you are interested in. The most simple way is using default queries located in the Navigation Area, and you can create your own queries using:
When running a query, JIRA Client does the following:
Sub-queries act much the same as usual queries, but they reside under another query in the Navigation Area. When you run a sub-query, you search for certain issues within search result of the parent query. By dragging-and-dropping queries you can apply similar search filters and distributions to different projects or even different connections.
In this section:
To find an issue:
When running search, you can specify a search scope or, in other words, the extent of the search area. To do so:
You can specify a different search scope to make your search more specific and restrict the query to this particular range. See an example on picture below. |
Context-based text search returns results only from certain range or scope of issues thus limiting a range of your search effect.
To run context-based search:
Select the following options if necessary:
|
If your search returned several results, press Next and Previous buttons to navigate between them.
JIRA Client lets you create queries using a desired variation of Boolean logic operators to establish relationship between search constraints. Table below provides a brief description of these operators.
Operator |
Description |
---|---|
AND |
Use the AND operator to retrieve a set in which each citation contains_ all the search terms_. This operator places no condition on where the terms are found in relation to one another; the terms simply have to appear somewhere in the same citation. |
OR |
Use the OR operator to retrieve documents that contain at least one of the specified search terms. Use OR when you want to pull together articles on similar subjects. |
NOT |
Use the NOT operator to exclude the retrieval of terms from your search. |
Table below lists different types of icons you may come across when setting up search constraints.
Icon |
Description |
---|---|
Search for specific words in a text attribute. |
|
Search for a numeric attribute having values within specified range. |
|
Search for issues that have specified values in a date attribute. |
|
Search for specific values in a single-value selection field. |
|
Search for specific values in a multivalue selection field. |
TBD: describe how issues are matched against single-value and multi-value selection field filters, in case filter contains 2 and more values. |
To search for mutli-valued field value, combine search filters with ANDs (for example, fix version = 2.0 AND fix version = 3.0). |
To create a query:
When selecting query constraints, you can drag-and-drop to arrange them in the constraints tree as shown below. |
Here are some more examples of queries which you may find useful:
You can exchange queries with other JIRA Client users using an e-mail application or an instant messenger.
To share a query:
To use a shared query:
If you want to change the parameters of a query which cannot be modified (this can be, for example, one of the sample queries), you can move it to Temporary Queries folder and modify it there. To do so:
The query name changes listing its conditions separated with "*" sign. |
Distribution is a folder in the Navigation Area that maintains a list of sub-queries corresponding to all possible values in a given search field. Using distributions you can break down issues by status, assignee or any other desired attributes. JIRA Client creates and updates a list of sub-queries for each value of the attribute, for example:
To create a distribution:
You cannot edit or move distribution sub-queries, but in all other aspects they act like ordinary sub-queries. |
Two-dimensional distributions let you break down query results in two different dimensions by selecting a parent query and two attributes for its axes.
To create two-dimenstional distribution:
Click Open a window with a summary table button to view the distribution of issues in a separate table. See picture below. |
To create a three-dimensional distribution:
You can export the distribution results to CSV to print, view or analyze them in Microsoft Excel or Open Office. |
See Also