Automation Tab

This tab enables you to set test set notification rules and On Failure rules to define what action ALM takes when selected events occur during a test set run. For example, you can arrange for ALM to send email to specified users when a test fails, or to rerun a test upon failure.

To access	In the Test Lab module > Test Sets tab, select a test set and click the Automation tab.
Important Information	The screen has different options depending on if you run a Functional test set using server-side execution or a Default test set using the Automatic Runner.
Relevant tasks	How to Create Test Sets
See also	Test Set Specification Overview Test Lab Module Window

On Automated Test Failure Area

You can set On Failure rules for a test set to instruct ALM in the event that an automated test in the test set fails.

User interface elements are described below:

UI Element	Description
Rerun test	Instructs ALM to rerun an automated test if it fails. If selected, the following options are available: Maximum test reruns. Specifies the number of times an automated test should be rerun upon failure. Cleanup test before rerun. Runs a cleanup test before each test rerun. Click the down arrow to select a cleanup test.
On final failure	Specifies the action for ALM to take on the final failure of any test in the test set. Includes the following options: Do nothing. Stop the test set. Rerun the test set. Runs the test set again up to the maximum number of times as specified in the Maximum test set reruns box. Available for: Default test sets only.
Maximum test set reruns	The number of times a test set should be rerun on final failure of any test in the test set.
	Opens the On Test Failure dialog box, enabling you to change the default failure rules for a test in the test set. For details, see On Test Failure Dialog Box .

Notification Area

You can instruct ALM to send an email to a specified user if certain events occur.

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element	Description
<Message area>	The text for the email ALM sends to the specified user.
Send email	Notifies a specified user if any of the selected events occur. Includes the following options: For Default test sets: Any test finishes with status "Failed". Environmental failure (network problems, hardware failure, etc.). Environmental failure could include, for example, function calls not returning, access violations, version incompatibility between application components, a missing DLL, or inadequate permissions. All tests in the Automatic Runner that were run have finished. For Functional test sets: Send email in the event of any test with status "Failed".
	The user who should receive the email. Enter a valid email address or user name. Alternatively, click the To button to select users. The Select Recipients dialog box opens. Select the users or user groups to which you want to send the email. Note: For Functional test sets, the default e-mail sender is the timeslot creator.

UI Element

Description

<Message area>

The text for the email ALM sends to the specified user.

Send email

Notifies a specified user if any of the selected events occur. Includes the following options:

For Default test sets:

Any test finishes with status "Failed".
Environmental failure (network problems, hardware failure, etc.). Environmental failure could include, for example, function calls not returning, access violations, version incompatibility between application components, a missing DLL, or inadequate permissions.
All tests in the Automatic Runner that were run have finished.

For Functional test sets:

Send email in the event of any test with status "Failed".

The user who should receive the email.

Enter a valid email address or user name. Alternatively, click the To button to select users. The Select Recipients dialog box opens. Select the users or user groups to which you want to send the email.

Note: For Functional test sets, the default e-mail sender is the timeslot creator.

Execution Summary Area

You can instruct ALM to send a summary of test results in an email to specified users when test set execution completes.

User interface elements are described below:

UI Element	Description
Send summary of results after test set execution	Sends a summary report of test results in an email to specified users after test set execution is complete.
	Opens the Select Columns dialog box, enabling you to specify which test run fields are displayed in the execution summary. Available for: Default test sets only.
	Enter a valid email address or user name. Alternatively, click the To button to select users.

UI Element

Description

Send summary of results after test set execution

Sends a summary report of test results in an email to specified users after test set execution is complete.