About Managing Eclipse Projects

To use the version management functionality available in Dimensions for Eclipse, you must share your Eclipse projects with Dimensions CM. Sharing projects maps the projects either to single projects or streams in Dimensions, or to sub-folders within project containers. When you map a single Eclipse project to a single Dimensions project, the project mappings occur at the root level; the root of the Eclipse project maps to the root of the Dimensions CM project. In this case, Dimensions CM attempts to create a project or stream with the same name as the Eclipse project. If the actual Eclipse project name does not meet the requirements for project names in Dimensions CM, then a modified file name is used. Dimensions CM places the files in a project under Dimensions CM control, and a copy of the files are placed into the Dimensions CM repository. You can get or check out the files to your local workspace, where you can edit the files, and then merge or check in your changes into source control.

To learn more about Dimensions projects, streams, and parallel development concepts, see the Serena Dimensions User’s Guide or Getting Started with Serena Dimensions.


  • Dimensions CM uses metadata to mark which projects are related to Eclipse projects. See About Eclipse Project Metadata for details.

  • Many of the options described for the project occur at the file level and are identical to the procedures described under Working with Files. The only difference is that commands at the project level apply to all of the attached files. There are some project specific operations that are only available on the project level, such as Open Project Properties, Create Baseline, Branch, and Disconnect. The operations available will depend on the use of projects or streams, and whether the Eclipse project uses the Single Eclipse Project or Container model.

You can group multiple shared projects using project groups.