Name Mapping Options Dialog

Applies to TestExecute 14.72, last modified on January 12, 2021

The options in this dialog affect the name mapping. To call the Name Mapping Options dialog, right-click the TestExecute icon () in the notification area (tray), select Options from the ensuing context menu and then select Engines | Name Mapping from the tree displayed on the left side of the resulting Options dialog.

You can change the following options:

  • Search for visible objects first - This option tells TestExecute to prefer visible over invisible objects when searching for mapped objects. If it is enabled (by default), TestExecute first tries to find a matching object that is also visible. If a visible object is not found within the search timeout (Auto-wait timeout or the timeout used in WaitAliasChild), TestExecute picks any invisible object that matches the mapping criteria.

    If this option is disabled, TestExecute always picks any matching object, whether visible or not.


    • Disabling this option can reduce the object search time in tests that deal with many invisible objects.

    • This option has no effect for objects whose mapping criteria explicitly include the Visible property.

    • This option has no effect on self-healing tests. When searching for an object to use instead of a missing object, TestExecute will not prefer visible objects over invisible ones.

    • This option has no effect for web objects mapped by using XPath expressions and CSS selectors.

    • If you upgraded from TestExecute 10 and found that your tests became slower, disable this option.

  • Enable Self-Healing mode - If this option is enabled (by default) and TestExecute fails to find a tested object during the test run, TestExecute will try to find a similar object and use it instead of the missing object to continue running the test. After the test run is over, TestExecute will post a warning message to the test log suggesting to update the missing object’s mapping criteria to match the replacement object. Open your project in TestComplete and update the object’s mapping criteria as suggested.

    If the option is disabled, the test will report the “Object Does Not Exist” error.

    Note: This option is ignored if your TestComplete project is configured to locate web objects by XPath expressions or CSS selectors. In this case, TestExecute will only report the error. It will not search for a similar object.

  • Collect usage statistics - If this option is enabled, TestExecute collects information on whether Name Mapping items are used in tests or not.

    You can then use this data to find and remove unused objects to clear the Name Mapping repository. To learn how to do it, see TestComplete documentation.

    In the Statistics file text box, you specify a file that will store the collected data. You can type the file path or click the ellipsis button and browse for the file in the Open dialog. By default, the file name is like C:\Users\Public\Documents\NameMappingUsage.stat. You may need to specify some other file located in a shared folder.

    To clear the collected data, click Clear Statistics.

See Also

TestExecute Options

Highlight search results