This file contains information on the Serena Dimensions CM integrations with Eclipse and Eclipse-based products such as WebSphere Application Developer and Rational XDE.
IMPORTANT!
There are two Eclipse integrations available with Dimensions Version 10.x:
Rich Eclipse Integration which contains a full featured Java plug-in which allows you to perform both source control and issue management directly from the Eclipse interface. The Rich Integration is compatible with Eclipse 3.0 (and 3.1) and products based on Eclipse 3.0 (and 3.2). See the part titled Rich Eclipse Integration for more information on this integration.
XDE Eclipse Integration which allows only SCC source control operations from the Eclipse interface. This integration is compatible with Eclipse 2.x and products based on Eclipse 2.x. See the part titled XDE Eclipse Integration for more information on this integration.
Note The two versions of integration are not compatible with each other. If you are sharing files with another developer, you must use the same version of the integration. For example, if you are running Eclipse 3.0 but the other developer, whom is concurrently working on the same product with you, is running Rational XDE (based on Eclipse 2.x), then you must use to Eclipse 2 integration as well.
If you plan to use the new Rich Eclipse Integration plug-in and you have existing projects that were used with the Eclipse Plug-in with Dimensions 9, you must upgrade your existing Dimensions-Eclipse projects. See the Serena Support site (support.serena.com)for more details on upgrading the existing projects to work with the Rich Integration.
To contact technical support, go to support.serena.com.
Part 1: Rich Eclipse Integration
Part 2: XDE Eclipse Integration
Part 1: Rich Eclipse Integration |
The Rich Eclipse Integration is a new integration between Eclipse and Dimensions, which contains a full range of features including both issue and version management. The features are available directly from the Eclipse environment.
This release supports mapping multiple Eclipse projects to one Dimensions CM Project, using Eclipse Project Containers. This uses the same mechanism as the Dimensions 9 Eclipse Plugin. Projects mapped in this way behave identically to the Dimensions 10.1 Eclipse projects that are mapped one to one with a Dimensions CM Project (Single Eclipse Projects). The key difference is that the Branch from workspace operation is not available for contained projects.
IMPORTANT! If you used the prior version of the Eclipse Plug-in with Dimensions 9, you must upgrade your existing Dimensions-Eclipse projects. See the Serena Support site (support.serena.com)for more details on upgrading existing projects. There are two mechanisms: upgrading marks the Dimensions CM project containing existing SCC Eclipse projects as an Eclipse Project Container allowing them to be used unchanged in the Rich Integration, and Conversion which converts multiple SCC Eclipse Projects to individual Single Eclipse Projects.
See the Serena Dimensions CM for Eclipse Integration Guide for information on configuring and using the rich integration with Eclipse.
The Rich Integration for Eclipse is supported on Eclipse 3.0, 3.1, and 3.2.
The integration supports Eclipse 3.0 (and 3.2) based products such as Rational Application Developer 6.0. Rational Application Developer 7.0 is also supported.
Please see the Serena Dimensions CM for Eclipse User’s Guide for information on installing, configuring and using the Rich Eclipse integration. The manual is available for download as a PDF file from the same location as the software, and as part of the documentation installation option when you install Dimensions.
Note This issue discusses how to set File Content Encodings.
Eclipse supports a number of file encodings. By default these are not passed on to Dimensions. If content encoding support when adding files to the repository is required, edit the file plugin.properties in the following directory:
<Dimensions_Install>\Integrations\RichEclipse3.x\eclipse\plugins\com.serena.eclipse.dimensions.team.core_3.0.0.100100
By adding the following line to the file:
use_content_encoding=true
With this set, the Eclipse Content Encoding set on the Eclipse resource will be passed onto Dimensions. If Eclipse content encoding is changed between revisions or on fetching files to a clean workspace, it must be changed in the Eclipse File, Folder or Workspace properties to allow Eclipse to recognize and Display files correctly.
Part 2: XDE Eclipse Integration |
The XDE Eclipse Integration works with Dimensions 10.1. It does not contain any new functionality from the previous release of the integration.
The XDE Integration for Eclipse is supported on Eclipse 2.x and Eclipse 3.0.
The integration supports Eclipse 2.x based products such as Rational XDE.
Note This integration works with Eclipse 3.0; however, it is recommended that you use the Dimensions for Eclipse 3.0 plug-in with the newer version of Eclipse. This plug-in is a rich integration and contains an issue management integration in addition to the version management integration contained in the Eclipse 2.0 integration.
Before you begin using the integration between Eclipse and Dimensions, perform the following steps to install and configure your integration:
See the Serena Dimensions CM Installation Guide for more information on installing the Dimensions desktop client and the Dimensions SCC Integration.
Install the Eclipse integration component. This component is necessary to use the integration and select Dimensions as your VCS.
The Eclipse Integration component can be found on the Serena Support web site at http://support.serena.com or on your Dimensions Installation DVD.
Note When you install the Eclipse integration, you will be prompted for the Eclipse directory. This directory must be named Eclipse and contain the file, .eclipseproduct. If the directory lacks either of these requirements, it will not install into that directory.
See the Serena Dimensions CM Integrated Products Guide for additional information on configuring and using the integration with Eclipse 2 Compatible products.
The Serena Dimensions CM Integrated Products Guide contains a chapter on setting up and using the source control integration to Eclipse 2 Products. The manual is available for download as a PDF file from the same location as the software, and as part of the documentation installation option when you install Dimensions CM.
End Readme
Copyright © 2007 Serena Software, Inc. All rights reserved.