Select an Object dialog

You use the Select an Object dialog to select the object in your application you want to add to the test object map and a script.

When you select an object, IBM® DevOps Test UI (Test UI) 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 Finder Tool

Object Browser Object Browser

Delay Method Delay Method

Object Finder Tool Object Finder Tool

This is the most common and direct method of selecting an object:

  1. Select the Object Finder tool icon Object Finder Tool and drag it over the object in your application that you want to select.

    Test UI outlines the object with a highlight border.

  2. 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.

Object Browser Object Browser

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.

  1. Browse the object tree to find the object you want to add to the test object map.
  2. Click the object to select it.

    Test UI lists the object's recognition properties in the grid at the bottom of the Select an Object page.

Delat Method Delay Method

Use the Delay method to select pop-up objects, such as menus. This 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.

  1. 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).
  2. Click the Object Finder tool icon Object Finder Tool.
  3. 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.

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 tab. 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 that information to confirm that you selected the correct object.

To open: From the product toolbar, click the Insert Test Object into Active Functional Test script button Active Functional Test script button. You can also right-click the Test Objects folder in the Script Explorer and select Insert Test Object.