Recovery Pane (Test/Business Component Settings Dialog Box / Application Area - Additional Settings Pane)

Relevant for: GUI tests and components

This pane displays a list of all recovery scenarios associated with the current test or application area. Recovery scenario settings enable you to specify how a test or business component recovers from unexpected events and errors during a run session.

This pane also enables you to associate additional recovery scenarios with the test or application area, create recovery scenarios, remove scenarios from the test or application area, change the order in which they are applied to the run session, and view a read-only summary of each scenario.

For tests: You can also specify the default list of scenarios to associate with all new tests.

For components: This pane displays the recovery information defined for the application area, in read-only mode.

To access

Do one of the following:

  • With a test, action, or component in focus, select File > Settings > Recovery node.

  • Open the application area and select Additional Settings > Recovery in the sidebar.
Important information

For tests:

  • The default recovery scenarios provided with UFT One are installed in your UFT One installation folder. The paths specifying the default recovery scenarios in the Recovery pane use an environment variable (%ProductDir%) in the file path. This enables UFT One to locate these recovery scenarios when tests associated with them are run on different computers or by different ADM products. Do not modify the file paths of these default recovery scenarios or attempt to use the environment variable for any other purpose.

  • You can also associate, remove, enable, disable, prioritize, and view the properties of the recovery scenarios associated with your test in the Solution Explorer.

For components:

  • The options in this pane are read-only. You define the recovery scenario settings for a component in its associated application area.
  • UFT One provides you with a sample recovery file for Web-related testing. The file is located in the Test Resources module of your ALM project under Resources\BPT Resources\Recovery Scenarios\DefaultWeb.qrs.
See also

Recovery scenarios

This pane includes the following key elements:

UI Element

Description

Opens the Add Recovery Scenario dialog box, which enables you to associate one or more recovery scenarios with the test or application area. For details, see Add Recovery Scenario Dialog Box.

Removes the selected recovery scenario from the test or application area.

Moves the selected scenario up in the list, giving it a higher priority.

Moves the selected scenario down in the list, giving it a lower priority.

Displays summary properties for the selected recovery scenario in read-only format. For details, see Recovery Scenario Properties Dialog Box.

Scenario Name

The name of each recovery scenario associated with your test or application area. You can add, delete, and prioritize the scenarios in the list.

File

The file path for each recovery scenario associated with your test or application area. You can edit the recovery scenario file path by clicking the path once to highlight it, and then clicking it again to enter edit mode. For details on scenario type icons, see Scenario Type Icons.

For example, you may want to modify an absolute file path to be a relative file path.

If you modify a recovery scenario file path, ensure that the recovery scenario exists in the new path location before running your test or component.

For tests:

  • If your recovery files are stored in the file system and you want other users or products to be able to run this test on other computers, you should set the recovery file path as a relative path. (Click the path once to highlight it, and then click it again to enter edit mode.) Any users who want to run this test should then specify the drive letter and folder in which UFT One should search for the relative path in the Folders pane of the Options dialog box (Tools > Options > GUI Testing tab > Folders node). For details, see Folders Pane (Options Dialog Box > GUI Testing Tab) and Relative paths for test resources.
  • If you are working with the Resources and Dependencies model with Quality Center or ALM, you should store your recovery files in the Test Resources module and specify an absolute Quality Center or ALM path in the Folders pane.

UI Elements

Description

Scenario description

Displays the textual description of the scenario selected in the Scenarios box. You can select or clear the check box next to each scenario to enable or disable it for the current test or application area.

Activate recovery scenarios

Indicates how often UFT One should activate the recovery mechanism:

  • 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.

  • Never. The recovery mechanism is disabled.

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

Set as Default
(tests only)

Sets the current list of recovery scenario files as the default list to be associated with new tests.

Note: The Set as Default option is available for tests only. It is enabled when the setting for this test is different from the default for all tests.

Note: If the file containing the recovery scenarios is moved or renamed, UFT One will not be able to locate it. The recovery scenario file will be displayed in the Errors pane when new actions or tests are created. For details on resolving missing resources, see Errors Pane.

Icon

Description

Indicates that the recovery scenario is triggered by a specific pop-up window in an open application during the run session.

Indicates that the recovery scenario is triggered when the property values of an object in an application match specified values.

Indicates that the recovery scenario is triggered when a step in the test or component does not run successfully.

Indicates that the recovery scenario is triggered when a specified application fails during the run session.

Indicates that the recovery scenario is no longer available for the test or component—possibly because the recovery file has been renamed or moved, or can no longer be accessed by UFT One. When an associated recovery file is not available during a run session, a message is displayed in the run results.