Orange Tracker
Page tree

Table of Contents

Quick Searching

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'.  

quick search box

The quick search field can also be used to search for issues by a word found in the:

  • summary
  • description
  • comments

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).

 

Smart Querying

The quick search box recognizes some special search terms as well (searching by these terms is called smart querying):

Quick Search TermResults
myissues 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)
overduefind 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.

issues menu showing recently viewed issues and favorite filters

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:

recently viewed search displaying 50 issues

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:

Filter by project, issue type, status, assignee, reporter, and more criteria

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):

More filter criteria, including a list of recent criteria you've used and a list of all criteria

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).

find the reporter field by entering reporter in the search box located in the More drop-down screen

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.

check off the values you want to use for the reporter in the search

 

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:

Search bar showing available options

Project:  Jira

assignee:  unassigned

status:  open

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:

Removed unassigned criteria by unchecking the value selected

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.

 

Advanced Searching

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.

Advanced Searching button location

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:

  1. Select Issues
  2. Select "Search for Issues"
  3. Select "More"
  4. Enter "label" in the criteria search box that appears
  5. Check label
  6. Enter the label name into the "Find Labels" box that appears
  7. Check the box for the correct label

 

Saving Filters

You may want to re-use a search that you have set up in either basic search or advanced search mode. 

  1. create the query
  2. Select "Save As"  (next to "Search" title on the screen)
  3. Give the filter a name (use a name that will let you determine what issues will be retrieved by the filter) and select "submit"
  4. Once you have saved the filter, the filter name will appear as the title instead of the word "search"
  5. The filter will automatically be made a favorite filter.  Select the star button to change the filter's favorite status.
  6. Select the "Details" button to see the permissions for the filter and subscriptions for the filter.

Using Quick and Favorite Filters

Quick 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.

Quick FilterDescription
My Open IssuesIssues assigned to the currently logged on user that have not been closed/resolved
Reported by MeIssues that have the currently logged on user as the reporter (for any issue status)
Recently ViewedThe 50 most recently viewed issues by the currently logged on user
All IssuesAll issues the currently logged on user has rights to view (this search can take a while)

Favorite Filters

The Filters column also has a list of filters that you have marked as favorite filters (select the Star (blue 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.

Filters Title with icon to hide filters

To unhide the Filters column, select the two right brackets that display at the top of the column.

Unhide Filters using two right brackets iccon