3.2.2. Filter Options

The tree of issues being displayed can be filtered in various ways. Selecting filter options causes the current issue tree to be reconstructed with the filter rules in place. Filter rules are additive — for example, if an issue list is currently filtered by a selected iteration "Iteration 10", and then a specific user is selected "Bob Jones", the issue list will refresh to show all issues in "Iteration 10" assigned to "Bob Jones". Using the filter options effectively allows desired issue lists to be configured with ease.

When no search query is selected to filter issues, issues which have been marked "Closed" and have not been modified for at least a week are automatically excluded from the list. The way to view those old issues is to go to the Search tab and create a query to find the past issues, return to the Issues tab, click on the "Refresh" to activate the new query, and then select the query from the "Query" combo box.

There are several issue filtering options which are fairly straight-forward, but described below.

• Query - Users can create personal queries and use them in the issue panel. When a query is saved, it becomes available in the query combo box. Selected the query from the list will execute the query in conjunction with the other filter options. Any other selected filter in the issue view will take precedence over the options selected in the search. For example, if the search specifies "Iteration 10", but the issue view has "Iteration 11" selected, the search query will execute, but will use "Iteration 11" in the search.
• User - The user filter option finds only issues that are assigned to the selected user. If the user tree is being viewed, only the selected user will be displayed in the tree.
• Iteration - The iteration filter combo box offers all unfinished iterations as options for filtering. Issues currently assigned to the selected iteration will be listed. If the iteration tree view is active, only the selected iteration will be visible.
• Project - The project filter list provides a list of components that are currently in an "Open" state. Selecting a project will filter list all issues belong to the selected project or any of its sub-projects. When in the project list or component tree views, the projects displayed are only those which are decendants of the selected project filter.
• Search Field - The text field at the end of the list of filter items can be used to find issues based on a quick search string. The search looks at issue titles and descriptions for the keywords provided. The search field can also be used to lookup a specific issue number. If a number is typed into the search box, that particular issue will be listed.

Issues can be filtered using any of the available combo box options. Issues can also be searched using the text field. If an issue number is typed into the search box, it will be found directly.

Next Section: 3.2.3. Edit Mode