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:
Click the image to enlarge it.
To learn more about mapping objects, see About Name Mapping.
Note: Mapped objects are not supported in cross-platform web tests. To learn how to locate objects in such tests, see Addressing Objects in Cross-Platform Web Tests.
To open the editor
Do any of the following:
-
Double-click the NameMapping item in the Project Explorer.
– or –
-
Select Show Object in Name Mapping Editor from the context menu of the On-Screen Action operation in a keyword test.
– or –
-
Select Show Object in Name Mapping Editor from the context menu of an object in the Object Browser, Object Spy or in a Visualizer frame.
– or –
-
Click the ellipsis button next to an object’s
MappedNameproperty 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 |
|---|---|
|
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. |
|
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.
Properties
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.
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.
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 |