Using filters and queries in the list views

You can use the column-filtering capabilities in list views to help you locate specific test artifacts more quickly.

1. Open a view that displays a list of test artifacts.

   For example, to view test cases, click Construction > Browse > Test Cases.

   A window opens, showing a page of items for that particular test artifact:

   

   In this list, you can change the number of test cases that are displayed by using the Number of Items Per Page field. You can set the number of items per page to a different value.

   To move to the next page, click Next or click the number 2.

2. To view the traceability for items in the list to associated resources, such as validated requirements or tested development items, in the View As list, select Traceability.
3. To group the items in the list by owner, priority, test artifact, iteration, or one of the available categories, click the down arrow, and make a selection in the Group by field.
4. To select all the items on the current page of the list view, click Select, and then click Select all items on this page.
5. To select all the items on all pages of the list view, click Select, and then click Select all items on all pages.
6. Click the window title beneath the column header row to display the filters for each individual column.
7. Specify the filter criteria.

   For example, to limit the display to test cases that are in the Integration iteration, click the column filter for Iteration, select Integration Test, and click Filter.

   The display is updated to show only those test cases that are in the Integration iteration.

   For date fields, you can specify a relative date, such as 2 days ago, or a specific date.

8. Repeat the steps for more columns.
9. To add more filtering criteria, move the cursor to the far end of the header row and click the Enter More Filters icon ).
   • To limit the display to only your own test artifacts, select Current User for Owner.
     Note: You can change the default behavior for this setting in My Preferences for Engineering Test Management > List View Settings.
   • To limit the display to those test artifacts that another team member created, click the down arrow, and select one or more names from the Originators list.
     Note: Not all test artifacts have an originator.
   • To limit the display to those test artifacts at a particular risk level, click the down arrow and select the risk level from the Community Risk field.
10. To change the columns and status bars that are displayed, or to change the width of each column, click the Change Column Display Settings icon , and adjust the settings. You can also change the column width by dragging the column dividers.
    Note: The Total Scripts Steps column shows the total number of steps for all the test scripts that are associated with a test case. When more than one test script is associated with the test case, then the Total Scripts Steps column displays zero.
11. When you are finished, click the Save icon to save your criteria as a query.
    1. In the window that opens, type a name for the query.
    2. In Query Type field, specify whether to save the query as a personal query or as a shared query. Only users who are assigned a role with the permission to save shared queries filters in the project permissions see the shared options in the dialog box.
    3. Specify the query location. You can choose to save the query at the first level of the My Queries or Shared Queries node or in a new or existing subfolder.
    4. To retain the current column layout for the query that you are creating, select Use the current column settings for this query only.
    5. Click OK to save the query with the currently displayed filter settings and column layout.

       The queries that you create are displayed in the Filter By Saved Queries menu, in the filter options of the list view.

       Note: The filter options are not displayed in the test artifact list view by default. You can view the filter options by clicking the Show Filters in the list view.
12. Optional: To update the filter criteria, sort criteria, and display settings in a saved query, first run that query. Then, complete the following steps:
    1. Change the filter criteria, sort criteria, and display settings as is described in the preceding text. Be sure to verify your settings by running them.
    2. Click the Save icon in the expanded column header menu.
    3. The Save Query window opens. If you change the display settings, ensure that you select the Use the current column settings for this query only checkbox .
    4. Click OK.
       The new version of the query replaces the old one.
13. Optional: To change a saved query's name, type, location, or display settings preference, click the icon next to the query's name on the Filter By Saved Queries menu, and then click Rename.
    Make your changes and click OK.