Update Name Mapping Wizard - Update Mapping Settings Page

TestComplete shows the Update Name Mapping wizard when it cannot identify a mapped object in your tested application. On this page of the wizard, you can update the identification properties of the problematic mapped object:

The Selected list shows the current identification properties used to find the object. Invalid properties (those that the object does not have or the properties whose values do not match the actual property values) are marked with the icon.

The Available list shows all the properties of the selected object that you can use for identification.

Which object properties are available

Which object properties are availableWhich object properties are available

The Available property list contains object properties that are provided by TestComplete and, if your tested application is Open, the object’s native properties and fields. In general, the Available list contains the same properties and fields as those you can see in the Object Browser or the Object Spy window when exploring the object, but with a few limitations:

• It does display properties that return values of non-complex data types, like boolean, integer, floating-point, string and others.

• It does display properties that refer to IDispatch interface objects. References to empty objects are also displayed.

• It does not display properties of non-complex types that have an empty value (null in C++ and C#, nil in Delphi, Nothing in Visual Basic, and so on; do not confuse it with an empty string). This is because TestComplete needs to know the property type to use it when mapping objects.

• It does not display indexed properties of any kind. Indexed properties are properties that require one or more additional parameters to get a value.

• It does not display native protected and private properties and fields if the Show hidden members option is disabled.

• It does not display native object properties and fields that are unavailable to TestComplete (see Object Properties, Fields and Methods That Are Unavailable to TestComplete).

Update the selected properties to identify the selected object uniquely:

• To update all invalid property values and remove missing identification properties from the mapped object, click Update All Properties.

• To add a custom property (for example, a native object property) that is not listed in the dialog, click Add Property.

• Use the Update button next to an invalid identification property in the Selected list to update the property value.

• Use the and buttons to remove invalid and no longer needed identification properties from the mapped object. Use the and buttons to add new identification properties to the object.

  Tip:	You can quickly locate the needed property among the object’s available properties by typing its full or partial name by using the Quick Search box.

• Specify new values for identification properties. To do this, click the ellipsis button in the property value cell and in the resulting Edit the Property Value dialog, specify the needed value. You can also specify a variable that stores the needed value.

  To specify string values, you can use wildcards or regular expressions in the ”regexp:pattern“ format. The asterisk (*) matches zero or more characters, the question mark (?) matches any single character. To specify more complicated parts of a caption, use regular expressions.

Click Finish to complete updating identification properties. If the wizard is called during the test run, after updating the problematic mapped object, TestComplete will rerun the test operations interacting with the object and will continue the test run.

To cancel updating identification properties and ignore the identification problem, click Cancel. If the wizard is called during the test run, TestComplete will resume the test run from the following operation.

See Also

Update Name Mapping Wizard
Update Name Mapping
Basic Mapping Criteria