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 steps.
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.
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 an object repository.
User interface elements are described below (unlabeled elements are shown in angle brackets):
Enables you to select the action whose objects you want to view.
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.
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 an object repository.
The class of the object.
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:
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.
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:
The properties and property values used to identify the object during a run session.
|Visual relation identifier||
A set of definitions that enable UFT One to identify the object according to its neighboring objects in the application. When this option is defined and enabled, the ordinal identifier option is disabled.
If one or more related objects cannot be found in the object repository, indicating text is displayed in the cell.
Note: UFT One uses a VRI to identify an object only when multiple identical objects are matched during the run session.
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).
If a visual relation identifier is defined for a specific test object, this option is disabled.
Note: UFT One uses an ordinal identifier to identify an object only when multiple identical objects are matched during the run session.
Contains the following options:
For checkpoints: The object details area contains the same information as the Checkpoint Properties dialog box.
For output objects: The object details area contains the same information as the Output Value Properties dialog box.
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.
- Add Properties Dialog Box
- Define a visual relation identifier for a test object - Use-Case scenario
- Define New Test Object Dialog Box
- General Pane (Options Dialog Box > GUI Testing Tab)
- Maintenance Run mode
- Object Properties Dialog Box
- Object Repository Manager Main Window
- Ordinal Identifier Dialog Box
- Solve individual test object description problems
- Test object model