How to Use NameMapping & Aliases for effective scripting

October 2, 2013

The Full Name of an object, which is defined by TestComplete, can be difficult to work with. For example if you have a long object name with special characters, typing and reading it can be time consuming and prone to typing mistakes.

Let us say a textbox in a web page has the following name.

Sys.Process(“iexplore”, 2).Page(“”).Table(1).Cell(0, 1).Panel(“login”).Form(“gaia_loginform”).Panel(“gaia_loginbox”).Table(0).Cell(0, 0).Panel(0).Table(“gaia_table”).Cell(2, 1).Textbox(“Email”)

This is not a simple bit of text to work with. To overcome this issue we can use the NameMapping feature. In the above mentioned object, from the text “Sys” to “Textbox(“Email”)” we can create a Mapped name for every object and use it in our scripts.

If you want to learn more about the basics of how name mapping work see our post on How the Name Mapping works in Test Complete.

After creating Name Mapping for every object, we can refer to the object as follows.


It’s clear that this is easier to read. Even though it is easy to read, still the name is too long. It will be difficult to remember all the Mapped names & their hierarchy. So you end up getting the full mapped name of the object by using the object spy. As a result productivity goes down because you have to go through several steps to pick out the name.

To resolve this problem, we can use Alias names. From the above mentioned mapped name, we can remove a few objects and create a short name. For example the Aliases name of the above object can be given as follows.


This becomes very easy to read and write. Also we can easily memorize the names of required objects alone and type them in our scripts (without the help of the object spy). As a result productivity goes up.

In this example, we will see how to write an automation script for a log-in action in Gmail using the NameMapping & Aliases concepts.

  1. Open a new project in testcomplete. Add ‘NameMapping’ project item (If it is not available) using the following steps.
    1. In Project Explorer, Right click on Project Name folder and select Add –> New Item option
    2. NameMapping

    3. In “Create Project Item” window, Select ‘NameMapping’ option and click OK.
    4. CreateProjectItem

    5. Now in Project explorer it will show the “NameMapping” Item.
    6. NameMapping1

  2. In Internet Explorer, open the page. Now we are going to create, Mapped names for the objects on which we are going to perform actions. Here we are going perform actions on Username Textbox, Password Textbox, and Login Button. So we will Map these objects.
  3. First we will Map the Username Textbox.
  4. UsernameTextbox

  5. Click on ‘Map Object From Screen’ button in tescomplete toolbar.
  6. MapObjectFromScreen

  7. It will open Map Object window. Drag the Finder tool to the Username Textbox and release the mouse button. Now the “Object” textbox will show you the Full Name of the Username Textbox. Click OK button.
  8. MapObject

  9. Now it will ask you to Map all the Parent objects of Username Textbox before mapping it.
  10. Parentobjects

  11. Click Yes in that window. Now you have to Map all the objects in the displayed window and finally it will show the Username Textbox. First it will show you the IE process object in Object Mapping window. I.e. Sys.Process(“iexplore”,2)
    1. Give a Mapped name. It should be a readable and clear name.
    2. Select some required properties from Available Column list for unique identification of
      object (if needed) or remove some unwanted properties from selected column list (if needed)
      and Click OK button.
  12. uniqueidentification

  13. Now it will ask you to Map the next parent object of Username Textbox. As mentioned above in Step-7 Map all the Parent & Username Textbox objects.
  14. Once you have mapped all the Objects, double click on the ‘NameMapping” project Item. It will show the Name Mapping window. In this window you can see the Mapped Objects in a tree format. You will also see the Alias names which are created by default (in the same hierarchy as the Name Mapping).
  15. NameMapping4

  16. If you use this default Aliases name, it will come to the same length as Full Mapped name. To remove the names of some unwanted higher level objects, do the following.
  17. In Mapped Objects window, select the object on which you are going to perform actions. Drag that object from Mapped object window to Aliases window and drop under an object. Once you’ve done this the name will become very simple with just the important objects at the top level.
      (Here we are going to perform action on UsernameTextbox. So drag it and drop it under theObject ‘Page’ in Aliases window).
  18. drag-and-drop-page-opject

  19. Now you can refer to the Username Textbox as follows
  20. Alisases-IEProcess

  21. Now Map the Password Textbox and Login button in the same way and drag them under the Page object. Once this is done, you should have the Aliases name as follows.
  22. Aliases


  23. So now you can use the following code to perform the Login action.
    1. function LoginGmail()
      var pageObj = Aliases.IEProcess.Page


    2. If you record the same action, without creating these NameMappings & Aliases you will get the following script. It goes without saying that this is very difficult to read and understand.
    3. NameMappingsAliases1

    In summary you can create Mapped names and Aliases for any object. You can then use those names while writing scripts to make working with Test Complete far easier.