Test object descriptions

Relevant for: GUI tests and components

For each test object class, UFT learns a set of description properties when it learns an object, and selects a sub-set of these properties to serve as a unique object description. UFT then uses this description to identify the object when it runs a test or component.

When the test or component runs, UFT searches for the object that matches the description it learned. If it cannot find any object that matches the description, or if it finds more than one object that matches, UFT may use the Smart Identification mechanism to identify the object.

You can configure the mandatory, assistive, and ordinal identifier properties that UFT uses to learn the descriptions of the objects in your application, and you can enable and configure the Smart Identification mechanism. For details, see Configuring Object Identification.

Example: By default, UFT learns the image type (such as plain image or image button), the html tag, and the Alt text of each Web image it learns.

If these three mandatory property values are not sufficient to uniquely identify the object within its parent object, UFT adds some assistive properties and/or an ordinal identifier to create a unique description.

When using Insight, UFT learns objects based on their appearance instead of retrieving properties from the objects. For the description property, UFT stores an image of the object, which can be used later to identify the object. If parts of the object do not always look the same, you can instruct UFT to ignore those areas when it uses the image to identify the object.

If necessary, UFT can also use an ordinal identifier to create a unique description for the object. Other aspects of object configuration, such as mandatory and assistive properties, and smart identification, are not relevant for Insight test objects.

After UFT creates a description for an Insight test object, you can add visual relation identifiers to improve identification of the object. If necessary, you can also add the similarity description property to the test object description. This property is a percentage that specifies how similar a control in the application has to be to the test object image for it to be considered a match.