[Expand]General Information/viewarticle/75299/
 [Expand]Using Help System/viewarticle/68624/
 [Expand]Getting Started Tutorial/viewarticle/73031/
 [Collapse]Using TestComplete/viewarticle/70372/
  [Expand]TestComplete User Interface, Projects and Settings/viewarticle/74317/
  [Collapse]Creating, Recording and Running Tests/viewarticle/74604/
   [Collapse]Naming Objects/viewarticle/69317/
    [Expand]Default Object Naming/viewarticle/69990/
    [Collapse]Name Mapping/viewarticle/73726/
      About Name Mapping/viewarticle/68642/
     [Expand]Name Mapping Editor/viewarticle/70416/
     [Collapse]Managing Mapped Objects/viewarticle/68717/
      [Expand]Adding Objects to the Name Mapping Repository/viewarticle/67885/
      [Collapse]Modifying Mapping Criteria/viewarticle/70319/
        Adding and Removing Identification Properties/viewarticle/75986/
        Changing Identification Property Values/viewarticle/68079/
        Using Conditional Mapping Criteria/viewarticle/70410/
        Specifying Required Child Objects/viewarticle/72258/
        Using Extended Search Criteria for Mapped Object Identification/viewarticle/71092/
       Saving Information on Methods and Properties of Mapped Objects/viewarticle/69049/
       Renaming Objects in the Name Mapping Repository/viewarticle/72104/
      [Expand]Deleting Objects From the Name Mapping Repository/viewarticle/75319/
       Changing the Mapped Objects' Hierarchy/viewarticle/74190/
       Specifying a Description for Mapped Objects/viewarticle/73083/
      [Expand]Locating Mapped Objects/viewarticle/68934/
       Merging Name Mapping Files/viewarticle/68769/
       Updating Name Mapping During Test Run and at Design Time/viewarticle/69739/
      Working With Mapped Objects in Tests/viewarticle/74425/
     [Expand]Name Mapping Templates/viewarticle/75254/
     [Expand]Name Mapping Configurations/viewarticle/70417/
      Name Mapping Auto-Correction/viewarticle/71336/
   [Expand]Creating Tests/viewarticle/69687/
   [Expand]Managing Tested Applications/viewarticle/72027/
   [Expand]Checkpoints and Stores/viewarticle/71813/
   [Expand]Running Tests/viewarticle/68992/
   [Expand]Handling Playback Errors/viewarticle/71027/
   [Expand]Keyword Testing/viewarticle/68860/
   [Expand]Test Visualizer/viewarticle/74945/
   [Expand]Exploring Applications/viewarticle/73626/
   [Expand]Debugging Tests/viewarticle/68755/
  [Expand]Test Results/viewarticle/74393/
  [Expand]Enhancing Tests/viewarticle/69325/
  [Expand]Teamwork and Integration Into QA Process/viewarticle/71012/
  [Expand]Extending TestComplete/viewarticle/72159/
  [Expand]Automating TestComplete/viewarticle/74580/
  [Expand]Best Practices/viewarticle/70336/
 [Expand]Testing Types/viewarticle/71476/
 [Expand]Applications Testing/viewarticle/69187/
 [Expand]Working With Application Objects and Controls/viewarticle/72879/
 [Expand]Samples and Tutorials/viewarticle/71571/
 [Expand]Other Tools That Help You Test Better/viewarticle/68606/
 [Expand]TestComplete Licensing Guide/viewarticle/74980/
Updated: 9/22/2015 Applies To: TestComplete 11 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent
Modifying Mapping Criteria

Using Extended Search Criteria in Name Mapping Repository

Name Mapping has an object-specific option, Extended Find, that makes TestComplete search for an object on all levels down the application’s object hierarchy. Extended Find is typically used when an object has dynamic parent objects, and these parent objects are not included in Name Mapping.

If the Use extended find when possible option is enabled, TestComplete maps web objects by using the Extended Find feature. For objects of other application types, you can configure the Extended Find option manually as explained in this topic.

How to Enable Extended Search

First, add the Extended Find column to the Name Mapping editor:

  • Right-click somewhere within the Mapped Objects pane and select Field Chooser from the context menu. This will open the Customize window with the list of the available columns.

  • Drag the Extended Find column to the Mapped Objects pane.

  • Close the Customize window.

To enable Extended Find for an object, do the following:

  • In the Mapped Objects tree, drag the object to the closest non-dynamic parent object.

    Dragging a mapped object up the object tree
  • Select the Extended Find check box for the object.

  • If a confirmation dialog appears, click Yes.

  • In the Aliases tree, drag the object’s alias to the matching parent alias (like you did in the Mapped Objects tree).

  • Delete unneeded intermediate objects from the Mapped Objects and Aliases trees. To delete an object, right-click it and select Delete from the context menu.

Remember to update the object names in your tests after you change the Name Mapping structure.

When to Use Extended Search

Dynamic Object Hierarchy

In dynamic applications, the same object can be at different positions in the object hierarchy in different application states.

An object moving through the object hierarchy
An object moving through the object hierarchy

To correctly identify the “moving” objects, you need to ignore their dynamic parent objects. To do this, map a "moving" object (in the example above it is Panel("Dock1")) to the closest non-dynamic parent object (Table(0) or Panel("BackgroundZone")) using Extended Find.

Non-Unique Parent Objects

Some objects have no unique properties. For example, the DIV and TABLE elements used to lay out web pages are often identified only by indexes, and these indexes can be dynamic.

You can exclude non-unique parent objects from Name Mapping to make child object identification more robust. You need to turn on Extended Find for each object whose direct parent object is not included in Name Mapping.

Too Long Aliases

Large applications can have a highly nested object hierarchy. As a result, the object aliases in the default generated Name Mapping repository can be very long. This can be an issue if you create tests manually.

You can use the Extended Find option to exclude intermediate objects from Name Mapping and shorten the aliases.

Name Mapping for a web application without Extended Find (on the left) and with Extended Find (on the right)
Name Mapping for a web application without Extended Find (on the left) and with Extended Find (on the right)

In the example above, the full alias of the linkLogout object is as follows (the differences are marked with blue):

  • Without Extended Find:

  • With Extended Find:



  • Extended Find searches down the entire object hierarchy. The search is not depth-limited.
  • Searching for objects in large applications may take a long time. If you get warnings in the test log that a search takes too much time, try doing the following:

Alternatives to Extended Find

Instead of using Name Mapping with Extended Find, you can search for objects from tests:

In this case, you specify the identification properties and values directly in your test. Also, the FindChild method lets you limit the search depth to make the search faster.

For more information on using the search methods, see these topics:

See also
Modifying Mapping Criteria | Using Conditional Mapping Criteria | Specifying Required Child Objects | Name Mapping | About Name Mapping Editor

© 2015 SmartBear Software. All rights reserved.
Email Send feedback on this document