Note: If you already know how to add and edit a filter, you can skip to the next article – Hierarchical filter trees
Table of Contents
Custom Filters allow you to organize your issues, tests, test-sets and requirements, by creating filters and defining the fields (columns) that are displayed in the grid for each filter. For example, you may want to organize your tests according to different components of your application, or according to the person that will run them; or you might want to sort your issues by status, by priority or by version. You can also create cross-filters based on filters from a different module and automatic filters that are automatically updated based on changes to the field they are based on.
Using filters, you can display the information in each module under multiple “trees”. For example, you can organize all the tests in your project under two different trees: one based on the testing level (regression vs. sanity) and the other based on the application and the module they cover. The same test can appear under multiple trees, since each test may belong to several categories (i.e., a sanity test for the application server).
You can add and customize filters from the Filter tab in the Settings section, or from the tree of each module.
For example, we will create a filter for the Issues module, displaying only open issues and a sub-filter displaying open issues that belong to a specific product component (database).
- Go to the Issues module. You can see the filter tree located on the left side of the screen.
Note: if the view tree is closed, click on “Filter Tree” to open it.
- Press New Filter
- Define your filter:
- Filter type:
When creating new filters from the “settings” page, this field will allow you to select under which module your filter will be created (Issues, Tests, Test sets or Requirements). Since we are adding a filter from an existing filter tree, the module is already selected.
- Filter name:
It is recommended that the filter’s name will be descriptive enough to allow your users (and yourself) to understand what will be displayed when this filter is selected. In this example we’ve chosen to name this view “Open Issues”.
- Public filter:
Private filters will only be available to the user who created them, while public filters are available to all users. Uncheck this checkbox if you think that only you will be interested in the current filter.
- Auto filter:
Please see below.
- Parent Filter:
Filters in PraciTest can be arranged in a hierarchy: a child filter will only show information based on its parent filter. This feature is called cascading or hierarchical filters. Please see below for further explenation about sub-filters.
- Add a filter criteria:
To select the criterion you would like to filter by, click on the “add AND query”. In this example we are adding a filter that will only show us open issues.
First, select the field you would like to filter by from the drop-down list. In this example we have selected to filter by Status.
Next, select “is” to determine which product component this filter will show.
Finally, select the appropriate criterion – in our case, “Opened”.
Our filter will now only show us open issues.
- Custom Fields:
In the Field Selector section, you can customize the fields you want to display in the grid.
Note: The system provides you with a list of fields you can select to display in the grid, depending on the module (filter type) you have selected. The available fields in the Filter section also depend on the module.
To add a field, click on the “plus” icon next to a field’s name, on the left column.
To remove a field, click on the “minus” icon on the right column.
Note: the display order of these fields is based on the order of appearance in the Selected Fields box. You can change the order by dragging and dropping the fields on the right column.
- Create Filter:
To save the filter, click the “Create Filter” button. This will take you back to the “issues” module, and show you your new filter.
- Filter type:
Adding Filters from the Settings Link
Another way to reach the Customized Filter window is by clicking the “Settings” icon at the top right side of your screen, and then clicking the “Filters” tab.
To create a sub filter, open an existing filter’s menu by clicking on the icon next to it. Then Select “Add Sub Filter”.
In this example, we are creating a child-filter of ‘product component - database’, under a previously created filter named “Open issues”. The existing filter only shows issues in status “Open”; Hence, creating a child view for “database - product component” will only show issues that fit the criteria of both filters.
We choose the name “database - product component” for the child filter, the parent filter is automatically chosen according to the filter we decided to create the child filter for. In the criteria we add the field of “product component” and we define it as “database”.
We press ‘Create filter’ and this is how it will look like in the filter Tree menu:
You can see that just as we defined, this view only displays Database issues in status Open. In addition, the fields displayed in the grid are those we selected.
Cross filters allows you to create filter in one module, based on filter in another module. For example, if you want to see all issues related to a certain sprint, and you have a relevant 'Sprint' filter in your Test Sets & Runs module, you can create a cross filter in the issues module and base it on the sprint filter from the Test Sets & Runs module. Learn more about cross filters from this post
When creating a filter based on a ‘list’ type field, Auto filters allow you to automatically create sub-filters based on the field’s list values. For example, we will go back to the “Open issues” filter and create a sub auto filter based on the ‘product component’ field.
Once we tick the ‘auto filter’ option, we can choose the field you want to base the filter on, under Filter Criteria. The name of the filter will be automatically given based on your choice as well.
This will automatically create sub-filters for all the list items in the ‘product component’ field + a sub-filter for “Other/Empty values”.
“Other/Empty values” are for entities without any values or entities with values that are not part of the list options. For example, if we import an issue with the value “System services” under the product component column. The numbers at the end of each line represent the number of entities that belong to this value/subfilter.
Auto-filters are synced to the field they are based on and any change to that field will be reflected in the filter as well. For example, when adding or deleting a value from the filed list - the filter will automatically create or delete the relevant value sub-filter. In this example I am adding a new value “user-interface“ under the list field “product component”
a sub-filter with that value is automatically created.
Changing or Deleting a filter
To edit a filter, click on the menu icon next to the relevant filter, then click on the “Edit” link. To delete a filter, click on the menu icon, then click on "Delete Filter". You can also go to Settings –> Filters, and edit or delete your view from the list.