Linking work items to Subversion repositories

If you add a Subversion client for Eclipse to your EWM installation, you can link work items to Subversion revisions.

Before you begin

You must install a Subversion client for Eclipse in the same Eclipse instance where you run the IBM® Engineering Workflow Management (EWM) client. Supported Subversion clients include:

Subclipse, available from the Subclipse project page.
Subversive, available from the Eclipse website.

About this task

EWM includes a Jazz SVN Connections view that you can use to establish a connection between a Jazz® repository and a Subversion repository. You can use this connection to link any Subversion revision to a work item, and to open a work item from the History view of a Subversion client for Eclipse.

Procedure

To link a Jazz repository to a Subversion repository:
1. Open the Jazz SVN Connections view: click Window > Show View > Other. In the Show View window, expand Jazz Source Control and double-click Jazz SVN Connections.
2. Right-click a repository connection in the Jazz SVN Connections view and click New > SVN Connection. Enter the URL of your Subversion repository.
  A connection is created between the two repositories. A scheduled task running on the Jazz Team Server scans the latest revisions in the Subversion repository and creates links between revisions and work items. To request an immediate scan, right-click a Subversion repository connection in the Jazz SVN Connections view and click Update Links. After the scan is complete, any links that the scan detected are added to work items, and the label of the Subversion repository connection is updated to indicate when the scan was completed.
To link a Subversion revision to a work item:
1. In the Eclipse Navigator view (or any Eclipse view that supports Team operations), right-click a Subversion project and click Properties.
2. On the Jazz Work Items page, select your Jazz repository from the list, and click OK. This adds Subversion bugtraq properties to the project, which support linkage with work items. This addition results in an outgoing change to the project (you might need to right-click the project and click Team > Update or Refresh to make the outgoing change visible in the IDE).
3. Click Team > Commit to commit the change.
  The Subversion commit window displays a field for the work item number. Enter a work item number and click OK.
To open a work item from the Subversion History view:
1. In the Eclipse Navigator view (or any Eclipse view that supports Team operations), right-click the project and click Team > Show History.
  The work item that is associated with the revision is shown as the last line in the comment.
2. Adding a link from a revision to a work item does not require that a reference to the work item is in the revision comment. From the menu of a revision in the History view, choose Associate Work Item to add the link manually.
To update work item links, right-click a repository connection in the Jazz SVN Connections view and click Update Links.
Note: The Update Links action attempts to run a server-side process to find work item links in the Subversion revision comments. However, this server-side process only completes if a connection is made to the Subversion repository without authenticating. If authentication is required, you are prompted to run the scan from the client. When the scan runs from the client, it uses your authentication information to scan the repository. The scan uploads any links that it finds to the Jazz Team Server.