Creating and using a test object map to test applications

You create a test object map, refine it to more accurately to describe the application, and share the map with other scripts you create to test the application.


  1. Optional: Create a new test object map. For more information, see Create a new test object map related topic.
    Note: When you record a script, HCL OneTest™ UI creates a test object map (or perhaps uses an existing shared map) for the application-under-test.
    • Assign a name that identifies its purpose.
    • Start the application to test.
    • Include all objects that you want to test in the application. For more information, see Adding objects to an object map topic.
    • Edit object properties. For example, you can convert a recognition property value to a regular expression, which allows for more flexibility in the object recognition.
    • For each object, describe its purpose to reflect what you would like to see in a script. See Adding test object descriptions related topic.
    • Optional: Edit descriptions for commonly used test objects. See Edit test object descriptions related topic.
  2. Record a script. On the Select Script Assets page, in the Test Object Map field, click Browse to select the shared object map you created.
  3. Play back the script.


You now have a test object map that reflects the application it was designed to test. You can share this map with the scripts you create to test the application. If the test object map is used by many scripts and it becomes necessary to change it, changing recognition and administrative properties in the map allows the associated scripts to run with this improved application definition. When using private test object maps, the application properties must be updated on a per-script basis.

What to do next