Active Screen Pane

Relevant for: GUI tests and scripted GUI components

The Active Screen pane enables you to view snapshots of your application as it appeared during a step in a recording session.

Use the Active Screen when you want to view the application state during a particular step in the test, or if you need to add steps, checkpoints, or output values after editing and running the test.

The Active Screen enables you to add these additional steps without the need to have the application open.

View objects, or insert steps, output values, and checkpoints, by right-clicking the object in the Active Screen and selecting the relevant option. To insert steps, select Step Generator.

To access
  1. Do one of the following:

    • Ensure that a GUI test, action, or component is in focus in the document pane.

    • In the solution explorer, select a GUI test or component node, or one of its child nodes.

  2. Select View > Active Screen.

Important information

When you are recording on an MDI (Multiple Document Interface) application, the Active Screen does not capture information for non-active child frames.

If you are testing an application using a UFT add-in, see the Unified Functional Testing Add-ins Guide to determine whether special Active Screen screen capture options exist for that environment.

Saving Active Screen content

Save the content of the Active Screen with your test if you want to edit the saved test directly from the Active Screen.

If you need to conserve disk space after you finish editing the test, and you plan to use the test only for test runs you can save the test again without the content of the Active Screen.

Back to top

The Active Screen and Insight

  • For steps that contain Insight test objects, the Active Screen provides only a visual reference to the application and the test object's context. The Active Screen displays the Insight test object highlighted within a screen capture of its parent object.

    You cannot use the Active Screen of an Insight step to view object properties, to insert checkpoints or output values, or to add objects to the object repository.

  • The OCR text recognition mechanism is not supported for objects in the Active Screen.

  • When creating objects, checkpoints, or output values from the Active Screen for objects in a modal dialog box within a Web browser, they are created under the Browser object and not under the Window object.

    Workaround: Add the object directly from the application, for example by using the Add Objects to Local button in the Object Repository window.

Back to top

The Active Screen and Web-based applications

The Active Screen displays the captured HTML content using an Internet Explorer browser control, even if you ran your steps on another browser.

Additionally, depending on your settings, the Active Screen may capture your HTML page before or after various scripts ran on the page.

Some pages may look slightly different in the Active Screen than they appeared during your record or update run session, and some property values may be different or may not be available.

UFT stores the URL path to images and other resources on the page, rather than downloading and storing the images with your test. Therefore, you may need to provide login information to view password-protected resources in the Active Screen.

Back to top

Stop saving Active Screen information

When you stop saving Active Screen information, Active Screen files are no longer saved, and you can no longer edit your test from the Active Screen.

  1. Open the relevant test.

  2. Select File > Save As and clear the Save Active Screen files check box.

  3. Click Save to apply your changes.

Back to top

Update a single Active Screen capture

  1. Make sure that your application is displaying the window or page that you want to use to replace what is currently displayed in the Active Screen pane.

  2. In the Keyword View, click a step that you want to change. The window or page is displayed in the Active Screen pane.

  3. Select Tools > Change Active Screen. The UFT window is hidden and the mouse pointer becomes a pointing hand.

  4. Click the window or page displayed in your application.

  5. When a message prompts you to change your current Active Screen display, click Yes.

Back to top

See also:

Active Screen Pane (Options Dialog Box > GUI Testing Tab)