Run Automated Tests

Applies to QAComplete 14.3, last modified on February 19, 2024

When you have installed and configured the test agent, linked it to a configuration, associated an automated test with the Test Library test and test host, you can run the automated test on demand from Test Management. Automated tests and fully automated test sets can also be run without user interaction by using Test Schedules.

Like any manual test, you can run an automated test directly from the Test Library or as part of a test set. Tests or test sets can be linked to a release, iteration, or build, and to the desired configurations.

Note: For more information about releases, see About Releases.
  • To run an individual test (not as part of a test set), click the Run button on the needed test’s row in the Test Library.

  • To run a test as part of a test set, create a test set and add your automated test to the set. Click the Run button on the row of the needed test set on the Test Sets screen.

The Test Runner screen opens. If the test or test set is linked to a release, select the desired release first. Select the test host in the Run By Host drop-down list and click Run.

Your tests will run immediately on the associated test host. The Test Agent on the selected test host will perform the following steps:

  1. Connect to the QAComplete web service.

  2. Retrieve the automated tests associated with the test.

  3. Start the appropriate automated testing tool (TestComplete, TestExecute, ReadyAPI, SoapUI), or a unit testing framework.

  4. Run the automated test.

When complete, the results are posted to the Run History tab on the Edit form for the test and test set.


  • If you assign TestComplete automated tests to your tests in Test Management, TestComplete or TestExecute must not be running on the test host when the automated test is run. Otherwise, the test will return an error. TestComplete and TestExecute will be automatically started by the Test Runner.

  • If the required testing tool is not installed on the test host or the Test Agent is not configured properly to run that testing tool, the test will fail.

  • If your test host has an earlier version of the Test Agent that does not support the assigned automated test, the test will not run.

  • The Test Agent can be set to log off of Windows on the host machine. This closes any open applications, logs out, then logs back in with the credentials from the Test Agent configuration. There is an option on the configuration form you can set to first check if that user is currently logged in and to avoid the logout.

Run combined tests

You can combine both manual and automated tests in the same test set. When you start the Test Runner, the automated tests are submitted on the associated hosts, and you can continue running manual tests as usual.

See Also

Run Manual Tests
Run Token Tests

Highlight search results