Using the IBM® Rational ClearQuest Synchronizer

You can integrate Rational® Quality Manager with the Rational ClearQuest® defect tracking system using the ClearQuest Synchronizer (previously called the Connector).
License note
Note: To perform the task described here, you must be assigned the Rational Quality Manager Connector Client Access License.

With the ClearQuest Synchronizer you can synchronize information between work items in Rational Quality Manager and ClearQuest records.

With the ClearQuest Synchronizer you can work in both tools and share data. Through synchronization operations, the ClearQuest Synchronizer maps Rational ClearQuest records, such as defects, to Rational Quality Manager work items. When a user creates or modifies a Rational ClearQuest record, the ClearQuest Synchronizer creates or modifies a corresponding work item in Quality Manager. The creation and modification changes also flow from work items to ClearQuest records.

The ClearQuest Synchronizer uses the ClearQuest Gateway, a server process, to communicate with the Jazz™ Server and connect ClearQuest records with work items in the Rational Quality Manager project area.

Before you can use the ClearQuest Synchronizer, you must configure your Rational ClearQuest and Rational Quality Manager environments. The ClearQuest Synchronizer includes a setup wizard that walks you through the configuration steps. The setup wizard applies the necessary package changes to your ClearQuest schema and then updates your ClearQuest user database with the new schema version.

The setup wizard also creates an initial set of synchronization rules. Synchronization rules describe how to map Rational ClearQuest record type fields to Rational Quality Manager work item type properties.

Note: To use the ClearQuest Synchronizer, you must be sure to install the Change and Configuration Management (CCM) application.

Before you attempt to configure your environments, go through the Get started with Rational ClearQuest Synchronizer tutorial. The tutorial shows you how to use the ClearQuest Synchronizer with the CCM application, but the same concepts apply to Rational Quality Manager. However, if you want to follow the tutorial using Rational Quality Manager you must first create a Defect work item type. For instructions, see Defining work items types and attributes in the web client.

Helpful links

For help with the ClearQuest Synchronizer, see the following topics in the Rational Team Concert Information Center:



Have a problem or a question? Post it in the Jazz.net forum.