Creating a Branching View

A branching view is a new view derived from an existing view. When a branching view is created, StarTeam shares items from the parent view into the child view. The child view knows that the items came from the parent, but has no idea where the parent got them. For example, if a folder was shared to the parent view from another project, the child view does not have a similar share to the other project. If that is needed, the folder in the child view should be deleted and the folder should be shared to the child view from the other project (just as it was once shared to the parent view).

Similarly, if a folder was shared from the parent view to another project, or to another location within the parent view, the corresponding folder in the child view would not have that same relationship with the other project or view folder.

Note: Only folders, files, and change requests can branch. Requirements, tasks and topics never branch.

To create a branching view, do the following:

  1. Display the project view upon which the new view will be based.
  2. Choose StarTeam > View > New.

    The New View Wizard opens.

  3. Select Branch All from the View Type list.
  4. Type a Name and a Description for the view in the appropriate fields and click Next.
  5. Select the Root Folder for the new view and click Next.
  6. Type or browse for the name of an appropriate Default Working Folder.

    Caution: For a Branch All view, always use a working folder that is different from the one used by the parent view. Using the same working folder for the parent and child views can cause changes in one view to be overwritten when files are checked out from the other view. It can also result in incorrect or, at least, misleading file status indicators.

  7. Click Next to display the Configuration page.
  8. Select one of the available configuration options on the Configuration page.
  9. Click Finish.