Update Recognition Attributes Dialog

Applies to TestComplete 15.61, last modified on February 27, 2024

To find objects with which your tests interact, TestComplete uses various recognition criteria that uniquely identify objects in the application. For example, in desktop applications, it can be an object type, class name, and caption. In web applications, it can be one or several XPath expressions and CSS selectors. If, during the test run, the object’s actual properties differ from the properties your project’s Name Mapping repository specifies, TestComplete will not be able to find the needed object, and your test will fail.

The Update Recognition Attributes dialog helps you update the criteria used to find a tested object in an application.

When the dialog is available

Important: The dialog is available only if the Enable Self-Healing mode option is disabled in TestComplete. Otherwise, TestComplete will update the identification properties automatically, and the dialog will not be available.

  1. During the test run, to find a tested object in an application, TestComplete compares its criteria specified in the Name Mapping repository with the actual properties in the tested application.

  2. If the tested application has changed and TestComplete cannot find the object, it will do the following:

    1. Analyze the tested application and search for similar objects:

      1. It will check all the objects on the same level of the hierarchy where the missing object resides. In web applications, it will also check all the objects down the hierarchy levels.

      2. It will check whether the mapping criteria of the missing object have been changed. TestComplete will search for similar objects among objects of the same class and type as the missing one.

      1. Among all similar objects that TestComplete will find, it will select the one closest to the missing object by comparing them to the missing object’s screenshot that the Name Mapping repository stores (if any).

    2. If a similar object is found, TestComplete will post the “The object does not exist” error message to the test log and add the Intelligent Fix button to the Details panel of the error message:

      Call the Update Recognition Attributes dialog

      Click the image to enlarge it.

  3. Click the button to call the dialog.

How to update recognition attributes

The Update Recognition Attributes dialog shows the image of your tested application with the found similar object highlighted:

Update recognition attributes of the missing object to ma

Click the image to enlarge it.

Look at your tested application and check whether the found object is the needed missing object. The dialog will also show a list of identification criteria of the missing object with matching criteria of the found object. Compare them.

Note: If you use a dynamic property with variable numeric parts (for example, a build number) as a recognition attribute, Intelligent Fix will detect it and suggest replacing numerical parts with wildcards.

To update the criteria to match the found replacement object, click Update.

See Also

Handling the 'Object Does Not Exist' Error
Name Mapping

Highlight search results