To work on a project or stream that already exists in the Dimensions CM repository do one of the following:
Add the project to your local Eclipse workspace.
(If you are adding single or multiple projects from an Eclipse project container) Add the projects to a location outside of your Eclipse workspace that can be shared with other Dimensions clients, such as the desktop client.
To add existing repository projects to your Eclipse workspace or a shared work area:
In Serena Explorer expand the Repository Projects node.
Select any of the following:
A single project in Single Eclipse Projects. The Eclipse project name will be taken from the .project file or from the metadata.
One or more projects in Eclipse Project Containers.
An existing project under Eclipse Project Groups. This adds all of the child projects to your workspace. The Eclipse project name is taken from the .project file or from the metadata.
A project or baseline under Other Baselines or Other Projects. If there is not a project file a name is generated from product_projectid for the new Eclipse project. You can change the automatically generated name.
Right-click and select Add to Workspace. The wizard walks you through the process of adding existing streams and projects to your Eclipse workspace.
If you are adding an Eclipse project container do one of the following:
To add all of the child projects to your workspace select Nested Eclipse projects and click Next. Select the projects that you want to add to your workspace, click Next, and go to step 6.
To choose how the project will be added to Eclipse select Project container, click Next, and go the next step.
Select one of these options:
Add and configure the project using the Eclipse New Project Wizard
Enables you to specify a project type and name, the default location, working sets, and referenced projects. Click Finish and use the New Project Wizard to add the project.
Add as project
Enables you to add the entire project or stream as an Eclipse project. Not available for shared Eclipse projects or streams that have a.project file generated by Eclipse. Select a project from the list and click Next.
Select the project location. If you do not want to use the default, unselect Use default workspace location and enter the path to the shared location. This may be an existing work area that is compatible with Eclipse and other projects. If you choose a new location a new compatible work area is created.
NOTES
If you are adding a single project check that the path concludes with the correct offset of the project in the Dimensions project or stream.
If you are adding multiple projects the location is the root location and all projects will be located at their offsets relative to this location.
For both cases a compatible work area is created. Local paths relative to the work area location match the offsets in the Dimensions project or stream. If there is a pre-existing compatible work area above this location, the location will be automatically adjusted to match.
Click Finish.
IMPORTANT!
Dimensions for Eclipse checks to ensure the correct configuration. Error messages appear in the following cases:
Work areas already exist that are not associated with the Dimensions project or stream from which the Eclipse project is being added
Multiple pre-existing work areas reside above the project location
You cannot add to the workspace if either of these conditions occurs.
It is possible to set the location to the root of a drive on Windows or the root folder on Linux. A warning appears and Serena strongly recommends that you do not choose a drive root.