Using the Dimensions CM Synchronize Wizard

To synchronize your work area and the repository:

  1. Right-click the solution or project you want to synchronize, and select Sychronize Solution or Synchronize Project. Or, select File | Source Control | Sychronize.

  2. Continue reading or, for more detailed information on the Synchronization Tool, see the Serena Dimensions CM User’s Guide.

  3. If the Folder field is not set to the work area folder that you require, enter the path or use the browse button to select it. This folder can be a subfolder of the project.

  4. Synchronize with: Specify a Dimensions CM project or click the browse button to select one.

  5. Select the kind of synchronization you want to perform:

  6. Under Filter using wildcards (optional), enter expressions to include and exclude files and folders when synchronizing. The inclusions, if entered, will be evaluated before the exclusions when the synchronization is performed.

  7. For example:

    \.obj$

    Excludes paths that end with the string ".obj"

    Excludes "hello.obj" but not "hello.c"

    ^src\\debug

    Excludes paths that start with the string "src\debug"

    Excludes "src\debug\hello.obj" but not "src\hello.obj"

    ^New.*\.txt$

    Excludes paths that start with "New" and end with ".txt"

    Excludes "New Document.txt" but not "New Document.wav"

  8. Click Show additional options to display options on change detection and login.

  9. If required, change the Change detection options. If you want Dimensions CM to only use the timestamp to detect whether files in the working location have changed, select Use modification time (fastest). If you want Dimensions CM to use the file checksum to detect whether files have changed, select Checksum file content.

  10. If you require an output log for the results of the synchronization, select Enable in folder under Logging and enter a path or click the Browse button.

  11. Click the Next button. The next window displays the differences between your local work area and the repository.

  12. Select a display mode:

  13. Expand the folder tree as needed, or use the navigation buttons, to review the differences and conflicts:

  14. To compare a work area file and a repository item, select a file/item and click the Compare button. The file Merge tool opens.

  15. To specify a resolution for a difference or a conflict, select the file and then click a resolution on the toolbar. The resolution proposed by the wizard appears in bold text; available resolutions are underlined.

  16. If you do not select a specific resolution, the proposed resolution will be implemented upon completion of the wizard. Some or all of the following resolutions are available:

  17. If necessary, change any of the following default options on the Defaults tab. These settings apply to all applicable files included in the synchronization unless overridden for specific files:

  18. To set any of the above options to a unique value for specific files, select a file and click the Options tab. Here, you can override the setting with unique values.

  19. Click Next to display a synchronization summary, then start the synchronization.