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

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 One tests and components continue to run as needed.

Note: If your website contains a Contact Us hypertext link that is tested by UFT One, and the text string in this link is changed to Send us an email!, UFT One 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 One 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.

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

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: For details on adding properties to or removing properties from the test object description, see Add Properties Dialog Box. For details on specifying a property value as a constant or parameterizing a value, see Maintain test objects in object repositories.
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 One 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 Configure checkpoint details.

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.

Object Repository window - test object image area

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

For Insight test objects, this area displays the image that UFT One uses to identify the object in the application.
For Text test objects, this area displays the image the UFT One originally used to obtain the text property used to identify the object. If you modify the image, UFT One uses OCR to identify the text in the image, and updates the text property accordingly.

Note: If you change the text property of a Text test object, the image is not updated.

To modify the image, click the Change Test Object Image button in the title bar of this area. The Adding and updating Insight or Text test object images opens. In this dialog you can change the test object image.

For Insight objects, you can also change the default location to click in the object when performing methods on the object.