Test artifact list views

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 more information, 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.

Number of Items Per Page

Specifies how many items to view at a time.

Copy link for this page

Enables you to copy the link for the current page, which includes all the required information to re-create the current page. The option is available in the page for all list views that support filters. All artifact editors are also supported and the link includes the section that is currently selected. This option also enables you to copy the title of the page in one click. For the artifact editors, the title includes the ID and title fields. For the list view, the title is the artifact type and the filter description.

Run Default Query

If a saved query is set as the default query, when the table list view is selected, the default query results are listed instead of all the artifacts. If the list view is manipulated with filters and other queries, Run Default Query resets the table list view with the default query set for the list view.

Set Default Query

The default query set for the list view is set in the project properties by the administrator that can be none or a shared query. You can use the Set Default Query to override the default query that is set in the project properties. You can override with a personal query as well. It is a convenient way to change the List View Queries of the list view of the artifact type you are viewing without navigating away to the User Preferences menu. You can set the current query used in the list view as default both a personal query or a shared query.

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.

Select

If a table list view supports multiple selections, the table header provides a drop-down menu with the options to select or deselect all items on the current page, and to select or deselect all items on all pages. If the check-box is selected, it indicates that all items in the table are selected. If the check-box is cleared, it indicates that no items in the table are selected. A shaded check-box indicates that some items in the table are selected, and they might not be displayed on the current page.

Action Bars

The Action Bars are a row of icons along one side of the list view. For example, the Action Bars for the test plan table are as follows:

Functions in the Action Bars vary according to the artifact type. For example, the following are the functions in the test plan's Action Bars.

• The Refreshed icon updates the display.
• Click the Create Test Plan icon to open a new test plan window. You can enter a unique test plan name and also select a test plan template. See Creating test plans for more details.
• The Manage Test Plan Categories icon creates and organizes test plan categories.
• The Export PDF icon exports the view to a PDF file.
• The Download as spreadsheet (.csv) icon exports the view as a comma-separated spreadsheet.
• The Change Display Settings icon changes the columns and status bars that are displayed and changes the width of each column. By default, all sections use the personal settings when the list view is opened. You can choose to use the Used default column display settings or the Use personal column display settings.

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 manage your work. Click the window sash beneath the column header row to display the filters for each individual column.

To add additional filtering criteria that is not currently displayed in a column, move the cursor far from the header row and click the Enter More Filters icon .

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 sidebar to do additional filtering. Click the window sash along the border of the main window to open the filters 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.

Test Cases view

• Filter by script steps

Test Case results

• Filter by Passed script steps
• Filter by Failed script steps
• Filter by PermFailed script steps
• Filter by Inconclusive script steps
• Filter by Attempted script steps
• Filter by Deferred script steps
• Filter by Blocked script steps

Action menus

An Action menu 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.

Inline editing

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 () on hover. To edit a table cell, do one of the following actions:

• Select Edit Test Artifact from the Action Menu.
• Double-click in a cell.
• Hover over an editable cell until you see the Edit icon (), and then click the icon to open the cell for editing.

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

The test case editor has a section named Edit Test Scripts Inline that enables you to directly edit and save any test scripts that the test case references. To use this feature, you add the section to any existing test case.

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 Change icon next to 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

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

Icons

The editors in Engineering Test Management display icons to differentiate artifact types. For new users, the artifact types might not be apparent from the icon. To improve usability, the label of the artifact type is included near the icon.