Test Items Page (Project Editor)

To add a new test item

To add a new test item

You can add a new top-level test item at the end of the test items hierarchy or add a new item as a child of the selected item.

You can add top-level test items in one of the following ways:

• Click  New Test Item on the toolbar.

• Right-click somewhere within the Test Items page and choose  New 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 Test Items page.

  Note:

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

• Drag a script routine from the Code Explorer panel to the Test Items page.

To add a child 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.

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

To add a new group

To add a new group

You can add a new top-level group at the end of the test list or add a new subgroup as a child of the selected node.

To add a top-level group:

• Click Add New Group on the toolbar.

– or –

• Right-click somewhere within the Test Items page 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.

To modify test item properties

To 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:

• Click the ellipsis button of the Test column and choose the desired test using the Select Test dialog.

To modify the parameter values for the test:

• Click the ellipsis button within the Parameters cell and use the resulting Test Parameters dialog.

To rename a group

To 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.

To copy an existing test item or group

To copy an existing test item or group

1. Select the source test item or group and click Copy on the Standard toolbar or press Ctrl+C.

2. Click Paste on the Standard toolbar or 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 Test Items page and choose Paste from the context menu.

To include or exclude test items from a test run

To 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. Click the Enable Selected or Disable Selected button on the toolbar.

   – or –

   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:

• Click the Enable All or Disable All button on the toolbar.

– or –

• Right-click somewhere within the Test Items page and select Enable\Disable > Enable All and Enable\Disable > Disable All from the context menu.

To toggle the enabled property of all test items:

• Click the Toggle All button on the toolbar.

– or –

• Right-click somewhere within the Test Items page and choose Enable\Disable > Toggle All from the context menu.

To run a test item or group

To run a test item or group

When you execute your test project, TestComplete automatically runs all the enabled test items that can be managed on the Test Items page. 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.

To change the run order of test items

To 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.

To navigate to the test source

To 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.

To expand or collapse test items

To expand or collapse test items

To expand all test items on the Test Items page, right-click somewhere within the Test Items page and select Expand All from the context menu. Alternatively, use the Ctrl+Alt+A shortcut.

To collapse all test items on the Test Items page, right-click somewhere within the Test Items page and select Collapse All from the context menu. Alternatively, use the Ctrl+Alt+C shortcut.

To delete a test item or group

To 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.

To save or cancel changes

To 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.