Add Eclipse projects to source control

To use the version management functionality available in the Eclipse integration, you need to share your Eclipse projects with Dimensions CM.

Eclipse projects

Sharing projects maps the projects either to single projects or streams in Dimensions CM, or to subfolders within project containers.

When you map a single Eclipse project to a single Dimensions CM project, the project mappings occur at the root level. The root of the Eclipse project maps to the root of the Dimensions CM project. 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 a modified filename 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 CM projects, streams, and parallel development concepts, see the Dimensions CM basics.

Tip: You can group multiple shared projects using project groups.

Back to top

Repository projects

In Dimensions CM Explorer, projects are displayed under the Repository Projects node. The Repository Projects node lists the project groups and projects available on the Dimensions CM server to which you are connected.

Projects are then broken down into the following categories:

Category Description
Single Eclipse projects A single Eclipse project is a project or derivation that was added to the repository through the integration and contains Eclipse specific metadata. Derivations include projects or baselines that may not have been directly added to the repository from Eclipse, but were derived from an original project which was added through the integration.
Eclipse project containers An Eclipse project container is a type of Dimensions CM project or stream that can store multiple Eclipse projects. An Eclipse project that is stored within an Eclipse project container is called a contained project. An Eclipse project container shows the same derivation information as Single Eclipse projects. All repository files from the root of the selected stream or project are added as an Eclipse project.
Streams Eclipse projects that are associated with Dimensions CM streams are listed under the Single Eclipse Projects or Eclipse Project Containers nodes with a unique icon.
Eclipse project groups Eclipse project groups are parent level projects that contain multiple subprojects. Project groups are used to organize multiple projects and make it easier for users to manipulate projects.
Other baselines

These are Dimensions CM baselines that do not contain Eclipse-specific metadata. To add these baselines to your local workspace, right-click the baseline and select Add to Workspace.

Other projects These are Dimensions CM projects or streams that do not contain Eclipse-specific metadata. To add these projects or streams to your local workspace, right-click and select Add to Workspace. For details, see Add projects to your workspace.

Back to top

See also: