Running or scheduling the running of a test

You initiate a test execution in the Test Factory, but the test is run in the Test Lab perspective. After you start a test, the Test Lab perspective is displayed, from where you monitor the tests execution. A test can be run either in the current environment or in any other environment.

About this task

Note: For the tests that pass, you can avoid storing the messages that are sent and received during the test execution in memory. To do this, open the Properties page in the Test editor and select the Free up memory associated with messages sent and received when test execution passes option. If a Test Cycle is used to store the tests in a database, the messages of the passed tests can still be viewed in the Results Gallery.

Running tests in the current environment

Depending on the current Run Resources preferences, the test is run from its current state (including any unsaved changes) or from its last saved state.

About this task

To change the state from which a test is run, see Changing preferences.

A test can be run in any of the following ways:


  • Select one or more tests, and press F5.
  • Right-click one or more tests, and select Run from the menu.
  • Select one or more tests, and click the Run icon in the main HCL OneTest API toolbar.
  • If the test was run recently, click the small arrow next to the Run icon in the main toolbar and select the test to run.

Scheduling the running of a test

To run a test in an environment other than the current environment, or to schedule the running of the test, use the custom execution dialog.


  1. Open the custom execution dialog in one of the following ways:
    • Select a test and press Shift + F5.
    • Right-click a test and select Run from the menu.
    • Select a test, click the small arrow next to the Run icon in the main toolbar, then select the Run option.

      The Run test_name window is displayed.

  2. Select the environment in which the test is to be run from the Environment list.
  3. In the Execution Preference section, select one of the following options:
    Run now locally
    No further options are required.
    Run later
    • Select items for the Attributes field. These attributes are used to determine the engine to run the test at the scheduled time or times.
    • Provide information in the Schedule section to specify when the test is run.
    Restriction: The domain-level security cannot be enabled for scheduled tests.
    Note: The scheduled test and its associated assets are published to HCL® Quality Server for a subsequent run at the scheduled date and time. All users who are logged on to HCL® Quality Server can view the scheduled test as the domain-level security is not applied to such tests.
  4. Click Run to run the test.