Working with scheduled test suites

You can schedule a test suite to run at a specified date and time.

To schedule a test suite, you need three components:
  • a test suite record
  • a schedule record specifying when you want the system to run the test suite
  • a scheduled suite run record that associates the test suite to run with the schedule for running it
With this model, you can associate a schedule with many different test suites and vice-versa.
Note: You can schedule only test suites, not individual tests.

The watchlist on the test suite run record also allows you to specify users to receive an email when the system finishes executing the test suite run.

If the test suite contains one or more form steps (steps involving a user interface), you must ensure that a scheduled client test runner is actively running in a browser when the schedule triggers the suite run.

Note: See Browser recommendations and requirements for recommendations and requirements for running the client test runner.

For step-by-step instructions on how to schedule a test suite, see Schedule automated test suite.

Designate users to receive email when system finishes running a scheduled test suite

You can designate users to be notified when a scheduled test suite finishes executing.

Before you begin

Role required: atf-test-admin


  1. Navigate to the scheduled test suite run record.
  2. Add to the record's watchlist all users you want the system to notify when this scheduled test suite run completes.

Automated Test Framework scheduled test suite completed email

When the system completes executing a scheduled test suite, it sends an email to users on the Scheduled Suite Run record watchlist. This email contains information and links to further information about the Scheduled Suite Run and its results.

Suite Stats

The Suite Stats section of the email reports the number of suites and individual tests broken down by result status: Failed (F), Error (E), Skipped (S), Canceled (C), or Passed (P). For a description of what each status means, see Test Suite Results record .

Test Suite Results

The Test Suite Results section of the email reports test suite results over time. By default, this report includes only suites with failed tests, but you can change this setting with the Email properties field on the Automated Test Framework Properties page.
Table 1. Test Results Key
Letter Color Description
F red Test failed
P green Test passed
S white Test skipped
C white Test canceled
E white Test has error

Each entry acts as a link to the result record for that run. If you point the mouse to any of these entries, the system displays the parent suite number, the parent suite end time, and the test result output.

Properties affecting email content

On the Automated Test Framework Properties form, you can set options affecting the format and content of the email.