Using filters and queries in the list views

You can use the column-filtering capabilities in the list views to help you locate specific test artifacts more quickly. Each category and custom attribute that is defined can be displayed as a column in the list views, along with other attributes, such as ID, Risk, Name, and State. After you define the filter criteria, you can save your choices as a query.

Procedure

  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:

    Browse Test Cases table view

    In this list you can view all of the test cases at once by selecting Show All in the Items per page field, or 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 of 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. Click the window sash beneath the column header row to display the filters for each individual column.

    Expanded filter

  5. 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 Run.

    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.

  6. Repeat as needed for additional columns.
  7. To add additional filtering criteria, move the cursor to the far right side of the header row and click the Enter More Filters icon (Add Filter).
    • To limit the display to just your own test artifacts, select Current User for Owner.
      Note: You can change the default behavior for this setting in My Preferences for Quality 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 box.
  8. To change the columns and status bars that are displayed or to change the width of each column, click the Change Display Settings (Change Display Settings) icon, and adjust the settings. You can also change the column width by dragging the column dividers.
  9. When you are done, click the Save icon (Save) to save your criteria as a query.
    1. In the window that opens, type a name for the query.
    2. In Query Type, 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 will see the shared options in the dialog box.
    3. Specify the Query Location. You can choose to save the query at the top level of the My Queries or Shared Queries node or in a new or existing subfolder.
    4. Select Remember the current column settings for this query to retain the current column layout.
    5. Click OK to save the query with the currently displayed filter settings and column layout.
  10. Optional: To update the filter criteria, sort criteria, and display settings in a saved query, first run that query. Then:
    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 appears. If you've made changes to display settings that you want to keep, be sure to check the Remember the current column settings for this query box.
    4. Click OK. The new version of the query replaces the old one.
  11. Optional: To change a saved query's name, type, location, or display settings preference, click the icon to the right of the query's name in the Filter by Saved Queries menu, then select Rename. Make your changes and click OK.


Have a problem or a question? Post it in the Jazz.net forum.