Enabling and Disabling Recovery Scenarios

You can enable or disable specific scenarios and determine when QuickTest activates the recovery scenario mechanism in the Recovery tab of the Application Area Settings dialog box. When you disable a specific scenario, it remains associated with the application area, but is not performed by QuickTest during the run session. You can enable the scenario at a later time.

You can also specify the conditions for which the recovery scenario is to be activated.

To enable/disable specific recovery scenarios:

1. In the General pane of the application area, click the Additional Settings button. The Application Area Settings dialog box opens.
2. Click the Recovery tab.
3. In the Scenarios box, perform one of the following:
• Select the check box to the left of one or more individual scenarios to enable them.
• Clear the check box to the left of one or more individual scenarios to disable them.

To define when the recovery mechanism is activated:

• Select one of the following options in the Activate recovery scenarios box:
• On every step—The recovery mechanism is activated after every step.
• On error—The recovery mechanism is activated only after steps that return an error return value.

Note that the step that returns an error is often not the same as the step that causes the exception event to occur.

For example, a step that selects a check box may cause a pop-up dialog box to open. Although the pop-up dialog box is defined as a trigger event, QuickTest moves to the next step because it successfully performed the check box selection step. The next several steps could potentially perform checkpoints, functions or other conditional or looping statements that do not require performing operations on your application. It may only be ten statements later that a step instructs QuickTest to perform an operation on the application that it cannot perform due to the pop-up dialog box. In this case, it is this tenth step that returns an error and triggers the recovery mechanism to close the dialog box. After the recovery operation is completed, the current step is this tenth step, and not the step that caused the trigger event.

• Never—The recovery mechanism is disabled.

Note: Choosing On every step may result in slower performance during the run session.

How to remove Recovery Scenarios

In QuickTest, you can remove the association between a specific scenario and an application area using the Application Area Settings dialog box. After you remove a scenario from an application area, the scenario itself still exists, but QuickTest will no longer perform the scenario during a run session.

To remove a recovery scenario from your application area:

1. In the General pane of the application area, click the Additional Settings button. The Application Area Settings dialog box opens.
2. Click the Recovery tab.
3. In the Scenarios box, select the scenario you want to remove.
4. Click the Remove button. The selected scenario is no longer associated with the application area.

Setting Recovery Scenario Priorities

You can specify the order in which QuickTest performs associated scenarios during a run session. When a trigger event occurs, QuickTest checks for applicable recovery scenarios in the order in which they are displayed in the Recovery tab of the Application Area Settings dialog box.

To set recovery scenario priorities:

1. In the General pane of the application area, click the Additional Settings button. The Application Area Settings dialog box opens.
2. Click the Recovery tab.
3. In the Scenarios box, select the scenario whose priority you want to change.
4. Click the Up or Down button. The selected scenario's priority changes according to your selection.
5. Repeat steps 3-4 for each scenario whose priority you want to change.

Viewing Recovery Scenario Properties

You can view properties for any recovery scenario in QuickTest associated with your application area.

Note: You modify recovery scenario settings from the Recovery Scenario Manager dialog box.

To view recovery scenario properties:

1. In the General pane of the application area, click the Additional Settings button. The Application Area Settings dialog box opens.
2. Click the Recovery tab.
3. In the Scenarios box, select the recovery scenario whose properties you want to view.
4. Click the Properties button. Alternatively, you can double-click a scenario in the Scenarios box. The Recovery Scenario Properties dialog box opens, displaying read-only information regarding the settings for the selected scenario