Importing but not synchronizing records

You can use the batch synchronization tool to create IBM® Engineering Workflow Management (EWM) items that correspond to ClearQuest® records even if you do not enable the ClearQuest user database for use with the ClearQuest Synchronizer.

About this task

As you begin to use EWM as your development environment, you might want to replicate the content of ClearQuest records inEWM work items, and then maintain those work items by working solely in EWM. If you do not want to synchronize those records and work items, you can use the batch synchronization tool on a ClearQuest user database without applying the JazzInterop package to your schema and upgrading the user database to the new version of that schema.

Before you can run the batch synchronization tool, you still need to create an external repository connection; edit the cqconnector.properties file; start the ClearQuest Gateway; and create synchronization rules.

Because you do not apply the JazzInterop package to your schema and upgrade the user database, the Synchronization Rule editor does not contain values in the following fields:

  • External type
  • External property
  • External Value

You need to enter, rather than select, values in these fields. In the Synchronization field of the Mapping Details section, select In.

When you run the batch synchronization tool on a record type that does not have the JazzInterop package applied to it, the syntax is as follows:

synctool recordType=record-type-name jazzServer=url projectArea=project-area-name [query=query-name] 

When you run the batch synchronization tool on a record type that does not have the JazzInterop package applied to it, the batch synchronization tool ignores the cq.queryTreeRoot parameter setting in the cqconnector.properties file. If you want to filter the records to be imported, you must specify a query with the query parameter. That query can be stored in any folder; it does not have to be stored according to the folder hierarchy requirements detailed for using the cq.queryTreeRoot parameter. If you do not specify a query, all records of the specified record type are imported.

If you have a very large number of records of the record type to import, consider running the batch synchronization tool multiple times, changing the query each time, so that each invocation selects a subset of the total number. For example, you might adjust the query to select records based on creation date. Also be sure to define the queries so that they select only records that you plan to work on in EWM. Typically, you would not need to include records in a closed state.

Results

Because you do not apply the JazzInterop package to your schema and upgrade the user database, any changes that you make to work items created by the batch synchronization tool are not propagated to ClearQuest records. Similarly, any changes that you make to ClearQuest records are not propagated to EWM work items.

Alternatively, you can use the ClearQuest Import Wizard to import ClearQuest records into EWM.