Select an Object page of the Insert a GUI Object into the Object Map wizard
You can use the Select an Object page of the Insert a GUI Object into the Object Map dialog to select the object in your application you want to add to the test object map.
About this task
When you select an object, HCL DevOps Test UI (Test UI) lists its recognition properties in the grid at the bottom of the Select an Object page.
Object Recognition Properties Grid
When you select an object using any of the three methods, its recognition properties are listed in the grid at the bottom of the Select an Object page. The Recognition properties are determined by the object's proxy. For example, a "button" object has three Recognition properties: label, .class, and .classIndex. The grid lists the name and value of your specific object's Recognition properties. You can use the Recognition Properties information to confirm that you selected the correct object.
To open: From the Test Object Map menu, click . From the Test Object Map toolbar, click the Test Object: Insert
Object(s) button 
. You can also right-click in the test object map and click Insert Test
Object(s).
If you select the wrong object, or decide to add a different one, use any of the methods to select a different object. Once you click the Finish button, the object that is listed in the grid is the one that you will be adding.
The following three selection methods are available:
Object Finder Tool
About this task
Using the Object Finder tool is the most common and direct method of selecting an object:
Procedure
-
Select the Object Finder tool icon
and drag it over the object in your application that you want to select.
Test UI outlines the object with a highlight border.
-
Release the mouse button.
The object is selected and Test UI lists its recognition properties in the grid at the bottom of the Select an Object page.
Results
Select the After selecting an object advance to next page option to go directly to the next page after you select the object. Clear the advance to next page option to remain on the Select an Object page to see the object recognition properties after you select the object.
Object Browser
About this task
Use the Object Browser method to browse for the object you want to add to the test object map. The browser displays a hierarchical tree of objects in your application. The top level shows any applications you have running. Under each top level, Test UI displays the object hierarchy within that application.
Procedure
- Browse the object tree to find the object you want to add to the test object map.
-
Click the object to select it.
Test UI lists the object's recognition properties in the grid of the Select an Object page.
Delay Method
About this task
Use the Delay method to select pop-up objects, such as menus. The Delay method uses the Object Finder tool, but enables you to set a delay, which gives you time to get to an object that requires clicking on other objects first.
Procedure
- In the Seconds before selection field, enter the number of seconds you want to delay before Test UI attempts to find the object (the default is 10 seconds).
- Click the Object Finder tool icon .
- Go to the application and find the object you want to select.
Anything you do during the delay period is not recorded, which enables you to "dig" for objects if necessary.
When the timer runs out, Test UI selects the object under the cursor, outlines the object with a highlight border, and displays its recognition properties in the grid at the bottom of the Select an Object page.
Note: In order for delayed location of the objects to play back correctly, the object must be exposed by actions in the script. If the object is not exposed, an Object Not Found exception is thrown during playback.
Results
Select the After selecting an object advance to next page option to go directly to the next page after you select the object. Clear the advance to next page option to remain on the Select an Object page to see the object recognition properties after you select the object.