Manage recovery scenarios

Relevant for: GUI tests and components

This task describes how to perform different recovery scenario management and association operations using the Recovery pane in the Test Settings dialog box or an application area's Additional Settings pane.

Create a new recovery scenario operation

  1. In the Recovery Scenario Manager Dialog Box, click the New Scenario button . The Recovery Scenario Wizard opens.

  2. Follow the on-screen instructions. The wizard includes the following pages (pages that are in parentheses open according to the option selected in the previous page):

    Mandatory Page Optional Pages (dependent on the selections in other pages)
    Select Trigger Event Page Specify Pop-up Window Conditions Page
    Recovery Operations Page Select Object Page
    Recovery Operation Page Set Object Properties and Values Page
    Post-Recovery Test Run Options Page Select Test Run Error Page
    Name and Description Page Select Processes Page
    Completing the Recovery Scenario Wizard Page Recovery Operation - Click Button or Press Key Page
      Recovery Operation - Close Processes Page
      Recovery Operation - Function Call Screen

Back to top

Associate a recovery scenario in the Test Settings

  1. In the Recovery Pane (Test/Business Component Settings Dialog Box / Application Area - Additional Settings Pane), click the Add button .

  2. In the Add Recovery Scenario Dialog Box, click the Browse button and navigate to the recovery scenario file.

    A list of recovery scenario operations contained in this file opens.

  3. In the list of recovery scenarios, select a recovery scenario and click Add Scenario.

    The recovery scenario is displayed in the Recovery pane of the Test Settings dialog box and is added under the Recovery Scenarios node found under your GUI test in the Solution Explorer.

Back to top

Associate a recovery scenario in the Solution Explorer

  1. In the Solution Explorer, do one of the following:

    1. Right-click a GUI test node and select Add > Associate Recovery Scenario.

    2. Right-click the Recovery Scenarios Node and select Associate Recovery Scenario.

  2. In the Add Recovery Scenario dialog box, click the Browse button and navigate to the recovery scenario file.

    A list of recovery scenario operations contained in this file opens.

  3. In the list of recovery scenarios, select a recovery scenario and click Add Scenario.

    The recovery scenario is added under the Recovery Scenarios node, found under your GUI test in the Solution Explorer.

Back to top

Associate a recovery scenario with a component/application area

  1. In Recovery pane of the Additional Settings pane of your application area, click the Add button .

  2. In the Add Recovery Scenario dialog box, click the Browse button and navigate to the recovery scenario file.

    A list of recovery scenario operations contained in this file opens.

  3. In the list of recovery scenarios, select a recovery scenario and click Add Scenario.

    The recovery scenario is displayed in the Recovery pane in the Additional Settings pane of your application area and is associated with the component through its application area or is associated with the application area.

Back to top

Enable/disable specific recovery scenarios

Do one of the following:

  • In the Scenarios box of the Recovery Pane of the Test Settings dialog 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.

  • In the Solution Explorer, right-click the scenario you want to disable and select Disable Recovery Scenario.

Back to top

Specify the path of an associated recovery scenario using environment variables

For each recovery scenario associated with a GUI test or component, you can use environment variables to specify the path of the recovery scenario in the Test Settings > Recovery pane or Business Component Settings > Recovery pane.

  • If you associate a recovery scenario with a GUI test using a relative path, you can use built-in or user-defined environment variables in the path of the recovery scenario. And this recovery scenario can be triggered when running the test from UFT One or ALM.

  • If you associate a recovery scenario with a component using a relative path, you can use only built-in environment variables in the path of the recovery scenario. And this recovery scenario can only be triggered when running the component from UFT One.

Back to top

Using relative paths in Recovery Scenario associations

When you associate a recovery scenario with a GUI test or component, UFT One prompts you to associate the recovery scenario using a relative path. This is helpful if you want other users or products to be able to run this scenario on other computers. The relative path is saved in the Folders pane of the Options dialog box (Tools > Options > GUI Testing tab > Folders node)

Back to top

Set default recovery scenario settings

Click the Set as Default button in the Recovery pane of the Test Settings dialog box to set the current list of recovery scenarios to be the default scenarios for all new tests. Any future changes you make to the current recovery scenario list only affect the current test, and do not change the default list that you defined.

Back to top