Name Mapping Editor

Applies to TestComplete 14.71, last modified on April 22, 2021

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

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

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.

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 and mobile applications, these are identification properties and their values. For web objects, it can also be identification properties with their values, or it can be XPath expressions or CSS selectors (depending on the project configuration). 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 Conditional Mapping Criteria.

This mapping mode is not available for web objects mapped by using XPath expressions or CSS 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 Required Children.

This mapping mode is not available for web objects mapped by using XPath expressions or CSS 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 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

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