Select Test Object Dialog Box

Relevant for: GUI actions and components

This dialog box displays the object repository tree and enables you to:

  • Select an object in the object repository tree for your step.

  • Select an object from your application for your step. This adds a test object to the local object repository.

  • Select a related object to use in a visual relation identifier. This adds a test object to the same object repository as the test object you want to identify. For details on visual relation identifiers, see Visual relation identifiers.

  • Enter a .Object statement for the selected test object in your test.
To access

Use one of the following:

  • In the Item cell of the Keyword View, click the arrow button to display the Item list and then select Object from repository.

  • In the Visual Relation Identifier Dialog Box, click the Add button.

  • For actions and scripted components only: In the Step Generator Dialog Box, select Test Objects from the Category box list and click the Select Object button .

Important information
  • If the object that you want to use in the new step is not in the object repository, you can select an object in your application by using the pointing hand. This adds it to the local object repository.

  • If you select an object in your application that is not in an associated shared object repository, a test object is added to the local object repository when you insert the new step.

  • After you add the required objects to the local object repository, you can use the Object Repository Merge Tool to update the associated shared object repository and make the new test objects available to other actions and components.

  • For components: ALM users can select only objects that are stored in the shared object repositories (in the component's application area).

Relevant tasks

Standard steps in the Keyword View

See also

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Elements


Find Next. Searches from the currently selected node, displaying all objects that match your criteria. The first object in the list that matches your criteria is highlighted.

You can click the Find Next button to navigate through all the objects that match your search criteria. The search continues to the end of the tree, then wraps to the beginning of the tree, and continues.

Tip: Press F3 to find the next object that matches your search criteria, or SHIFT+F3 to find the previous match.

<Pointing hand>. Enables you to select an object from your application and add it to the shared object repository so that you can use it in your action or component steps. This is useful if the shared object repository does not include the test object that you need for a particular step.

Select from Default (uses normal object recognition support for the loaded add-ins) or UI Automation modes.

Click on the required object in your application to add it to the shared object repository tree. In some environments, as you move the pointer over your application, the available test objects are highlighted. For details, see Tips for using the pointing hand.


The full or partial name of the object to find.

This option is useful if the object repository is very large. If you leave the box empty, all objects that match the selected object Type are displayed.

Example: Enter p to search for all object names containing the letter p.


The type of object for which to search. Specify a type or select <All> to search for the object in all the object types.

The object types in this list are a generic grouping of objects according to the general object characteristics. For example, the List type contains list and list view objects, as well as combo boxes; the Table type contains both tables and grids; and the Miscellaneous type contains a variety of other objects, such as WebElement and WinObject.

Example: Suppose you want to add a password object that you know is an Edit box. You can search all the Edit type objects for one called password, or even one containing the letter p.

<object repository tree>

List of objects in the object repositories associated with the current action or component. You can select a test object from this tree to insert into a step.

Insert test object

Inserts the selected test object in the step.

This option is available only when this dialog box is opened from the Keyword View for an action or from the Visual Relation Identifier dialog box.

Insert run-time object

Inserts an Object statement step for the selected test object. (Relevant for any object that supports the .Object property.)

This option is available only when this dialog box is opened from the Keyword View for an action or from the Visual Relation Identifier dialog box.