Merging Changes from a Child View to a Parent View (Promote)

Promote compares or merges changes from a child, or derived, view to its parent. You can start a Promote View Compare/Merge session from either a parent view or a child view.

To perform a Promote operation starting from the parent or child view, do the following:

  1. Open the view to use in your session.

    Note: The parent is the target in a Promote operation and its tip configuration must be used. The View Compare/Merge Wizard uses the configuration to which the view is currently set if you start the wizard from the source view.

  2. Right click the item(s) and select Advanced > View Compare/Merge.

    The View Compare/Merge Wizard opens.

  3. Select Promote as the compare/merge type.
  4. Select Source of Merge or Target of Merge under Use Current View (name) For, and click Next.

    Note: Both the Source of Merge and Target of Merge options can be enabled if the parent or child view is both the parent and child of another view.

  5. Select the parent or child view to use as the source view in the View Tree for the comparison and click Next.
  6. If you selected Target of Merge, choose the source view configuration to use: Current, Labeled, Promotion State, or Configuration As Of (a specific timestamp).
  7. Click Next.
  8. Select one or more types of items you want to include in the compare/merge session and click Next.
  9. Check one or more compare/merge options to use by default at the beginning of the compare/merge, and click Finish.

View Compare/Merge begins comparing the views immediately and opens a new StarTeam window in the Merge Perspective where you can resolve any remaining merge conflicts. Items with unresolved differences are easy to find. In the Merge Status column for each of these items, View Compare/Merge displays a question mark, followed by the word Unresolved. The component tabs and folders also display a question mark if they contain items with unresolved differences.

You must resolve each merge conflict before you can complete the merge and commit the changes.