Page History
...
| Tip |
|---|
You can turn searching on by pressing Alt+/. You can cancel search and close the search panel by pressing Escape. |
Simple Search
Simple search mode is turned on when JQL button is off. Simple search mode lets you specify the following search conditions:
Condition Type | Example | How it works |
|---|---|---|
Simple text | structural hierarchy | Look for issues that have all mentioned words in the Summary field. Each word in the search sentence must be present in the summary, or the summary must have a word that begins with the specified word. The words may come in any order. |
Quoted excerpt | "the quick brown fox" | Look for the whole phrase in the summary (but see below about Lucene indexes). |
Issue keys | MARS-1, MARS-331 | If the text looks like one or more issue keys (delimited by comma or whitespace), search for exactly these issues. |
All issues | * | Use single asterisk to search for "all issues". Only issues from the projects enabled for Structure are found. |
| Info |
|---|
Structure relies on the JIRA search engine to run text searches. The engine is based on Lucene index which has a few peculiarities that may cause unexpected results. For example, short words may not be found. The result also depends on the Indexing Language specified in the JIRA General Configuration. |
JQL Search
When JQL button is on, the search condition is treated as JQL (JIRA Query Language) query. JQL lets you specify arbitrarily complex conditions to find very specific issues.
| Tip |
|---|
You can switch between Simple Search mode and JQL Search mode by clicking JQL button or pressing Alt+j. |
When the JQL mode is on, the usual JQL auto-complete suggests fields, operators and values as you type. Whenever you have a correct JQL in the search field, the JQL button will have blue border. When the JQL is incorrect or not complete, the JQL button will show red border.
More information on JQL is available in the JIRA documentation.
Searching within the Structure
...
Structure widget grays out non-matching issues in the structure in order to highlight the matching issues.
The selection is also moved to the first matching item, and if you press Down/Up Arrow Keys while the input focus is still in the search field, the selection will go to the next/previous matching issue in the structure.
| Tip | ||
|---|---|---|
|
Filtering Structure
If you wish to see only the issues that match the criteria specified in the search field, click the Filter button next to the issue count.
| Tip |
|---|
You can use keyboard shortcut Alt+f to turn filtering on and off. |
Once Filtering is turned on, you will only see the matching issues and their parent issues. (Parent issues of a matching issue are always shown to preserve the hierarchy view, even if they don't match the search criteria. Non-matching issues are grayed out.)
| Note |
|---|
Filtering mode remains even if you navigate to another page. |
Showing Unresolved Issues Only
Structure toolbar has Unresolved button, which works as a shorthand for filtering using JQL: Resolution is EMPTY. Clicking Unresolved button would filter the structure in the same way Filtering would do.
You can turn on Unresolved button and use search or filtering at the same time.
| Tip |
|---|
Press RR ("r", then quickly "r" once again) to turn Unresolved filter on and off. |
Searching for Issues Outside Current Structure
If there are matching issues that do not belong to the structure, an additional More Issues button is displayed on the search panel, telling exactly how many matching issues are there in JIRA that are not in the structure.
You can turn More Issues mode on or off by clicking this button. When it is turned on, the extra issues are displayed in the JIRA Search Results secondary panel.
| Info |
|---|
The search is run through all projects for which the Structure plugin is enabled (see Selecting Structure-Enabled Projects). |
| Tip |
|---|
You can turn More Issues mode on and off with keyboard shortcut Alt+m. |
| Tip |
|---|
If the search results is large, only the first 1,000 issues are displayed in the Search Results Panel. If you add those issues to the structure, the next 1,000 issues are pulled. Use |
Adding Issues to Structure
When you have issues found outside Structure with the More Issues mode on, you can add them from the Search Results secondary panel to the structure.
There are several options:
- Using Drag-And-Drop, move issues from the Search Results Panel to a specific location in the structure.
- Select several issues or all of them using check boxes and use drag-and-drop to move all the selected issues to the structure.
- Select an issue in the structure and click Add All button to place all issues from the Search Results Panel after the selected issue.
- Select an issue in the structure, then select several issues in the Search Results Panel and click Add N Selected button to place the selected issues from the Search Results Panel after the selected issue.
- While still having input focus (input caret) in the search criteria field, hit Ctrl+Enter to add all (or only selected) issues from the Search Results Panel after the currently selected issue in the structure. (Similar to Add All button.)
- Or hit Ctrl+Shift+Enter to add all (or only selected) issues from the Search Results Panel under the currently selected issue in the structure - the selected issue becomes the parent of the newly added issues.
- Use Cut/Paste actions and Issue Clipboard.
The Search function allows you to search through issues in Simple and JQL modes, within and outside the Structure. For more details on this functionality please refer to the corresponding sections.