HOW TO：移轉工作項目
更新：2007 年 11 月
在分析階段之後，轉換器會針對每一個 ClearQuest 記錄類型產生工作項目類型定義 (WITD)。例如，ClearQuest Defect 記錄類型的檔案將會命名為 Defect.xml。轉換器會在分析階段的結構描述產生過程中，產生預設的工作項目表單；但是，這個預設表單的格式設定相當簡略，並有可能需要進行編輯，才能達到您要的工作項目配置。如需如何變更工作項目類型定義檔的詳細資訊，請參閱自訂 Team Foundation 的工作項目類型。
編輯工作項目配置之後，就可以將工作項目從 ClearQuest 移轉至 Team Foundation 工作項目追蹤。
必要的使用權限
若要執行這些程序，您必須是 [Service Accounts] 安全性群組的成員。如需詳細資訊，請參閱 Team Foundation Server 使用權限。此外，您也必須擁有 ClearQuest 資料庫的 [Super User] 使用權限。如需詳細資訊，請參閱 ClearQuest Administrator's Guide。
移轉 ClearQuest 工作項目
若要移轉工作項目
在命令提示字元中執行下列命令：
**CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:**path\Schemamap.xml
其中 path 是結構描述對應檔的路徑。在分析階段，會於指定的輸出目錄中產生結構描述對應檔。
.gif "注意事項")
注意事項：若為大型資料庫，ClearQuest 轉換器可能需要好幾個小時的執行時間。
當移轉完成時，請檢閱移轉報告來了解移轉狀態和其他問題 (如果有的話)，例如，由於某些欄位對應不一致，而造成無法移轉的缺失。
移轉報告名為 CQMigrationReport.xml，而且會建立於您執行 ClearQuest 轉換器所在的資料夾中。
注意事項：由於轉換器會轉換您指定之查詢中的所有工作項目，外加連結至這些工作項目的所有工作項目，實際移轉的工作項目數量可能會與查詢中的工作項目數量有所不同。
如果尚未移轉所有工作項目，可以在解決移轉報告中列出的問題之後，重新執行轉換。
若要將更多的工作項目從 ClearQuest 移轉到 Team Foundation 工作項目追蹤，您可以再次執行移轉程序。
若要在相同的 ClearQuest 資料庫上再次執行移轉
更正前次移轉中，在移轉報告列出的任何問題。
在 ClearQuest 中製作一個查詢，使其傳回所要的工作項目；如果您只需移轉第一次未移轉的工作項目，則可執行相同的查詢。
變更組態檔中的 <QueryName> 區段，以指定新的查詢名稱。
開啟命令提示字元並輸入移轉的命令：
**CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:**path\Schemamap.xml
若為大型資料庫，ClearQuest 轉換器可能需要好幾個小時的執行時間。
注意事項：如需 ClearQuest 轉換器命令的詳細資訊，請參閱用於移轉 ClearQuest 資料庫的 CQConverter 命令列公用程式。
當移轉作業完成時，請檢閱移轉報告來了解移轉狀態。移轉報告名為 CQMigrationReport.xml，而且會建立於您執行 ClearQuest 轉換器所在的資料夾中。
請參閱
工作
逐步解說：將 ClearQuest 工作項目移轉至 Team Foundation