Test Items Page (Project Editor)

To add a new test item

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

To add a new group

To add a new group

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 Execution entity 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 mark a test item as a test case

To 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 on the Test Items page.

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 on the Test Items page.

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

To link a test item to a test case in an external test management system

To link a test item to a test case in an external test management system

1. Mark the needed test item as a test case.

2. Click in the Link to external test case column, and then click the ellipsis button in the column.

3. If your TestComplete project is not bound to an external test management system yet, bind it in the resulting Link to external test case wizard.

4. In the Link to external test case wizard, select the external test case you want to bind to your TestComplete test case.

   – or –

   Type the identifier of the external test case manually. For instance, to bind a test case to a Zephyr test case, use the following format:

   zfj://<your_zephyr_test_case_key>

To remove a link between a TestComplete test case and an external test case, clear the Link to external test case column.

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.