Sharing Projects With Serena Dimensions CM

To place existing Eclipse projects under Dimensions CM control, you must share your Eclipse project with Serena Dimensions CM. If you are working with Eclipse project containers, see Adding Eclipse Projects to Project Containers.

This procedure is for adding your local project to the Dimensions CM repository. To add a project that already exists in the repository to your local workspace, see Adding Repository Projects and Streams to your Workspace.

To share a project with Serena Dimensions CM:

  1. In Eclipse, right-click the project icon and select Team | Share Project.

  2. The Share Project dialog appears.

  3. Select Serena Dimensions from the Select a repository type list and click the Next button.

  4. The Select Connection panel appears.

  5. Select one of the following choices:

  6. If your current Eclipse session is not yet logged in to Dimensions, the Dimensions Login dialog box appears. Log in to Dimensions.

  7. The Project Selection panel appears.

  8. Select from the following choices. The options available here depending on how your administrator has configured your Dimensions intallation. You may be able to use Dimensions project, streams, or both.

  9. To add the project to a Dimensions project container, select Create in Eclipse Project Container. For details on working with project containers, see Using Eclipse Project Containers.

  10. If you chose to create a new stream or project, you must complete one of the following steps:

    1. For a new stream, select the product, enter a stream name and description, and name the unique branch that will be used to identify file revisions stored in the stream. You can also set a container offset and choose the design part for new items by clicking the Show Advanced Settings button.

    2. For a new project, select the product, enter a project name, select a project type, and enter a description. You can also set the Container Offset and Design Part for New Items by clicking the Advanced button.

      The Project ID is automatically populated based on the Eclipse project name.


    If you are working with project containers, see Adding Eclipse Projects to Project Containers.

  11. Click Next.

  12. If you are creating a new stream, complete the Additional Details dialog box and click Next. If you are creating a new project, skip ahead to the next step. Complete the following options on the Additional Details dialog box:

  13. If you chose to create a new project, complete the following steps:

    1. Complete the Based-on dialog box and click Next:

    2. Complete the Options dialog box and click Next:

    3. On the Named Branches dialog box, select valid named branches for the new project. CTRL+click to select multiple branches. Choose a default named branch from the Default Branch list. Click Next.

    4. On the Attributes dialog box, set values for any user-defined attributes that you want to define for this project. Click Next.

  14. Review the the Sharing Summary dialog box to ensure that the share settings are correct.

  15. Do any of the following:

  16. Click Finish.

Depending on your selections, any of the following may happen:

After your project is placed under control, a gold cylinder (undersc_icon.gif) is added to the icon of each item to indicate that the item is under source control. The Dimensions CM information for the project, including its product and Dimensions CM project name, appears in brackets alongside the Eclipse project name.


You can disable the Dimensions source control project decorations under user preferences. See Managing Preferences for the Dimensions for Eclipse Plug-in for more details.