Table of Contents
The Quick Search box is located at the top right of your screen. If you type in the key of an issue, you will jump straight to that issue. For example, if you type in 'ABC-107' (or 'abc-107'), and press the Enter you will be redirected to the Orange Tracker issue 'ABC-107'. In many cases, you do not even need to type in the full key, but just the numerical part. If you are currently working on the 'ABC' project, and you type in '123', you will be redirected to 'ABC-123'.
The quick search field can also be used to search for issues by a word found in the:
You cannot search for issues with a specific reporter or assignee by just entering the netID in the quick search box. You can search for issues by reporter using r:netID (see Smart Querying below). To search by assignee, use the "Search for Issues" screen (see below).
The quick search box recognizes some special search terms as well (searching by these terms is called smart querying):
|Quick Search Term||Results|
|my||issues assigned to you.|
|r:||use r: with the username (ex: r:dmhavill) to find issues with that user as the reporter|
|<project key>||find issues in the project with the specified project key (ex: HELP)|
|created:||issues with the specified created date. Ex: created:today, created:yesterday, created:-2d (in past 2 days), created:-1w (created within past week)|
|updated:||issues with the specified updated date. Ex: updated:today, updated:yesterday, updated:-2d (updated in past 2 days), updated:-1w (updated in past week)|
|overdue||find issues that were due at a past date or today.|
|c:||issues with a specified component (ex: c:jira). Components may differ by project, so you'll need to use the appropriate component for the project(s) in which you wish to search|
|<priority>||find issues with that priority (ex: critical)|
Note that smart querying with "due:" does not work correctly as a result of a bug. To search by due date, use the "issue navigator" found under "search for issues." The "overdue" smart term does work with smart querying.
Recently Viewed Issues and Saved Filters
When you select "Issues" from the top menu. a list of the five most recently viewed issues appears at the top of the drop-down menu.
If you want to see even more recently viewed issues, select the "More" button. The results of a search for the 50 most recently viewed issues will be displayed:
Below the "Recent Issues" section in this drop-down menu is a list of your favorite filters. You can select one of these filters to retrieve issues.
Issue Navigator (Search for Issues)
The results of a quick search (if more than one issue is returned) will be displayed in the issue navigator. You can also access the issue navigator by selecting "Issues" and then "search for issues" from the top menu.
Changing the default view of Issue Navigator
You select one of two views as the default view for issue navigator:
- Detail View: displays a list of issues retrieved (issue key and summary only), and a full view of the currently highlighted issue in the list. Change the selected issue in the list to see the full details of a different issue.
- List View: displays only a list of the issues retrieved, including multiple columns of information on each item in the list. For example, the key, summary, assignee, reporter, priority, status, resolution, created date, and updated date may be displayed. You can change what columns of information are displayed in the list view by selecting the "columns" button and putting a check mark in the specific columns you want to view.
To change the default view for issue navigator, select the "change view" button (which displays as three stacked lines at the far right of the search criteria menu). You can then change the default view from this menu.
Narrowing a Search
You can narrow search results in the issue navigator by selecting fields to filter the results:
If you select "More," other fields by which to filter the results will appear (scroll through the list to see all the additional fields you can filter the results by):
For example, you could select one or more projects, issue type, current status of the issue, assignee, created date, reporter (not shown in screen shots), component, and more. Use the "search" box that appears under more to find a specific field (ex: reporter).
If you select one of the fields under "More," it will default to a value of "All" and appear on a second line in the menu bar. Use the drop-down screen for that field to define one or more specific search values for that field.
You can also enter text in the box marked "contains text" to search the summary, description, and comments for that word.
If you select multiple fields in the filter list, all of those criteria will apply. For example, I could select:
This search will find only unassigned issues that are open in the JIRA project.
Removing a search criteria:
To remove a criteria from the search, select the drop-down arrow for that criteria and uncheck the selected value/field:
If the filter field was listed under the "More" area of the filter bar, removing the criteria works a little different. To remove the field, select the "X" next to the search field.
If you need to do more complex searches, you can perform an advanced search. Open up the issue navigator by selecting "Issues" from the top menu and then "Search for Issues." Now select the "Advanced" button in the filter criteria menu.
A box will appear where you can enter a query in JQL format. For help on this format, select the question mark ("?") at the right end of the box. JQL querying accepts boolean operators such as "and," "or," and "not." Some examples of JQL queries:
- project = "Jira" and (assignee is empty) and reporter in (tester1, tester2, tester3) - finds all issues in the JIRA project that are not assigned and have a reporter of tester1, tester2, or tester 3.
- summary ~ "orange tracker" - find all issues where the summary contains the word "Orange" and the word "tracker"
- assignee = "tester1" and created >= "2015/11/01" and created <= "2015/11/05" - find issues created from Nov. 1, 2015 to Nov. 5, 2015 with an assignee of tester1
JQL has more operators and fields that you can combine to filter issues as you need. See Advanced Searching Documentation for more information. Help will also appear below the JQL search box as you type your query. You can select one of the suggestions for fields, operators, and/or values that appears in this help menu as you type.
While in advanced searching mode, you can switch back to "basic" searching, where you can select filter criteria from a menu, by selecting the "Basic" button. If you currently have a query in the JQL search box, you may need to clear it by selecting "new filter" before you can select the "basic" button.
Searching by Label
While viewing an issue, you can click a label assigned to the issue to bring up other issues with that same label.
You can also search by label from the issue navigator screen:
- Select Issues
- Select "Search for Issues"
- Select "More"
- Enter "label" in the criteria search box that appears
- Check label
- Enter the label name into the "Find Labels" box that appears
- Check the box for the correct label
You may want to re-use a search that you have set up in either basic search or advanced search mode.
- create the query
- Select "Save As" (next to "Search" title on the screen)
- Give the filter a name (use a name that will let you determine what issues will be retrieved by the filter) and select "submit"
- Once you have saved the filter, the filter name will appear as the title instead of the word "search"
- The filter will automatically be made a favorite filter. Select the star button to change the filter's favorite status.
- Select the "Details" button to see the permissions for the filter and subscriptions for the filter.
Using Quick and Favorite Filters
The Filters column on the left-hand side of the issue navigator screen contains some pre-defined quick filters that you can use to search for issues.
|My Open Issues||Issues assigned to the currently logged on user that have not been closed/resolved|
|Reported by Me||Issues that have the currently logged on user as the reporter (for any issue status)|
|Recently Viewed||The 50 most recently viewed issues by the currently logged on user|
|All Issues||All issues the currently logged on user has rights to view (this search can take a while)|
The Filters column also has a list of filters that you have marked as favorite filters (select the Star icon next to a saved filter to make it a favorite). You can use these filter to quickly search for issues.
Hiding and Unhiding the FIlters Column
By default, the Filters column containing quick and favorite filters displays when you open the issue navigator. If you want to hide this column to have more room for display of issues returned by a search, select the two left brackets to the right of the "Filters" title at the top of the column.
To unhide the Filters column, select the two right brackets that display at the top of the column.