Message - Unable to find the object that matches the OBJECT_NAME item.

Applies to TestComplete 15.63, last modified on April 23, 2024

TestComplete shows this message if:

  • You are trying to edit a mapped object in the Name Mapping repository and TestComplete cannot find the object with the specified identification properties.

  • During the test run, TestComplete cannot find an object that a test command uses and the Update Name Mapping during test run option is enabled.

The message shows the alias of the problematic object and offers several ways to resolve the issue:

Note: The available options differ depending on the type of the object that was not found.

Italics below indicate object names and variable text.

Launch the "AppName" tested application

(Used only for desktop applications). Sometimes, an object is not found because the application containing this object is not running. If the application is in the project’s list of tested applications, you can select this option to launch the application and try to find the object again.

If needed, TestComplete also changes the application’s identification properties in Name Mapping to match the launched application. For example, it fixes the Index property value.

If the issue occurred during the test run, you also need to modify your test to launch the tested application before performing test actions. To do this, insert the Run TestedApp keyword test operation or the TestedApps.AppName.Run scripting method before the failed test operation.

Open the following URL in browser: URL

(Used only for web applications.) Sometimes, a web page element is not found because the browser is not running or the tested web page is not open in the browser. If so, you can choose this option to open the tested web page in the browser (either the system's default browser, or the browser that was last used during the test run). Once the page has finished loading, TestComplete tries to find the object again.

If the issue occurred during the test run, you also need to modify your test to open this page before performing test actions. For more information, see Launch Web Browsers and Navigate to Web Pages.

Remap page to another page

(Used only for web applications.) Sometimes, a web page is not found because its URL or part of the URL has changed. If the needed web page is currently open in the browser, you can use this option to select it from the list of open pages. After that, TestComplete will update the web page's URL and other identification properties in Name Mapping to match the page you selected.

Point to object on screen

This option opens the Select Object dialog where you can select the needed object in a running application. Before doing this, make sure that the object currently exists in the application (for example, the window or web page with this object is open, the object is visible and so on). After you select the needed object, TestComplete will update its identification properties in Name Mapping with the actual property values.

If the issue occurred during the test run, make sure that the test makes the problematic object available before interacting with it. If needed, insert the appropriate operations before the failed test operation.

Update identification properties of object to match a similar object: ObjectType(Properties)

Sometimes, an object is not found because one or more of its properties have changed since the object was added to Name Mapping. When the issue occurs, TestComplete starts searching for a similar object in the same application whose properties most closely match those specified in Name Mapping. For example, TestComplete looks for objects of the same type but with a different index.

If a similar object is found, TestComplete displays this option to let you update the missing object’s properties in Name Mapping to match the found object. Use this option if you are sure that the found object is the same as the sought-for object.

Edit the identification properties of "object"

Use this option to manually update the object’s identification properties in Name Mapping to match its actual property values. Selecting this option opens the Update Mapping Settings dialog where you can add or remove identification properties or change the property values.

Retry

Try to find the object again. Use this option, for example, if the tested application was slow to open, or if the application was not running and you manually launched it.

Cancel

Stop the troubleshooting and cancel the current action.

If the object was not found during the test run, you may need to modify the test to avoid the issue in the future. For example, increase the object waiting timeout, check object existence before using it and so on.

See Also

Name Mapping
Update Name Mapping

Highlight search results