Update a shared object repository from a local one

Relevant for: GUI tests and components

This topic describes how to update a shared object repository from a local object repository.

Prerequisites

Make sure that the shared object repository you want to update from the local object repositories is already associated with the repository actions or components.
Make sure the tests or components containing the local object repositories are not part of an open solution.
Make sure that a GUI test or component is in focus.
Make sure that the Object Repository Manager window is open.
Make sure the resolution and color settings are configured to match your needs.

Select the shared object repository and the local repositories that you want to merge into it

In the Object Repository Manager, open the shared object repository into which you want to merge the local repositories. If the object repository opened in read-only mode, select File > Enable Editing.
Select Tools > Update from Local Repository to open the Update from Local Repository Dialog Box.
In the Update from Local Repository Dialog Box, select the tests or components that contain the local object repositories you want to merge, and click Update All.

Analyze the initial merge results

View the initial merge results in the Merge Statistics Dialog Box (Object Repository Merge Tool).

Analyze the detailed merge results

Review and analyze the detailed merge results in the Object Repository Merge Tool - Multiple Merge Window.

Utilize additional tools to help you perform the comparison - optional

Filter the objects and show only the objects that you want to view by using the Filter Dialog Box (Object Repository Merge Tool).
Locate one or more objects in a selected object repository whose name contains a specified string using the Find Dialog Box (Object Repository Merge Tool).

Adjust object conflict resolutions

If one or more of the merge resolutions does not match your needs, follow the steps below to adjust them:

In the target object repository, select an object that had a conflict, as indicated by the icon to the left of the object name. The conflicting object is highlighted in the local object repository.

A description of the conflict and the resolution method used by the Object Repository Merge Tool is described in the Resolution Options pane. A radio button for each possible alternative resolution method is displayed.

In the Resolution Options pane, select a radio button to choose an alternative resolution method. The target object repository is updated according to your selection and redisplayed.
In the Resolution Options pane, click the Previous Conflict or Next Conflict buttons to jump directly to the next or previous conflict in the target object repository hierarchy.

Save the target object repository

When the object conflicts are resolved satisfactorily, save the new merged shared object repository.

Note: The objects that are merged into the shared object repository are removed from the local object repositories. The steps in the actions or components then use the objects from the updated shared object repository.