Mapping Objects Manually

Applies to TestComplete 15.62, last modified on March 19, 2024

You can add objects to the Name Mapping repository directly from your application or from TestComplete IDE:

To map a single object
  1. Run your application and make sure the needed window or control is on the screen or can be invoked quickly.

    If you are testing mobile applications, open the Mobile Screen window. You will use it to select objects.

  2. Do one of the following:

    – or –

    The “target glyph” is the easiest way to select a window or control, but it requires this window or control to be visible on the screen. The “point and fix” mode is helpful if you need to select an object that is not currently on the screen, and you need to perform some actions to make it visible. For instance, you use this mode to map menu items (to make an item visible, you first need to display that menu on the screen).

  3. If your project does not have the NameMapping item yet, TestComplete prompts you to add it.

  4. If mapping web objects by selectors is enabled (by default), and the selected object is a web or a mobile object, it will be mapped automatically along with its parent objects if they are not mapped yet either.

    Otherwise, in the resulting dialog, choose if you want to map the object with the default alias and identification properties automatically or if you want to specify them manually:

    If you have chosen to use the default settings, then you are done.

    If you have chosen to customize them, move to the next step.

  5. If the parent objects of the selected object are not in the Name Mapping repository yet, TestComplete displays a list of them. Click Yes to continue.

  6. For each object being added to the Name Mapping repository:

    • If there are several name mapping templates that match this object, TestComplete prompts you to select the template to use.

    • TestComplete displays the Object Name Mapping dialog where you can enter the object alias and select the identification properties.

To batch-map child objects
  1. Do one of the following:

    • In the Name Mapping editor, right-click the parent object in the Mapped Objects tree and select Map Child Objects from the context menu.

    • In the Object Browser, right-click the parent object and select Map Child Objects from the context menu.

  2. In the dialog, select the check boxes next to the child objects you want to map.

    Selecting child objects to add to the name map
  3. To map all the objects automatically using the default aliases and identification properties, select the Map objects automatically check box and click OK.

    To specify the object aliases and identification properties manually, leave the Map objects automatically check box unchecked, click OK and follow the on-screen instructions.

Tip: To map multiple objects

Mapping objects automatically during the test recording is the easiest and fastest way to map multiple objects. See Mapping Objects Automatically

See Also

Adding Objects to the Name Mapping Repository
Name Mapping
Mapping Objects Automatically
Mapping Objects From Tests

Highlight search results