Manage preferences in Eclipse

You can set the font and color preferences, and modify how Dimensions CM for Eclipse displays items and requests.

Set general preferences

From the general preference page in Eclipse, you can set preferences for project containers, as well as for the font to use for multiline properties.

To set general preferences:

  1. In Eclipse, select Window > Preferences.

  2. In the Preferences dialog box, expand the Version Control (Team) node and select Dimensions. The general Dimensions preferences are displayed.

  3. Choose whether to display project containers in the Dimensions CM Explorer view and whether to create projects by default in project containers.

  4. Select the option Show Single Eclipse Projects in Explorer to display Eclipse projects that are mapped 1:1 to Dimensions CM projects, in Dimensions CM Explorer.

If your smart card software is installed to a different path from the Dimensions CM for Eclipse default location, change the smart card library path to the correct location.

Back to top

Set console preferences

You can change the colors that Dimensions CM for Eclipse uses for the output messages. These messages are usually displayed in the Dimensions CM Console view.

To change console preferences:

  1. In Eclipse, select Window > Preferences.

  2. In the Preferences dialog box, expand Version Control (Team) > Dimensions and select Console.

  3. Select the colors for each of these console outputs:

    • Operations that you performed from the Eclipse interface.

    • Messages, such as successful completions, from the operations which you performed.

    • Error messages for the failed or problematic operations that you performed.

  4. To display Dimensions CM output in the Eclipse Console view, select Show Dimensions CM output in the Console View.

  5. Click Apply and Close.

Back to top

Set version management preferences

Define how Dimensions CM for Eclipse displays items by modifying your version management preferences.

To modify the version management preferences:

  1. In Eclipse, select Window > Preferences.

  2. In the Preferences dialog box, expand Version Control (Team) > Dimensions and select Version Management.

  3. Set the following preferences:

    Preference Description
    Delete unmanaged resources on replace Deletes all files in your local workspace when you perform a replace.
    Consider file contents in comparisons Evaluates the contents of two files if the modification time is identical when performing operations.
    Attempt to find common ancestor baseline automatically Enables Dimensions CM to find the common ancestor for comparisons instead of having to select it manually.
    Synchronize workspace with home stream on switching to the foreign stream Synchronizes your workspace when you switch to a foreign stream and warns you if the local workspace is out of sync with the home stream.
    Preselect project default requests where possible Enables the integration to select default requests for projects when you perform team operations.
    Clean timestamps during status update Clears the local modification status for any files that have not been changed since they were last retrieved from the repository, but for which the timestamp has been updated (or touched).
    Undo checkout on checkin of files without changes Automatically undoes the checkout of any unchanged files when attempting to check in locked files.
    Expand substitution variables

    Expands all substitution variables in source files by default.

    Avoid using non-reversible substitutions, as these are not removed when you commit changes to the repository.
    Auto share on import

    Automatically shares projects imported into Eclipse with Dimensions CM.

    For details, see Use Eclipse projects with shared work areas.

  4. Expand the Versions Management node.

  5. Select Appearance. Then choose from the following preferences:

    Preference Description
    Save dirty edits before Dimensions CM operations Determines if Dimensions CM must automatically save the unsaved updates before performing the Dimensions CM source control operation. The options are Never, Prompt, or Auto save.
    Show project and Baseline lists in Enables you to choose whether to open project and baseline lists in the editor or in the view (which is usually right-bottom and smaller).
    Use multipage layout Causes different lists of projects or baselines to be displayed in a single view or editor with tabs at the bottom. If disabled, each has its own view or editor.
    Automatically start Dimensions CM Context

    Opens the Dimensions CM Context view whenever you select a project or baseline.

    For details, see Open Dimensions CM Context view.
    Maximum number of comments to remember Specifies the number of entries to remember in the Choose a previously entered comment list in the Commit wizard.

  1. (Optional) By default, Dimensions CM for Eclipse attempts to automatically merge all non-conflicting changes when you perform an update. To change this behavior, select Dimensions Project and clear the option.

  2. Select File Modification. Then set how Eclipse responds when you attempt to edit read-only files:

    • Select to check out to make writeable, make writeable, or prompt when you attempt to modify a read-only file, which is under Dimensions CM control.

    • Select to make writable, or prompt when you attempt to modify a read-only file, which is not under Dimensions CM control.

    • Select to make writable, or prompt when you attempt to modify a read-only file, which is checked out from Dimensions CM.

  1. Select Label Decorations to set Dimensions CM decorator preferences:

    Preference Action
    Show deep status for folders Displays composite status for the folders.

    Always show deep status for projects

    Displays composite status for the children.

    Note: The preference Always show deep status for projects overrides Show deep status for folders for project nodes if the latter is disabled and causes projects (but not folders) to display cumulative status.
    Show remote info for projects Displays connection details for a project.
    Show base revision for files Displays the base revision of the file that was fetched in ( ).
    Show remote revisions for files Displays the file is different from remote revision by stating remote revision number in [ ].
    Show locally modified status as text Marks locally modified files with a text decoration (>).
    Show locally modified status as image Marks locally modified files by changing the file icon. The icon contains a pen symbol on the top right.
    Show local mode Marks files that are in local mode by changing the file icon. The icon contains a wrench.

  1. Select Requests to set preferences for requests:

    Preference Action
    Use favorites by default

    Enables you to use requests from your favorites or inbox when checking out and checking in files.

    The option is enabled by default.
    Show project id on request selection page Shows or hides the Project column on the Relate Requests page of the Commit wizard. The Project column displays the Dimensions CM project of each resource.
    Remove from my favorites after successful checkin/commit operations Removes requests from your favorites after you have successfully checked in or committed files that are related to those requests as In Response To.
  2. Click Apply and Close.

Back to top