Running test suites

A test suite is a collection of test cases that are grouped to be run together. You can run a test suite by opening the test suite or by opening the Browse Test Suites window.

About this task

You can run the test cases in your test suite in a sequence or in parallel. If you run a test suite in a sequence, a test case runs only after the previous test case in the sequence finishes running. If you run a test suite in parallel, you can run all of the test cases at the same time.

After testing starts, you can pause test suite runs from the Test suite execution console. You might pause test suite runs when the system that you are testing needs minor adjustments before testing can proceed.

When you pause a test suite run, any manual test runs that are part of the suite are also paused. If you pause a test while an automated test is running, that test is completed; however, automated tests that are not started do not run. In either case, the test suite is paused. You can resume paused test suites from the Test suite execution console, Test suite execution record list view, or Test suite execution record editor.

You can stop test suites from the Test suite execution console. Unfinished test cases in that suite are marked incomplete. Stopped test suites cannot be resumed.

Note: The start time for test suite execution is the earliest start time of its associated test cases.


  1. Open a test suite.
    Note: You cannot run a test suite until it is saved.
  2. In the upper right of the test suite window, click the Run Test Suite icon (Play) or use the keyboard shortcut Ctrl + Shift + X.
  3. In the Test Suite Execution Record section, either select a test suite execution record or create an execution record by accepting the default option, New Test Suite Execution Record.
    If you create an execution record, select the test plan, test iteration, and the test environment.
    Note: If you already have an execution record that uses the same test plan, test iteration, and test environment that you specified, that execution record is used. A new execution record is not created.
  4. Optional: If you run a test suite that has the Run a test script option enabled, the automation script that is associated with the test suite is run. In the Run Test Script dialog box, you can select the following options:
    • Schedule execution
    • Create a result without executing
    • Modify execution variable values
    When you run the automation script, the result of the test cases that are associated with the test suite are displayed in the Result Details section of the test suite result.
  5. Optional: Select a channel.
    During the run of the test suite, the default script for the channel is chosen by using the keywords in the script. The available channels are based on the selected test environment.
  6. Optional: Select a test cell. If the test suite includes automated test cases, you can specify the test cell to run the test suite.
    All the automated test cases are distributed among the test automation adapters that are in the specified test cell.
  7. Optional: If the test suite contains test cases that have automated test scripts, you can select multiple test cases and assign the same adapter to all of them. Select the check boxes that are next to the test cases, and then, in the Machine column, click the Change Machine icon (Bulk change).
    Note: Most automated test adapters can run only one script at a time. If you select the same adapter for multiple test cases, the scripts on that adapter are run in sequence. To run scripts in parallel, you must select a different adapter for each script.
  8. Optional: Specify which test cases to exclude from the test suite run. If you do not exclude test cases, all the test cases in the suite are included. To skip test cases, complete one or both of the following actions:
    • If you selected a test suite execution record, you can skip any test cases that passed when the test suite execution record last ran. Click the Exclude Passed Test Cases icon (Exclude Passed Test Cases).
    • To skip specific test cases, select the test cases in the table and click the Exclude from Execution icon (Exclude Execution).
    All the test cases that you selected are marked with an icon in the Exclude from Execution column and are not included in the test suite run. If you decide to include all the test cases in the test suite run, select the test cases again and click the Exclude from Execution icon (Exclude Execution).
  9. Optional: Specify a default test script for each test case that runs.
  10. To associate the results of this test suite run with a build record, next to the Build Record option, click the Change Associated Build icon (Change Associated Build) and select a build record.
    The execution result from this test run is automatically linked to the build record that you select.
  11. To schedule the test suite to run at a future time, select Schedule Execution and select a date and time.
  12. Select whether to run the test cases that are in the suite in parallel.
  13. If you selected the option to run the tests in a sequence, you might select more options:
    • If your test scripts use execution variables and you want to pass the values between scripts during the test suite run, select Pass execution variables between scripts.
    • To specify that the test suite must be stopped if a single test case does not pass, select Stop suite execution if any test does not pass. This option is useful if you are running a test case in a test suite that depends on the success of previous test cases.
  14. To record a result for this test without running the scripts, select Create Result without Execution and then select a result.
  15. To temporarily modify the values of the execution variables that are defined in your test suite, click Modify Execution Variable Value(s).
  16. Open the Test suite execution console by clicking Run.
    Test suite execution console
    If you are running tests in a sequence, the first test case in the sequence is shown in the console. If you run tests in parallel, the automated test cases start to run and the manual test cases or test cases without scripts are shown in the console.
  17. If the first test case in the suite is a manual test, click Start Manual Test. If the first test case in the suite does not have an associated test script, start the test by clicking Run Test Case in the Test Case Progress column.

    If the first test case in the suite is an automated test, the test runs automatically.

  18. For manual tests, follow the steps in the manual test execution window and, when you are finished, click Close. If a test case does not have a script, record a result for the test case and then click Save and Close.
    If you have manual scripts or test cases without scripts and you are running the test in parallel, you can return to the Test suite execution console at any time. You can start to run another test case in the suite.
  19. When a test case is completed, you can view the execution result for the test case by clicking the icon in the Result column. The execution result includes the editable Actual Result field and more details about the testing artifacts and testing environment that is associated with the test case.
  20. Update the execution results as needed, and be sure to save your updates.
    For example, you can provide a detailed description of the test results in the Result Details section.
    Note: The Results Details section of the test suite result displays a snapshot of the test case results when the associated test suite was executed. If any of the test case results are deleted, the entries remain in the Result Details section to indicate that the test cases were executed, even if there are no details on the deleted test case results.
  21. To submit a defect, in the Change Requests section, click the Create New Defect icon (Create new defect) or Link to Existing Defect icon (Link to existing defect). In the defect form that opens, type information about the problem, and then save the page.
  22. Run the remaining test cases in the suite.
    To finish running the test suite later, or if another tester is responsible for the next test case, close the page. You can return to the test suite execution later.
    Note: If you close the test suite execution console during a test suite run, you can return to it in any of these ways:
    • Click Execution > Browse Test Case Execution Records and then click the Last Result icon.
    • Click Execution > Execution Console and find the test case that must be run as part of the test suite. In the Test Suite Progress column, click the link.
    • Open a test plan and in the Test Suite Execution Records section, click the Last Result icon.


To view the results later, from the main menu, click Execution > Browse > Test Suite Results.

What to do next

To rerun a result, from the Test Suite Results editor, click the Actions icon; then click Rerun. In the Rerun Test Suite window, select the appropriate fields and click Finish. The following attributes are automatically picked up from the previous run: test suite steps, test suite execution record, execution variable value that was set in the previous run at the test suite level, execution mode, whether execution variables are passed between scripts, and whether to stop suite execution if test cases do not pass.