Object Identification Dialog Box

Relevant for: GUI tests and components

This dialog box enables you to set mandatory and assistive properties, to select the ordinal identifier, and to specify whether you want to enable the Smart Identification mechanism for each test object class.

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 Tools > Object Identification.
Important information
  • Only currently loaded environments are listed in the Environments box.
  • You cannot include the same property in both the mandatory and assistive property lists.
  • Any changes you make in the Object Identification dialog box have no effect on objects already added to existing object repositories. To update the test objects in the object repository, run the test or component in Update Run Mode using the Update test object descriptions option.
  • The learned and Smart description properties of certain classes cannot be configured, for example, VbLabel objects. Such classes are therefore not included in the Test Object classes list for the selected environment.
  • Insight and Text test objects are not available in this dialog box.
  • To quickly jump to a property, click in the list of properties and start typing the property name.

Relevant tasks

Configure object identification for a test object class

User interface elements are described below:

UI Elements

Description

Environment

The list of environments, according to the loaded add-ins. This list may also include additional environments for which you or a third party developed support using Add-in Extensibility.

Test Object classes

The list of the test object classes associated with the selected environment.

Note: In Standard Windows, the user-defined classes are displayed at the bottom of the list.

Mandatory Properties

The list of properties that UFT One always learns as part of the description for test objects of the selected class.

Assistive Properties

The list of additional properties that UFT One can learn for a test object of the selected class to create a unique test object description.

Up and Down arrows. Enable you to set the preferred order for the Assistive Properties list.

When UFT One learns an object, and assistive properties are necessary to create a unique object description, UFT One adds the assistive properties to the description one at a time until it has enough information to create a unique description, according to the order you set in the Assistive Properties list.

Add/Remove

Enables you to add or remove properties for the test object class using the Add/Remove Properties Dialog Box.

Enable Smart Identification

Enables or disables Smart Identification for the selected test object class.

Configure

Opens the Smart description properties Dialog Box, which enables you to specify the properties for UFT One to learn as Smart description properties.

Enabled only when the Enable Smart Identification check box is selected.

Ordinal identifier

The type of ordinal identifier to use when UFT One needs to identify an object with an otherwise identical description. The ordinal identifier enables UFT One to assign a serial order value to each of the otherwise identical objects. For details, see Ordinal identifiers.

Logical Name Definition

Supported for Web test objects

Values taken from property. The property UFT One uses to create the test object's logical name.

Using regex. (Optional) A regular expression that extracts the part of the property to use for the name.

See Configure object identification for a test object class.

User-Defined

Enables you to map an unidentified or custom class to a standard Windows class by opening the Object Mapping Dialog Box.

Note: To enable this option, you must select the Standard Windows environment from the Environment list.

Reset Test Object

The down arrow enables you to select one of the following options:

  • Reset Test Object. Resets the selected test object to the system default. (Default selection)

  • Reset Environment. Resets the settings for all the test objects in the current environment to the system default.

  • Reset All. Resets the settings for all currently loaded environments to the system default.

You can restore the default settings for object identification and the Smart identification settings for all loaded environments, for the current environment only, or for a selected test object, using the Reset Test Object option in the Object Identification Dialog Box.

Only built-in object properties can be reset. When you reset the settings for the standard Windows environment, user-defined objects are also deleted. For details on user-defined objects, see Test object mapping for unidentified or custom classes.

Generate Script

Enables you to generate an automation script that sets the current object identification settings.

When you click the Generate Script button, a Save As dialog box opens, enabling you to specify the name and file system location to store the generated file.

You can use some or all of the script lines from this generated script in an automation script. This can be useful, for example, if you to set the same object identification settings on multiple UFT One computers.

View a sample generated script

For more details, seeUFT One automation scripts and the UFT One Object Repository Automation Reference.