View Compare/Merge
View Compare/Merge (VCM) is the tool you can use to compare two views or subsets of two views, referred to as the source and the target. As part of the process, you can merge item differences in the source view to the target view.
The View Compare/Merge UI is available in the StarTeam Cross-Platform Client and opens after running the View Compare/Merge Wizard.
View Compare/Merge UI
The View Compare/Merge window provides three perspectives for comparing and merging views, and for resolving item differences.
- The Compare Perspective (shown in image above)
- The Merge Perspective
- The Test Perspective
The View Compare/Merge window includes the following UI components:
UI component | Description | ||||||
---|---|---|---|---|---|---|---|
VCM Menu |
The View Compare/Merge menu consists of a subset of the main client menus, plus two additional menus specific to View Compare/Merge:
|
||||||
VCM Toolbar |
Frequently used View Compare/Merge menu commands corresponding to the VCM Session and Difference menus have corresponding buttons on the toolbar. Tool tips display when you hover your mouse over the toolbar buttons. Filters specific to View Compare/Merge and the current perspective display in the Filters drop-down list on the VCM Toolbar. Note: The Refresh button on the toolbar in the Merge Perspective does not change the snapshot of the source/target in use. It only refreshes the display with the View Compare/Merge session data that was already gathered. For instance, it might re-group items based on changes made by the user in the View Compare/Merge window. For example, if you go back to the target view and move a file, when you return to the merge window and selected Window > Refresh, the moved file will still be shown in its original location. |
||||||
Upper Pane |
The upper pane serves a different function in each perspective:
|
||||||
Lower Pane |
The lower pane serves a different function for each perspective:
|
View Compare/Merge Status Icons
The status of folders and items in a View Compare/Merge session is represented in the Merge Perspective by icons which are explained in the tables below. Icons appear on or beside folders, items, and on component tabs. Icons change dynamically when conflicts are resolved.
When you hover the mouse cursor over an icon in the upper pane, a menu appears from which you can choose a merge action. Tool tips display for folder icons.
|
This folder contains compared items that remain unchanged. |
|
This folder contains compared items, some of which have unresolved changes called merge conflicts. Merge conflicts are differences in file contents or property values that require manual intervention. |
|
This folder contains compared items, none of which have unresolved changes. No manual intervention is necessary. |
|
This folder contains no compared items or folders. |
The folder icons are displayed in the left pane beside each folder in the hierarchy tree of a View Compare/Merge session in the Merge Perspective. The folder icons in a View Compare/Merge session represent what is in the currently selected component tab in the upper pane. For example, in the situation where you have resolved all the file conflicts in a particular folder, but you still have unresolved change requests in that folder, the following will happen:
- When you click the Files tab, the folder icon will have a check mark, indicating that all file conflicts in that folder have been resolved.
- When you click the Change Request tab, the folder icon will have a question mark, indicating that the folder has unresolved change requests.
No icon | Item is included in the comparison and is unchanged. |
|
Item resolved by View Compare/Merge. You can override the default action with a different action. |
|
Item has differences and is unresolved. You must resolve the differences manually. |
|
Item is not included in the comparison. |
|
Item is changed. This is used in Compare-only. |
Item status icons are displayed in the upper pane of the Merge Perspective for each item with differences or conflicts. They are also displayed on each component tab that contains items with differences. Item icons appear in the Merge Status and Merge Action columns, and on individual property columns when properties are in conflict.