Name Mapping Editor

Applies to TestComplete 15.62, last modified on March 19, 2024

In the Name Mapping editor, you view the 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 Name Mapping.

To open the editor

– 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 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

Name

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

Description

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 Name Mapping - Extended Search.

Not applicable for web objects mapped by using XPath expressions or CSS selectors. For such objects, the Extended Find column is hidden.

To make it visible, right-click anywhere within the tree and then click Field Chooser. Drag the Extended Find column from the Customization dialog to the tree.

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 Name Mapping - Conditional Mapping Criteria.

Not applicable for web objects mapped by using XPath expressions or CSS selectors.

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

Properties

Shows mapping criteria for the selected object. For desktop applications and mobile applications connected to TestComplete locally (legacy approach), these are identification properties and their values. For web applications and mobile applications running in device clouds, these are search expressions called selectors. See the following topics:

Condition

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 Name Mapping - Conditional Mapping Criteria.

This mapping mode is not available for objects mapped by using selectors.

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 Name Mapping - Required Children.

This mapping mode is not available for objects mapped by using selectors.

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 and 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

Related Topics of Interest

Name Mapping

Describes the Name Mapping repository and explains how automated tests use it.

Search and Replace in the Name Mapping Repository

Explains how you can quickly find and replace mapped object names, aliases, identification property names and property values.

See Also

Name Mapping

Highlight search results