Execution Plan Editor - Test Item List Panel

Add a new test item

Add a new test item

To add a new top-level test item, do any of the following:

• Click  New Test Item on the toolbar.

• Right-click somewhere within the Test Item List panel and choose  New Test Item from the context menu.

• Drag the desired test (for instance, a keyword test, a unit test and so on) from the Project Explorer panel to the Execution Plan editor.

  Notes:

  • If you drag and drop a script unit, TestComplete will add test items corresponding to all of the script routines contained in that unit.

  • TestComplete will name the created test items based on the source script routine and keyword test names.

• Drag a script routine from the Code Explorer panel to the Execution Plan editor.

To add a child test item to an existing test item, do any of the following:

• Select the parent test item or group and click  New Child Test Item on the toolbar.

• Right-click the parent test or group and choose  New Child Test Item from the context menu.

• Drag the desired test from the Project Explorer or Code Explorer and drop it in the parent test item.

Notes:

• By default, the Code Explorer panel is hidden from TestComplete. To make the panel visible, select View > Select Panel from the TestComplete main menu, and then select Code Explorer in the resulting Select Panel dialog.
• By default, TestComplete considers child test items as test steps rather than test cases. The added child test items are not marked as test cases. Test items that are not marked as test cases will not be included in the Summary report.

Once you have added a new test item, you can modify its properties and relocate it in the list.

Add a new group of test items that will be executed in sequence

Add a new group of test items that will be executed in sequence

To add a top-level group:

• Click Add New Group on the toolbar.

– or –

• Right-click somewhere within the Test Item List panel and choose New Group from the context menu.

To add a subgroup:

• Select the parent test item or group and click New Subgroup on the toolbar.

– or –

• Right-click the parent test or group and choose New Subgroup from the context menu.

Test items added to such groups will be executed in sequence.

Add a new group of test items that will be executed in parallel (for cross-platform web and mobile tests)

Add a new group of test items that will be executed in parallel (for cross-platform web and mobile tests)

• Click Add New Parallel Group on the toolbar.

– or –

• Right-click somewhere within the Execution Plan editor and choose New Parallel Group from the context menu.

Parallel groups do not support subgroups and cannot be run on 32-bit operating systems.

You cannot assign environments to the entire parallel group. You can assign environments to individual tests in the group, in the Parallel Device Cloud Environments panel of the editor or directly in the test.

Modify test item properties

Modify test item properties

Select the cell that contains the data you want to change, and press F2 or click twice (not double-click).

To change the test to be executed:

1. Click the ellipsis button of the Execution entity column.

2. In the resulting Select Test dialog, select the needed test or tag. To run tests that match several tags, select [Tag Expression].

Rename a group

Rename a group

1. Select the group and press F2, or click the group twice (not double click).

2. Enter the new name for the group and press Enter to apply it.

Copy an existing test item or group

Copy an existing test item or group

1. Select the source test item or group and press Ctrl+C.

2. Press Ctrl+V.

– or –

1. Right-click the source test item or group and select Copy from the context menu.

2. Right-click somewhere within the Execution Plan editor and choose Paste from the context menu.

Include or exclude test items from a test run

Include or exclude test items from a test run

TestComplete allows you to easily specify which test items should participate in testing and which should be temporarily excluded.

To enable or disable a single test item or group:

• Select or clear the check box next to the test item’s icon.

To enable or disable several test items at once:

1. Select the desired test items in the panel using Ctrl- and Shift-clicks.

2. Right-click the selection and choose Enable\Disable >  Enable Selected or Enable\Disable >  Disable Selected from the context menu.

To enable or disable all of the test items:

Right-click somewhere within the Test Item List panel and select Enable\Disable >  Enable All and Enable\Disable >  Disable All from the context menu.

To toggle the enabled property of all test items:

Right-click somewhere within the Test Item List panel and choose Enable\Disable >  Toggle All from the context menu.

Mark a test item as a test case

Mark a test item as a test case

In TestComplete, you can mark test items in your project as test cases to collect information on their results to a Summary report.

To mark a test item as a test case, select or clear the Test Case check box of the test item.

To mark (or unmark) several test items at once:

1. Select the needed test items. You can use Ctrl- and Shift-clicks for multiselection.

2. Right-click the selection, click Mark/Unmark Test Case, and then click Mark Selected or Unmark Selected.

To mark (or unmark) all test items as test cases:

1. Right-click anywhere within the Test Item List panel.

2. Click Mark/Unmark Test case and then click Mark All or Unmark All.

To toggle all test cases and test items:

1. Right-click anywhere within the Test Item List panel.

2. Click Mark/Unmark Test case and then click Toggle All.

Run a test item or group

Run a test item or group

When you execute your test project, TestComplete automatically runs all the enabled test items that can be managed in the Execution Plan editor. Besides, you can run the desired test items manually in one of the following ways:

• Select the desired test item or group of test items and click Run Focused Item on the toolbar.

– or –

• Right-click the test item or group and select Run Focused Item from the context menu.

TestComplete will run the selected test item or group along with all child items.

You can run test items not only from TestComplete UI. For information about all possible ways of running test items (from the command line, from Jenkins and so one), see information in the Running Test Items section.

Change the run order of test items

Change the run order of test items

• Use the Move Up, Move Down, Indent Item and Outdent Item buttons on the toolbar.

– or –

• Drag the desired item to the desired location within the tree. When you drop the dragged item, TestComplete will place it after the test item that is under the mouse cursor.

  Note:

  To move an existing test item to a group, press Alt and drag the test item to the group.

Navigate to the test source

Navigate to the test source

• Select the test item and click the  Jump To Test button on the toolbar.

– or –

• Right-click the test item and select Jump To Test from the context menu.

TestComplete will open the corresponding editor in the Workspace panel. If the test item relates to a certain scripting routine, TestComplete will navigate to the beginning of the routine in the Code Editor.

Expand or collapse test items

Expand or collapse test items

To expand all test items in the Execution Plan editor, right-click somewhere within the Test Item List panel and select Expand All from the context menu. Alternatively, use the Ctrl+Alt+A shortcut.

To collapse all test items in the Execution Plan editor, right-click somewhere within the Test Item List panel and select Collapse All from the context menu. Alternatively, use the Ctrl+Alt+C shortcut.

Delete a test item or group

Delete a test item or group

1. Select the desired node in the list (you can use Ctrl- or Shift-click for multiselection).

2. Press DEL, or click  Delete on the Standard toolbar, or choose  Delete from the context menu.

Save or cancel changes

Save or cancel changes

To save changes made to the project’s test items, select File > Save from the TestComplete main menu.

To cancel any changes, close the editor and answer No when TestComplete asks you whether to save the changes.