Name Mapping - Basic Mapping Criteria

Before adding identification properties to a mapped object, make sure your tested application is running and the object currently exists in it.

1. Locate the object in the Name Mapping repository.

2. Double-click the object. TestComplete will open the Edit Name Mapping Item dialog that lists all the properties used to identify the object:

   

   Click the image to enlarge it.

3. In the Available list on the right, select the property you want to add and click .

   You can set a property value using:

   • Wildcards (* and ?).

   • A regular expression (precede the expression with the regexp: prefix, for example, regexp:List[\w+]).

   • A project variable.

   To add a nested property (for example, NativeClrObject.Name):

   1. Select the first item (in our example - NativeClrObject) in the Available list on the right and click the ellipsis button in the property value cell.

   2. Select the second item (in our example - Name) and click .

4. Add more properties, if needed.

5. Click OK.

It may take a lot of time for TestComplete to retrieve some property values (for instance, the VisibleOnScreen property). Using such properties as a name mapping criterion may affect your test performance, especially if you use them when performing an extended search. We do not recommend that you use such properties when mapping objects.

1. Select an object in the Name Mapping repository. You will see the object’s identification properties on the right.

2. Right-click the property you want to delete and then click Delete.

1. Select an object in the Name Mapping repository. It will show the identification properties on the right.

2. Select a property, press F2 and then click the ellipsis button in the property value cell. The Edit Property Value dialog will appear:

   

3. In the dialog, specify a new property value:

   To use a constant value:

   1. Select Constant from the Mode drop-down list.

   2. Enter the property value in the Value text box.

      Tip:	You can use wildcards (* and ?) or regular expressions to mask the dynamic parts of string values. For example, instead of Afx:TabWnd:3f9f0000:8:10005:10, use Afx:TabWnd:*.

   To use a project variable as the property value:

   1. Select Project Variable from the Mode drop-down list.

      Note: For project or project suite variables of the String, Integer, Boolean, and Double type, the list shows the current variable value making the choice easier.

   2. Select a variable from the Type list. The variable value will be shown in the Value box.

      Note:

      Only String, Integer, Double and Boolean variables can be used as identification property values.

   TestComplete caches mapped objects. If the variable value is updated during the test run, TestComplete may not update the mapped object’s criteria, and your test will continue using the cached object. To avoid possible issues, add the RefreshMappingInfo method to your test to command TestComplete to clear the cache and search for the object with the updated mapping criteria.

4. Click OK.