Custom Active Screen Capture Settings Dialog Box

Relevant for: GUI tests only

This dialog box enables you to customize how UFT captures and saves Active Screen information.

When you apply custom Active Screen settings, you override the capture-level setting in the Active Screen pane with all of the settings in the Custom Active Screen Capture Settings dialog box.

To access

Select Tools > Options > GUI Testing tab > Active Screen node > Custom Level.

Important information

  • The Custom Active Screen Capture Settings dialog box may also contain options applicable to any UFT add-ins installed on your computer.
  • The default settings in the Custom Active Screen Capture Settings dialog box do not reflect the selected capture-level setting in the Active Screen pane of the Options dialog box. If you want to customize only specific settings, use the Reset to option to ensure that all other settings are using the capture-level setting you prefer and then modify the specific settings you need.

Related tasks

By selecting a Captured files storage option, you can specify the type of compression UFT uses for storing captured Active Screen information:

  • Simple. Instructs UFT to save Active Screen captures in standard uncompressed file formats (for example, .html and .png).
  • Compressed. Instructs UFT to save Active Screen captures in a compressed (zipped) file format. Using this option saves disk space, but it may affect the time it takes to load images in the Active Screen. This is the default option.

The Custom Active Screen Capture Settings dialog box enables you to customize how UFT captures and saves Active Screen information.

By selecting a Capture level option, you can specify which properties are captured for each object in an application when it is captured for the Active Screen:

Application type Capture Levels
Java Applications or Applets

The following Capture level options are available for Java applications or Java applets:

  • Complete. Instructs UFT to save all description properties of all objects in the application or applet's open window/dialog box in the Active Screen of each step.
  • Partial. (Default) Instructs UFT to save all description properties of all objects in the application or applet's open window/dialog box in the Active Screen of the first step performed in that window, plus all properties of the recorded object only, in subsequent steps in the same window.
  • Minimum. Instructs UFT to save all description properties for the recorded object plus all description properties for the parent objects in the recording hierarchy.
  • None. Disables capture of Active Screen files for Java applications or Java applets.

When the Complete or Minimum capture level is selected, the following setting in the Custom Active Screen Capture Settings dialog box is also relevant for Java applications or Java applets:

Disable capture of the following objects. Prevents UFT from capturing the data of steps performed on other objects for the selected test object types in the Active Screen. These objects are visible in the Active Screen as images only.

By default, JavaObject and JavaMenu are selected (meaning that description properties are not captured for these objects).

If you record on a specific test object, its description properties are captured even if the Disable capture of the following objects option is selected.

SAP GUI for Windows Applications

The following Capture level options are available for SAP GUI for Windows applications:

  • Complete. Instructs UFT to save the property values of all objects in the application's open window/dialog box in the Active Screen of each step.

    This option makes it possible for you to insert checkpoints and perform other operations on any object in the window/dialog box from the Active Screen of any step. However, it may result in longer recording times and require more disk space.

    The properties for inner objects of some container objects (such as table cells or tree nodes) are not captured in the Active Screen. Use the appropriate SAPGuiTable or SAPGuiTree methods to access information for these objects.

  • Partial. (Default) Instructs UFT to save properties of the recorded object and of its parent in the Active Screen of each step.

    This option enables speedy recording and requires relatively little disk space. However, you can insert checkpoints and perform other operations only on the recorded object and on the window/dialog box itself. You cannot perform operations on the other objects displayed in the Active Screen.

  • None. Disables the capture of Active Screen files for SAP GUI for Windows applications.

    This option allows extremely fast recording and requires only minimum disk space. However, you cannot perform post-recording test editing (such as inserting checkpoints, output values, and so forth) from the Active Screen.

    Notes:

    • The property values of the objects in the Active Screen reflect the values at the time that the steps are added to your test (when information is sent to the SAP server). These values may potentially be different from the property values at the time that a particular step is performed
    • The Active Screen captures only the visible part of the SAP GUI for Windows applications window at the time that the step is added to the test.
Oracle Applications

The following Capture level options are available for Oracle applications:

  • Complete. Instructs UFT to save all description properties of all objects in the application's open window/dialog box in the Active Screen of each step.
  • Partial. (Default) Instructs UFT to save all description properties of all objects in the application's open window/dialog box in the Active Screen of the first step performed in that window, plus all description properties of the recorded object only, in subsequent steps in the same window.
  • Minimum. Instructs UFT to save all description properties for the recorded object plus all description properties for the parent objects in the recording hierarchy.
  • None. Disables capture of Active Screen files for Oracle applications.
Windows Applications

The following Capture level options are available for Windows applications.

  • Complete. Instructs UFT to save all properties of all objects in the application's open window/dialog box in the Active Screen of each step.

    This option makes it possible for you to insert checkpoints and perform other operations on any object in the window/dialog box, from the Active Screen for any step.

  • Partial. (Default) Instructs UFT to save all properties of all objects in the application's open window/dialog box in the Active Screen of the first step performed in an application's window, plus all properties of the recorded object in subsequent steps in the same window.

    This option makes it possible for you to insert checkpoints and perform other operations on any object displayed in the Active Screen, while conserving recording time and disk space. Note that with this option the Active Screen information may not be fully updated for subsequent steps.

  • Minimum. Instructs UFT to save properties only for the recorded object and its parent in the Active Screen of each step.

    This option enables speedy recording and requires relatively little disk space. However, you can insert checkpoints and perform other operations only on the recorded object and on the window/dialog box itself. You cannot perform operations on the other objects displayed in the Active Screen.

  • None. Disables capture of Active Screen files for Windows applications.

    This option allows extremely fast recording and requires only a minimum of disk space. However, you cannot perform post-recording test editing from the Active Screen.

Terminal Emulator Applications

The following Capture level options are available for applications run on terminal emulators:

  • Complete. Instructs UFT to save all properties of all objects in the application's open window/dialog box in the Active Screen of each step.

    This option makes it possible for you to insert checkpoints and perform other operations on any object in the window/dialog box, from the Active Screen for any step.

  • None. Disables capture of Active Screen files for Terminal Emulator applications.
Web

You can specify whether UFT captures Web pages for the Active Screen.

  • Disable Active Screen capture. Disables the screen capture of all steps in the Active Screen.

    If you do not select this option, you can also delete Active Screen information after you have finished editing your test by selecting Save As, and clearing the Save Active Screen files check box. For details, see Open/New/Save/ Add Existing <Document>/<Resource> Dialog Box.

  • Capture original HTML source. Captures the HTML source of Web pages as they appear originally, before any scripts are run. Deselecting this option instructs UFT to capture the HTML source of Web pages after any dynamic changes have been made to the HTML source (for example, by scripts running automatically when the page is loaded).