Test artifact list views

Test artifact list views display a table of test artifacts of a single test artifact type. The list views provide a mechanism for managing test plans, test cases, test suites, test scripts, test execution records, test results, and other test artifacts. Each view provides multiple filtering strategies so that you can organize the test artifacts in your repository and find specific test artifacts more quickly. You can open each view by selecting the appropriate Browse command from the menus in the header.

The following figure shows a list of test plans, which you can open by clicking Planning > Browse > Browse Test Plans.

Test plan table

Interface elements

The following interface elements are common to all artifact lists.

View As
Provides different views. All artifact types have a General view. Several artifact types also have a Traceability and Execution view. For details, see Traceability and test execution views.
Group By
Groups the list of artifacts in different ways, depending on the artifact type. Typical groupings include group by owner, group by priority, group by iteration, group by test plan, group by test case, and group by a specific category, such as product, release, or test phase.
Items per page
Specifies how many items to view at a time.
Type filter text
Performs a quick search, such as for an artifact with a particular name or an artifact that was modified on a particular date.

Action bar

The Action bar is a row of icons along the upper-right side of the list view. For example, the Action bar for the test plan table is as follows:

Action bar

Functions in the Action bar vary according to the artifact type. For example, the functions in the test plan's Action bar are listed below:

Filtering and sorting in the main list view

You can use the column-filtering capabilities in the main list views to locate specific test artifacts more quickly and to manage your work. Click the window sash beneath the column header row to display the filters for each individual column.

Expanded filter

To add additional filtering criteria that is not currently displayed in a column, move the cursor to the far right side of the header row and click the Enter More Filters icon Add Filter.

To run an ascending sort on that column, click a column header, such as State. Click the column header again to run a descending sort. Click the column header a third time to remove the sort on that column.

After you define the filtering and sorting criteria, you can save your choices as a query, which you can run at a later date.

Filtering in the sidebar

You can use the left sidebar to do additional filtering. Click the window sash along the left border of the main window to open the filters sidebar.

Sidebar

All artifact tables include the Filter By Categories and Filter By Saved Queries features. With test case lists, you can also use the Filter By Test Plans feature. With lists for test case and test suite execution records, you can also filter by the parent test case categories.

Filter by Test Case Categories

Action menus

An Action menu Action menu drop down is available for each row in the list. Several functions are available from the Action menu, depending on the artifact type.

For example, the Action menu for a test plan includes the actions shown in the following figure.

Action Menu test plan

Inline editing

Starting in the 4.0.1 release, you can edit some of the table cells in a list, without having to open the artifact itself. For example, while viewing a list of test plans, you can change the name of individual plans and change the priority, owner, state, categories, and custom attributes.

The cells that you can edit vary by artifact. You can edit any cell that displays the Edit icon (Edit) on hover. To edit a table cell, do one of the following actions:

After making your edit, click Save Changes from the Action menu. You can also press Enter, press Ctrl+s, or click outside the row.

Bulk editing

You can make bulk edits to several artifacts in a list. For example, if someone leaves the test team, you can select multiple rows and click the ChangeBulk change icon to the right of the Owner column to change the ownership of all of the selected artifacts. Or, if the release number changes, select the artifacts that are impacted, and use bulk edit to change all of the artifacts at once.

Status icons

Icons that represent test artifacts are sometimes decorated with smaller icons that show the execution status of the artifact:
Status icons on test cases

For information about the meaning of these icons, see Test artifact status icons.



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