This documentation is archived and is not being maintained.

Migrating from ClearQuest

The work item migration converter:

  • Reads the work items from ClearQuest

  • Writes the data into Team Foundation using the Microsoft Visual Studio Team System work item tracking Web services.

  • Migrates attachments and links.

  • Migrates duplicate work item information.

To write the data into Team Foundation, the converter replays the actions that users performed in the original work item tracking system. For example, if a work item was opened, resolved, and then closed, the converter opens the work item in Team Foundation, resolves it, and then closes and saves the work item every time. The converter preserves the user names and dates of those actions.

You can control how the data is mapped from ClearQuest to Team Foundation and can change the field values and how users are mapped. You specify the settings for the converter by editing the XML files that control how the data is migrated.

The following sections can help you migrate your work items to Team Foundation.

ClearQuest Converter Limitations

Describes limitations of the ClearQuest converter that includes a list of items that are not migrated.

Planning for Work Item Migration

Describes how to plan for a migration from ClearQuest to Team Foundation.

Migrating Work Items

Describes how to migrate work items from ClearQuest to Team Foundation.

After Migrating Work Items

Describes the tasks to do post-migration to make sure a successful migration and troubleshoot migration problems.

CQConverter Command-Line Utility for ClearQuest Database Migration

Describes the CQConverter.exe tool and provides link to topics that detail the commands and options.

Team Foundation work item tracking schema defines a specific work item type. The schema defines:

  • The fields, field names, and field types on a work item form.

  • The rules associated with a work item. For example, a work item can have a rule that the Opened Date is set to the current date when someone creates a new work item.

  • The list of supported values for a field.

  • Optional/Read-Only/Mandatory characteristics of the fields.

  • Workflow, as in the states the bug can complete; open, resolve, closed.

  • Work item form, the form used to track work items for your project.