Add and remove files to/from source control

After you connect an Eclipse project to source control, you can add files to source control. Removing files from source control removes them from the Dimensions CM project.

Add files to source control

You can add files to an Eclipse project under source control.

If you are using Dimensions CM streams, use the synchronization feature to add new files to source control.

To add files to an Eclipse project under source control:

  1. In Eclipse, right-click the files, and select Team > Add to Dimensions.

    The Deliver Changes dialog box displays a list of files to be added.

  2. In the Deliver Changes pane, do any of the following:

    • Select or clear which files to add to source control.

    • On the Comment tab, enter a description of the files.

    • On the Options tab, select from the available options:

      Option Description
      Checkout posted changes Set to Yes to check out the files that you are checking in.
      Make files read-only Set to Yes to make the local file copies read-only after checking in.
      Overwrite conflicting changes

      Set to Yes to overwrite any conflicting changes in the repository with local content.

      If you set this option to No, the check-in fails if there are any conflicts, and you need to merge the files using the synchronize view.

      Click Next.

  1. If asked to relate requests to the files, select the requests from the My Inbox or Favorites tab, and click Next.

  2. In the Relate Requests pane, select the Dimensions CM requests to relate to the item during the add operation. The items are grouped by type, allowing you to easily relate requests to multiple items with similar types.

    By default, only those requests that can be used are displayed. If you choose the Show All option, the unavailable requests appear in italics and the Details column provides information on why they cannot be used.

  1. In the Item Attributes pane, set the Dimensions CM attributes for the items that you are adding to control.

  2. Click Finish.

    On successful completion, a gold cylinder is added to the icon of each item to indicate that the item is under source control.

Back to top

Remove files from source control

When you remove a file from source control, the file is removed from the Dimensions CM project. You no longer can access earlier file revisions from this project. Only the latest revision remains in your local area (if you do not choose to delete it).

The file still exists in the $GENERIC:$GLOBAL project (the global project) if you need to restore it.

To remove files from source control:

  1. In Eclipse, right-click the files under Repository Projects.

  2. In the pop-up menu, select Team > Remove from Dimensions.

    The Remove From Control dialog box displays a list of files to be removed.

  3. In the Remove from Control pane, do any of the following:

    • Select or clear the files to be removed from control.

    • Select from available options on the Options tab. For example, set Delete local files to Yes to delete the files in local workspace after removing the files from Dimensions CM control.

  4. In the Relate Requests pane, select the Dimensions CM requests to relate to the item during the remove operation. The items are grouped by type, allowing you to easily relate requests to multiple items with similar types.

    By default, only those requests that can be used are displayed. If you select the Show All option, the unavailable requests are displayed in italics, and the Details column provides information on why they cannot be used.

  1. Click Finish.

Back to top