Serena® Dimensions┬« CM
Integration for Eclipse Readme

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:

 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.


Table of Contents

Part 1: Rich Eclipse Integration
Part 2: XDE Eclipse Integration

 

Part 1: Rich Eclipse Integration

1.0 What's New in the Integration?

2.0 Supported Platforms

3.0 Installing the Integration

4.0 Documentation Updates

5.0 Known Issues

5.1 Support of File Content Encodings

 

Part 2: XDE Eclipse Integration

6.0 What's New in the Integration?

7.0 Supported Platforms

8.0 Installing the Eclipse XDE Integration

9.0 Documentation

10.0 Known Issues

 

 

Part 1: Rich Eclipse Integration

Return to Contents


1.0 What's New in the 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.

Return to Contents


2.0 Supported Platforms

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.

Return to Contents


3.0 Installing the Integration

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.

Return to Contents


5.0 Known Issues

5.1 Support of File Content Encodings

 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

Return to Contents


6.0 What's New in the Integration?

The XDE Eclipse Integration works with Dimensions 10.1. It does not contain any new functionality from the previous release of the integration.

Return to Contents


7.0 Supported Platforms

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.

Return to Contents


8.0 Installing the Eclipse XDE Integration

Before you begin using the integration between Eclipse and Dimensions, perform the following steps to install and configure your integration:

  1. Install the Dimensions desktop client and Dimensions SCC Integration on the same system as Eclipse.

See the Serena Dimensions CM Installation Guide for more information on installing the Dimensions desktop client and the Dimensions SCC Integration.

  1. 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.

Return to Contents


9.0 Documentation

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.