Test Items Page (Project Editor)

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

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

Add a new group

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.

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

To modify test item parameters, click the ellipsis button within the Parameters cell and use the resulting Test Parameters dialog.

To modify a tag expression:

1. Click the ellipsis button in the Parameters column of the [Tag Expression] test item.

2. In the resulting Test Parameters dialog, specify the needed tag expression.

   Tag expression syntax

   Tag expression syntaxTag expression syntax

   • Use @ before tag names, that is, use @tag1 rather than tag1.

   • To combine tags, use the and, or and not operations, for example:

     @tag1 or @tag2
     @tag1 and not @tag3
     not @tag5

     These operations don’t depend on the scripting language you use in your TestComplete project. That is, for example, in JavaScript projects you should use and, or and not rather than &&, || and !  —

     @tag1 and not @tag2  ← Correct!
     @tag1 && !@tag1      ← Incorrect!

   • If needed, you can use braces to group tags, for example:

     @tag1 and (@tag2 or @tag3)
     (@tag1 or not @tag2) and (not @tag3 or @tag4)

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

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

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

Link a test item to a test case in an external test management system

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.

3. If your TestComplete project is not bound to an external test management system yet, select either Zephyr for Jira or Azure DevOps and connect to it in the resulting wizard.

   Before linking your TestComplete project to an Azure DevOps team project, make sure to add the TestComplete project to your team project’s repository.

4. Select an external test case to which you want to bind your TestComplete test case.

   If you are connecting to Zephyr for Jira:

   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. Use the following format:

   zfj://<your_zephyr_test_case_key>

   If you are connecting to Azure DevOps:

   On the Edit test case associations page of the wizard, click the ellipsis button and select the needed test case in the resulting Choose Test Case dialog. Then click Add association.

   If needed, repeat the step to link the TestComplete test case with several test cases of the test plan.

Remove a link between a test item and an external test case

Remove a link between a test item and an external test case

1. Select a test item linked to an external test case.

2. If the item is bound to a Zephyr test case, clear the Link to external test case column.

   If the item is bound to an Azure DevOps test case:

   To remove a single link:

   1. Click the ellipsis button in the Link to external test case column.

   2. In the resulting Associate with Azure DevOps / TFS Test Cases wizard, in the Existing associations table, select the needed test case.

   3. Click Remove and then click Finish to apply the changes.

   To remove all the links at once and unbind your TestComplete project from the Azure DevOps / TFS team project:

   1. Switch to the Properties page of your project.

   2. Select Azure DevOps in the tree on the left.

   3. Click Unbind from Azure DevOps / TFS Project.

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

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

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.