Filters are defined to perform simple or complex queries on a system. The result of the filter is a sorted list of issues with fields that match the specified definition. These filters are extremely useful for doing searches and comparisons. The resulting lists can then be used for charts and reports, where they can be summarized, ordered, and compared. Data can also be exported after running a filter, for custom analysis.

Examples:

• "Open Bugs" will filter the list to show all bugs in an "Open" status. Bugs that are "Deferred", "Ready for Retest", "Closed", or "Rejected" will not appear in the list.
• "Bugs assigned to [userid]" will filter the list to only show bugs assigned to yourself.

More complex filters can be defined using the "Filter Bugs" link, where they can also be saved for future use. You can create filters that compare specific fields or do searches for fields that contain specific strings.

Selecting a filter should automatically execute the filter. However, if javascript is disabled, you will also need to click on the arrow to the right of the list.

Filters stay active until they are cleared. Clicking on the Clear Filter button does this.

The Filter Definition

The User Overview gives more detail to the filter definition that is displayed at the top of each page. This definition defines an active filter and the lists of bugs that are displayed.

Defining Custom Filters

On the filters page, you are able to choose a specific value for any system or custom field. After you select a set of values for a group of fields (these are your criteria), you can run the filter by pressing the "Filter" button. This displays only the bugs that match your criteria.

If you have any saved filters, they will appear in the filters dropdown, above the system filters, which are denoted by a '*'.

Saved filters can be edited/deleted from the "Filters" link. Simply select edit for the appropriate filter and then you can edit the fields and save it again. If you rename the filter, you will have to delete the old one manually, for the time being.

The System Filter buttons are of course only visible to admin users.

Saving Custom Filters

Filters can be saved for future use by entering a name in the "Save As" field, when selecting the criteria for the filter. If nothing is typed here, the filter is run, but can not be used again later.

The following table is visible to all admin users for the purpose of adding system filters. These system filters will appear in the drop-down filter lists of all users :

The "System Filter" button is used instead of the regular "Filter" button, if a system filter is desired. The normal "Save" textfield must contain the desired name, or the filter is run but not saved.

Also notice that the "Assigned To" and "Entered By" lists have an extra generic user called "CURRENT_USER". This value will be replaced with the name of the user that is using the system.

Note:
The filters can sometimes cause problems for users if they forget that a filter is active. If you are missing information about specific issues in your output, it is probably because a filter is set. If a filter is active, you will notice its definition at the top of the page.

Relative Dates

Relative Dates allow you to save a filter which uses a date relative to the time that the filter is used.
Relative Dates : [m D] {1..N} where :
- m is the multiplier and
- D is the displacement : Year / Month / Week / Day / Hour / MINute / Second
  Example: -1 Y -13days +44 Min   (now/today/yesterday also work)