Now that you have learned how to create issues and check their details, let's move on to the Issues tab of the Projects menu, where they are listed:

On the sidebar of this page, you can see the same Issues section that you could see on the single issue page. The View all issues link of this section can be used to open the issue list with all view parameters reset to their default values. The form under the Issues title in the main content area and above the list is actually the one that you can use to modify the parameters of the list. Let's discuss this form in detail.

By default, issues are filtered by their status, so only open issues are listed. But you can add more filters using this form. Thus, you can also filter issues by Tracker, Priority, Author, Assignee, Category, Target version, Subject, Start date, Due date, the done ratio, the issue relation, and much more. The following screenshot shows some of the filters that are available:

Each of these filters has a set of its own conditions. For example, the Subject filter can check a part of the subject, the Tracker filter can look for several trackers (the little plus icon enables the multi-select mode), and date filters support relative conditions (such as, for examples, less than days ago, this week, in more than (days), and so on). The best way to learn these filters is perhaps by playing with them—if you don't have enough issues on your Redmine installation, you can do this at http://www.redmine.org/.

Below Filters, you can see the Options label. If you click on it, the following form elements will be shown:

Here, you can choose which columns to include in the issue list. Thus, to add a column, you should select it in the Available Columns box and click on the right arrow button . The left arrow button is to be used to remove a column from the Selected Columns box. The up arrow and down arrow buttons can be used to get the desired order of columns.

To show you what the Group results by option does, let me select the Status value for it. Here is what the issue list looks like after applying this option:

As you can see, the list gets divided into groups. Each group has a label with the number of issues in it. Also, these groups can be collapsed or expanded (using the gray plus or minus icon correspondingly).

The Show option, if the Description checkbox is checked, adds the issue description to the list as a separate table row below the main issue row.

Finally, the Totals option can be used to calculate the grand totals of the estimated and spent time for all the issues that are included into the issue list. The calculated totals will be shown before the list, to the right of form buttons (that is, Apply, Clear, and Save).

Every time you click on the Apply button to apply new parameters, they are also saved in your browser. In this way, whenever you load the issue list again, you get the same customized view. To reset to the default view, you can use the Clear link of the parameters form or the View all issues link which is available on the sidebar.

Custom queries

All new users, when they come to your Redmine website—despite their roles—will see the same issue list with the same columns, the same filters applied to the list, and so on. Actually, this is fine, unless you want them to be able to get the list of issues that they are interested in with just one click (and without the need to customize the view). So, how can you do this?

By customizing the issue list you can show: issues that are to be tested to your testers, features in future versions to public users, feature requests to your developers, and so on. All you need to do is to share such a customized view with the appropriate users. You can do this by clicking on the Save link of the parameters form, which was discussed previously. This will open the query form, which is shown in the following screenshot:

Most elements of this form are already known to you, so let's discuss only those that may need an additional explanation:

• As you can see, such custom queries can be private (to me only), public (to any users), or visible only to selected user roles (to these roles only).
• By default, a custom query is created for the current project only. So in order to make it available for all projects, you need to check the For all projects checkbox.

  Tip

  When you create a public custom query, be sure that it won't appear to be unsolicited for most of your users (especially if you are creating such query for all projects).

• If using the Columns element of the Options block you have selected columns which fit your needs but are not likely to be useful for others, you can enable the Default columns option to use the default columns in the saved custom query.
• The Sort option can be used to select the default sorting mode for the saved query. This can always be changed by just clicking on a heading of the issue list.

When you save a newly created custom query, it gets added to the new Custom queries section on the sidebar where you can access it anytime. If you are currently using a saved custom query (by the way, the currently used query is saved in the browser just like the current view parameters), it is highlighted on the sidebar and its name appears as the title of the page instead of Issues. Also, the Edit and Delete links appear in the top-right corner of the main content area. These links can be used to modify or delete the saved query.