Select an Object page of the Insert a GUI Object into the Object Map wizard

You use the Select an Object page of the Insert a GUI Object into the Object Map dialog box to select the object in your application you want to add to the test object map.

About this task

When you select an object, Rational® Functional Tester lists its recognition properties in the grid at the bottom of the Select an Object page.

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

Object browser button Object Browser

Delay Method

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.
Rational® Functional Tester outlines the object with a highlight border.
Release the mouse button.
The object is selected and Rational® Functional Tester 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, Rational® Functional Tester 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.
Rational® Functional Tester 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 Rational® Functional Tester 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, Rational® Functional Tester 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

Object Recognition Properties Grid

When you select an object using any of the above 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 Test Object > Insert Object(s). 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).