Using Project Containers

Working with Projects in Containers

If you have converted existing SCC projects to project containers or added new Eclipse projects to containers in Dimensions, 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.

Setting the Default Project Type

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

To set the default project type:

  1. Select Window | Preferences.

  2. Expand the Team | Serena Dimensions CM node.

  3. If you will work with project containers, select the Show Eclipse Project Containers in Explorer check-box.

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

Adding Eclipse Projects to Project Containers

To add Eclipse projects to Dimensions project containers:

  1. Right click the Eclipse project and select Team | Share Project.

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

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

  4. When you are prompted to choose a Dimensions 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 check-box.
    IMPORTANT! If the project you are adding to is not already a project container, selecting this option will convert it to a container.

  5. If you are adding the project to an existing project in Dimensions 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 necessary, modify the project offset path in the Container Offset field. This is a unique path within the Dimensions project to the folder that will contain 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:
    Then the resulting path will be:

  7. IMPORTANT! You cannot move and rename files across multiple Eclipse projects that are stored within a Dimensions 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. In order to refactor across projects, those projects must not share a root folder in their offset paths. For example, you can refactor two projects with the following offset paths:

  8. You must also choose the target product, project type, ID (or name) and design part that will provide upload rules for the new project.

  9. If you are creating a new project in Dimensions, then you must enter project details, such as the product, type, ID, description, and design part.

Using the Serena Project Explorer

When you use project containers, they appear in the Serena Project Explorer in Eclipse as Eclipse Project Containers. The contained projects are then nested below them. Projects mapped directly to Dimensions projects appear as Single Eclipse Projects.