Update Name Mapping During Test Run

1. Enable the update mode

2. Set the timeout for waiting for missing objects

3. Run your test and update the Name Mapping

Notes

By default, updating Name Mapping during the test run is disabled to prevent the test flow from being interrupted. To enable the update mode:

1. Select Tools > Options from the TestComplete main menu.

2. Open the Engines > Name Mapping category.

3. Select the Update Name Mapping during test run check box.

4. Click OK to close the dialog and save the changes.

During the test run, TestComplete waits for objects during the Auto-wait timeout period. By default, it is 10 seconds. Before updating the Name Mapping, you may want to decrease this timeout to speed up detection of missing objects:

1. Select Tools > Current project properties from the TestComplete main menu.

2. Select the Playback category on the left.

3. Set the Auto-wait timeout property to the needed value (in milliseconds).

4. Save the changes to your project.

Make sure that the specified timeout is enough for objects in your application to become available.

Once you have finished updating the Name Mapping, you can change the Auto-wait timeout back to its previous value.

Run your tests. Whenever TestComplete cannot find a mapped object that a test operation uses, it will pause the test run and suggest fixing the identification problem:

• If the tested application, browser, or web page is not currently opened, TestComplete offers to open it.

• If there is an object with similar identification properties, you can command TestComplete to re-map the problematic object to point to a similar object.

• You can select the target object from screen or from a list of objects of the same type. (See the description of the Update Name Mapping wizard.)

• You can manually update identification properties to reflect changes in the object. (See Update Name Mapping Wizard - Update Mapping Settings Page.)

• The Update Name Mapping wizard cannot update objects that use conditional mapping. You will need to update mapping criteria for such objects manually.

• In certain cases, an object cannot be found because one of its required child objects is not found. When updating an object’s mapping settings, TestComplete resets its Required Children setting to default, that is, no required child objects. You may need to manually correct the Required Children setting for mapped objects afterwards.

• If the Engines > Name Mapping > Update Name Mapping during test run option is disabled, TestComplete logs an error message when it cannot find a mapped object during the test run.