Start the Project Merge Tool to merge folders

Merge two or more folders and resolve conflicts, with the result being a single folder. Folders can be projects or baselines, or folders/directories in a work area.

Upload rules need to be defined for any item types that will be added to the repository as a result of the merge.

You cannot merge the $GENERIC project.

To start the Project Merge Tool from the desktop client:

  1. Do one of the following:

    If you want to ...

    Do this ...

    Base the merge on an entire project.

    Select the project as your current project, and select Tools | Merge.

    Base the merge on a subfolder of a project.

    Select the subfolder of the project and select Project | Merge.

    Base the merge on a baseline.

    Select the baseline and select Baseline |Project | Merge.

  2. On the Ancestor tab of the Project Merge dialog box, from the Object Type list, select Baseline, File Based, or Project.

  3. To specify the ancestor, do one of the following:

    • In the Specification field, enter a project or baseline specification, or click Browse to find a project or a baseline.

    • In the Folder field, enter a folder name, or click Browse to find a folder.

  4. Click the Derivatives tab.

  5. To specify a derivative, do the following:

    1. From the Object Type list, select Baseline, File Based, or Project, and do one of the following:

      • In the Specification field, enter a project or baseline specification, or click Browse to find a project or a baseline.

      • In the Folder field, enter a folder name, or click Browse to find a folder.

    2. Click Add. The derivative is added to the Object Type table.

    3. Repeat steps a and b for each folder you want to merge with the ancestor folder.

  6. Click the Target tab.

  7. To specify the target, from the Object Type list, select File Based or Project.

  8. If you selected File Based, for the Folder field, enter a folder name, or click Browse to find a folder.

  9. If you selected Project, do one of the following:

    • For Specification, enter a project specification.

    • Click Browse to find a project.

    • Click New Project to create a new project and

    1. On the General tab:

      1. Select the Product to which the project will belong.

      2. Enter the Project ID.

      3. Select a Type.

      4. Enter a Description.

    2. On the Options tab, enter the project options. For details, see Project options.

    3. On the Named Branches tab, enter any named branches and select the default branch.

    4. On the attributes tab, enter any attributes.

    Note: If you create a new target project, you need to set the Dimensions CM upload rules. For more information, see About upload rules.

  10. Click OK. The target folder is not created until you resolved all the conflicts between the ancestors and the derivatives and save the folder in Project Merge Tool.

To start Project Merge Tool from the Windows command line:

  1. Start the Dimensions CM desktop client or SCC (Source Code Control).

  2. Select Start | Run.

  3. In the Run dialog box, type one of the following:

    • projectmerge ancestor_dir derivative_dir -target dir

    where:

    ancestor_dir is the name of the ancestor folder.

    derivative_dir is the name of the derivative folder. You can enter multiple folder names to compare.

    -target dir is the location of the merged folder.

    • projectmerge -config file

    where file is the name of the configuration file.

    • projectmerge -target dir

    where dir is the location of the target folder.

    In the Select Directories dialog box, enter the directories you want to compare, or click Browse to find the directories. The first folder is the ancestor and the second folder is the derivative. You can only add one derivative folder.

  4. Click OK.

The Project Merge Tool starts and you can merge the folders.

Back to top

See also: