Add Eclipse projects to project containers

This topic describes how to add new or existing projects to project containers and how to work with contained projects.

Add an Eclipse project to a project container

To add an Eclipse projects to a Dimensions CM project container:

  1. Right-click an Eclipse project and select Team > Share Project.

  2. In the Share dialog box, select Dimensions CM as the repository, and click Next.

  3. In the Select Connection dialog box, choose either the Use existing Dimensions CM connection or Create a new Dimensions CM connection option, and select the correct connection. You may be prompted to log in.

  4. When you are prompted to choose a Dimensions CM project, choose to either use an existing project or create a new project. To add the Eclipse project to a container, select the Create in Eclipse Project Container checkbox.

    Note: If the project you are adding to is not already a project container, selecting this option converts it to a container.

  5. If you are adding the project to an existing project in Dimensions CM that has already been set up as a project container, expand the container under the Eclipse Project Containers list, and select the project.

  6. If needed, modify the project offset path in the Container Offset field. This is a unique path within the Dimensions CM project to the folder for the Eclipse project file.

    This path includes a folder named after the Eclipse project. For example, if the project is called Project1 and you add it to the following path in Dimensions CM: /dev/projects

    Then the resulting path is: /dev/projects/Project1

    Note: You cannot move and rename files across multiple Eclipse projects that are stored within a Dimensions CM project container, when the offset paths for the projects have overlapping folders. For example, you cannot move files from one project to another when those projects share a root folder, such as /dev. To refactor across projects, the projects must not share a root folder in their offset paths. For example, you can refactor two projects with the following offset paths: /dev/projects and /qa/test

  1. Select the target product, project type, ID (or name) and design part to provide upload rules for the new project.

  2. If you are creating a new project in Dimensions CM, enter the project's details, such as the product, type, ID, description, and design part.

Back to top

Set the default project type

You can choose to always add Eclipse projects to Dimensions CM as contained projects, by default. You can then optionally override this default setting when adding Eclipse projects to Dimensions CM.

To set the default project type:

  1. In Eclipse, select Window > Preferences.

  2. Expand the (Version Control) Team > Dimensions CM node.

  3. To work with project containers, select Show Eclipse Project Containers in Explorer.

  4. To default to creating contained projects when you add Eclipse projects to Dimensions CM, select the option Default project creation in Eclipse Project Container.

Back to top

Work with projects in containers

If you have converted existing SCC projects to project containers or added new Eclipse projects to containers in Dimensions CM, all users of the Eclipse project must open it in their local workspaces. To do this, they must choose to add the project containers or individual SCC projects within the project containers to their workspaces within Eclipse.

If you choose to add a project container, all projects within that container are added to the Eclipse workspace.

Back to top

See also: