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.
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 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 CM projects, streams, and parallel development concepts, see the Dimensions CM basics.
Tip: You can group multiple shared projects using project groups.
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:
|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.
|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.
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.
|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.
When you add Eclipse projects from Dimensions CM to Eclipse, you can define a work area outside your Eclipse workspace location.
This area is compatible with all Dimensions CM clients. You can open the same project in the desktop client or Windows Explorer, and update and check in updates from one common working location. This also applies when sharing a local Eclipse project that is located outside your workspace. You can define work areas that can be shared by other clients.
Even if you have previously set up Eclipse projects with work areas under the Eclipse workspace, you can use these projects with a shared work area.
Dimensions CM provides an auto-sharing feature that enables you to get existing Eclipse projects and then import them into Eclipse.