Insight Pane (Options Dialog Box > GUI Testing Tab)

Relevant for: GUI tests and components

This pane enables you to define options that customize how UFT handles Insight test objects when creating test object, and during record and run sessions.

To access

Select Tools > Options > GUI Testing tab > Insight node.

Important information
  • The Restore Factory Defaults button resets all Options dialog box options to their defaults.
  • UFT captures additional snapshots of the application together with the Insight test objects that it creates. You can use these additional snapshots to adjust the test object images that identify the controls.

    The number of snapshots saved with a test object, as well as the test object image margin, affect the disk space required by your object repository. These settings can also affect UFT performance when recording and running Insight steps.

    • Changes made in this pane affect only new snapshots and not previously saved ones.
    • In the object repository, you can delete all of the snapshots stored with the Insight test objects after you finalize the test object images and verify that they enable correct object identification in all relevant scenarios.
Relevant tasks
See also

Identifying objects using Insight

User interface elements are described below:

UI Element


When recording a test object
Save the clicked coordinates as the test object's ClickPoint

Instructs UFT to define the ClickPoint of each Insight test object added to the object repository during a recording session, according to the location that the user clicks. The coordinates of the first click on the object are used.

  • You can modify a test object's ClickPoint manually in the object repository.

    If this option is cleared, the ClickPoint for objects learned by recording is set to Center.

  • Modifying this option does not affect test objects previously added to the object repository. It affects only objects learned in subsequent recording sessions.

When running a step
Display mouse operations

Instructs UFT to show mouse drag operations and clicks when running steps on Insight test objects.

When editing
Show test object image in steps

Instructs UFT to display Insight test object images in steps in the Editor.

If cleared, UFT displays the test object names instead.

Display Select Learn Mode dialog box

Instructs UFT to open the Select Learn Mode Dialog Box when you click the Add Insight Object to Local or Add Insight Object button to add an Insight object to an object repository.

When taking snapshots
Limit test object image margin in snapshot

Instructs UFT to limit the snapshot size when creating a new Insight test object by including only a limited area of the screen around the control in the snapshot. Specify the margin size in the Maximum pixels around the image box.

If cleared, UFT includes the whole screen in the snapshot.

Note: Relevant when adding a new Insight test object (recording or learning).

Maximum pixels around the image

The maximum size of the area around the control to include in the snapshot. UFT includes up to the specified number of pixels on all sides of the control.

Maximum value: 1000.

Note: Available only when the Limit test object image margin in snapshot option is selected.

Maximum number of snapshots to save when recording a test object

Instructs UFT not to save more than the specified number of snapshots when recording a test object.

Separately specify the number of snapshots to save Before the selected image and After the selected image.

UFT selects the image that seems most appropriate to use for the object description, and then saves additional snapshots taken during the recording session, before or after the selected image, as available.

The total number of snapshots saved may include up to the maximum number of snapshots you specified to save before and after the selected image, and one more snapshot for the test object image itself.

Maximum value: 10 before and 10 after.

Note: Relevant during a recording session.