Object Repository Window

Relevant for: GUI tests and components

Object repositories enable you to view and modify object descriptions, add and remove test objects, and drag them to your test or component to add new step.

Access the object repository window

To open the object repository window, ensure that a GUI test, action, or component is either opened or selected in the Solution Explorer pane.

Then, do one of the following:

With a GUI test, action, or component open in UFT Click the Object Repository button , or select Resources > Object Repository
From the Solution Explorer pane Double-click an object repository, or right-click an object repository and choose Open Repository
With a GUI test displayed in the Document pane Right-click an action in the canvas and select Object Repository
From the Toolbox pane Right-click a test object and select Open Resource
From the Recording toolbar Click the Object Repository button during a recording session.

Read-only object repositories

UFT supports both local and shared object repositories. Objects in local object repositories are available only to the associated action, while shared object repositories can be associated with multiple actions.

By default, shared object repositories are opened as read-only. Additionally, both local and shared object repositories are read-only during a record or run session.

Back to top

Modify object properties

You may need to modify the properties of a test object in your object repository when the objects in your application have been modified, and you want to ensure that your UFT tests and components continue to run as needed.

Note: If your website contains a Contact Us hypertext link that is tested by UFT, and the text string in this link is changed to Send us an email!, UFT must use the updated text to ensure that the check is performed correctly.

Modify properties for Insight objects

You may also need to update an Insight test object if the text is included in the test object image. In such cases do one of the following:

  • Modify the test object's image to include the updated text.
  • Add a similarity description property to the test object description.
  • Lower the property's value to enable UFT to match the test object with the object in your application despite the differences in the text.

For details, see Maintain test objects in object repositories.

Back to top

Object Repository window options

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

UI Elements

Description

Action
(for actions)

Enables you to select the action whose objects you want to view.

Business Component
(for components)

Indicates that the current testing document is a business component.

<Object repository tree>

Displays all of the test objects, checkpoint objects, and output objects in the local and shared object repositories associated with in the current component or in the selected action.

You can filter the objects shown in the object repository tree.

If there are test objects in different associated object repositories with the same name, object class, and parent hierarchy, the object repository tree shows only the first one it finds based on the priority order defined.

Name

The name that UFT assigns to the object. You can change the name of a object in the local object repository. For details, see Maintain test objects in object repositories.

Class

The class of the object.

Repository

The location (file name and path) of the object repository in which the object is located. If the object is located in the local object repository, Local is displayed.

<Object details area>

Displays and enables you to modify one of the following:

  • The properties and property values used to identify a test object during a run session

  • The properties of a checkpoint or output object.

For details, see the Object Repository window - object details area.

Test object image area

Displays the image used to identify the object and enables you to modify it.

For details, see the Object Repository window - test object image area.

Back to top

Object Repository window - object details area

The Object details area in the lower right side of the Object Repository window enables you to view and modify the properties and property values used to identify an object during a run session or the properties of a checkpoint or output object.

For test objects:

UI Elements

Description

Description properties

The properties and property values used to identify the object during a run session.

Tip:  

Visual relation identifier

A set of definitions that enable you to identify the object in the application according to its neighboring objects in the application. When this option is defined and enabled, the Ordinal identifier option is disabled. For details, see Visual Relation Identifier Dialog Box.

If one or more related objects cannot be found in the object repository, indicating text is displayed in the cell.

Ordinal identifier

A numerical value that indicates the object's order or location relative to other objects with an otherwise identical description (objects that have the same values for all properties). For details, see Ordinal Identifier Dialog Box.

If a visual relation identifier is defined for a specific test object, this option is disabled.

Additional details

Contains the following options:

  • Enable Smart Identification. Enables you to select True or False to specify whether UFT should use Smart Identification to identify the test object during the run session if it is not able to identify the object using the test object description.

    This option is available only if Smart description properties are defined for the test object's class in the Object Identification Dialog Box. For details on Smart Identification, see Smart identification.

  • Comment. Enables you to add textual information about the test object.

For checkpoints: The object details area contains the same information as the Checkpoint Properties dialog box. For details, see Checkpoint Properties Dialog Box.

For output objects: The object details area contains the same information as the Output Value Properties dialog box. For details, see Output Value Properties Dialog Box.

Back to top

Object Repository window - test object image area

The Test Object Image area below the test object details area is available only for Insight test objects.

It displays the image that UFT uses to identify the object in the application. To modify the image, click the Change Test Object Image button in the title bar of this area. The Adding and updating Insight test object images opens. In this dialog you can change the test object image and also the default location to click in the object when performing methods on the object.

Back to top

See also: