Applies to TestComplete 14.30, last modified on November 21, 2019

In the Name Mapping editor, you view a repository of your tested objects and edit their names used to address them in tests and their identification properties.

The image below shows a sample view of the editor:

Name Mapping editor

Click the image to enlarge it.

To learn more about mapping objects, see About Name Mapping.

To open the editor

Do any of the following:

– or –

  • Select Show Object in Name Mapping Editor from the context menu of the On-Screen Action operation in a keyword test.

– or –

– or –

  • Click the ellipsis button next to an object’s MappedName property in the Object Browser or Object Spy.

About the editor

Mapped objects and aliases

The Aliases tree shows names used to address objects in tests. The Mapped Objects tree shows the object position in the application’s object hierarchy. For more information on these trees, see the Aliases and Mapped Objects section of the About Name Mapping topic.

The Mapped Objects tree is hidden by default. To show it, click the down arrow button in the tree caption.

The Mapped Objects tree provides the following information:

Column Description


The object’s mapped name—the name in the Name Mapping repository. Can be used to address the object from tests.


The object description (optional).

Extended Find

Specifies whether TestComplete will search for the object on all levels down the hierarchy or only on the current level of the hierarchy. See Extended Search.

Conditional Mode

Shows whether the object uses conditional expressions for identification.

This column is read-only. To enable the conditional mode, double-click the object and click Conditional Mode in the resulting dialog. See Conditional Mapping Criteria.

You can customize the column layout. For example, you can reorder or hide columns. For more information, see Arranging Columns, Lines and Panels.


Shows identification properties and their values for the selected object. TestComplete uses them to find the object in the application during the test run. See Basic Mapping Criteria.


Shows the conditional expressions that TestComplete uses to identify the object in the application. To enable the conditional mode, double-click the object in the Aliases or Mapped Object tree and click Conditional Mode in the resulting dialog. To learn more, see Conditional Mapping Criteria.

Required children

Shows a list of child objects that TestComplete can use to identify the object in the application. Select the check box next to the child object you want to use it to identify the object. See Required Children.

Mapped object image

Shows the image of the tested application with the currently selected object highlighted with a red frame.

To re-capture an image, click on the panel toolbar. If the object currently exists and is visible in your tested application, TestComplete will locate it and update the captured image.

To remove an image from the repository, click on the panel toolbar.

Use the zoom slider on the panel toolbar to adjust the image scale. Click to set the image scale to 100%. Click to set the image scale so that it fits the panel borders.

To learn how to configure TestComplete to capture images of mapped objects or how to remove all captured images from the Name Mapping repository, see Store Images.

Using the Name Mapping editor

To learn more about See
Mapping objects Adding Objects to the Name Mapping Repository
Modifying identification criteria Basic Mapping Criteria
Conditional Mapping Criteria
Extended Search
Required Children
Verifying and updating identification criteria Check for Objects Whose Mapping Criteria Require Updates
Searching and replacing in the editor Search and Replace in the Name Mapping Repository
Creating configurations About Name Mapping Configurations
Locating mapped objects Locate Mapped Objects
Toolbar commands Name Mapping Editor - Toolbar
Context menu commands Name Mapping Editor - Context Menu

See Also

Name Mapping
About Name Mapping

Highlight search results