|
|
Basic Issue Search
In most cases you can find the issues that you want to work with very easily by using the issue list headers or by entering a few simple keywords into the main search field.
Whenever you visit the "Issues" tab in your project, you are presented with a table of all open issues. If you see too many results, you can quickly filter your results by clicking on the table headers and choosing a specific value from the "Show only:" submenu.
The main search field consists of two parts:
- A drop-down selection of search scopes, e.g, "All issues" or just "Open issues".
- A search text field where you can enter search terms.
In the text field, you may enter simple search terms, or add any of the search operators described below.
You can also use the search text field to jump directly to any issue by entering its issue number.
Behind the scenes, the search scope is simply an additional set of search terms that is automatically combined with the user's search terms to make a complete query.
Advanced Issue Search
The Advanced Search page helps you compose a complex query. The advanced search form breaks the search down into several popular criteria and allows you to specify each one easily. The search crieria boil down to the same thing as the search operators described below, but you don't need to remember the operator names.
Search Operators
Just like the Google web search that everyone knows and loves, you can search for issues by simply entering a few words. However, you may get a few more results than you expected. When you need to search more precisely, you can use search operators for more power.
Searching in specific fields
Normal search terms will match words found in any field of an issue. You can narrow the search to a specific field by using the name of the field. The built-in field operators are summary:, description:, comment:, status:, reporter:, owner:, cc:, commentby:, and label:. You can limit your search to just open issues by using is:open, or to just closed issues by using isnot:open.
For example, here's how to search for issues with the word calculation in the summary field.
When searching for issues owned by a specific user, you can use his or her username. When refering to yourself, you can also use the special term me. For example, this restricts the search to issues that are assigned to you.
Rather than have a large number of predefined fields, our issue tracker stores many issue details as labels.
For example, if you labeled security-related issues with the label Security, here's how to search for them.
In addition to simple one-word labels, you can use two part labels that specify an attribute and a value, like Priority-High, Priority-Medium, and Priority-Low. You can search for these with the label: operator, or you can use the first part of the label name like an operator.
For example, if you labeled high priority issues with Priority-High, here's one way to search for them.
And, here is a more compact way to do the same search.
"OR" search
Normally, each added search term narrows your search. If you would like to find issues that include either of two terms, add an uppercase "OR" between them.
For example, here's how to search for issues that are labeled with either Priority-High or Priority-Medium.
A shorter way to search for two values for one field, or two labels with the same prefix, is to use commas.
Star search
Any logged in user can mark any issue with a star. The star indicates interest in the issue.
For example, quickly see all the issues in this project that you have starred, you could use the following.
And, to see the issues that exactly three users have starred, use the following.