共用方式為

HOW TO：產生轉換器組態檔

  • 發行項

更新：2007 年 11 月

轉換器組態檔是 XML 檔案，會提供 ClearQuest 轉換器的設定。會在 XML 檔案的各區段中指定設定，如下所示：

<ClearQuest>

ClearQuest 區段中包含您要移轉之 ClearQuest 資料庫的相關資訊。

  • ConnectionName：ClearQuest 連接名稱。

  • UserDatabase：ClearQuest 資料庫名稱。

  • QueryName：儲存在 ClearQuest 中的查詢名稱。

  • UserID：ClearQuest 使用者 ID (User ID)。指定的使用者 ID 必須具有 ClearQuest 資料庫的 [Super User] 權限。

<VSTS>

此 VSTS 區段包含了與 Team Foundation 工作項目追蹤伺服器以及您要移轉的目標 Team 專案有關的資訊。

  • URI：Team Foundation Server 易記名稱或完整 URI，格式為 http://MyServer:MyPort。

    如果您使用易記名稱，請務必在執行轉換器之前，已透過 Team 總管加入 Team Foundation Server。

  • ProjectName：Team Foundation 工作項目追蹤 Team 專案名稱。

其他組態設定

XML 檔案中可讓您控制的其他區段：

  • ExitOnError：這個區段接受 True 或 False的值。選取 True 結束錯誤。True 值表示如果在一些工作項目移轉中遇到錯誤，ClearQuest 轉換器就會停止。

    注意事項：

    這項設定僅套用至非嚴重錯誤。若是嚴重錯誤，例如 ClearQuest 轉換器無法連接到 ClearQuest，則即使此設定為 False，轉換器一定會結束。

  • OutputDirectory：指定您要存放移轉之檔案的目錄。如果您並未指定輸出目錄，轉換器就會以基底實體名稱建立目錄，以便產生輸出檔案。如果目錄已經存在，轉換器就會覆寫該目錄中的檔案。

必要的使用權限

若要執行此程序，您必須擁有 ClearQuest 資料庫的 [現用使用者] 和 [公用資料夾管理員] 權限。如需詳細資訊，請參閱 ClearQuest Administrator's Guide。

若要建立組態檔

  1. 收集下列資訊：

    • ClearQuest 連接名稱。

    • ClearQuest 資料庫名稱。

    • ClearQuest 系統管理員的使用者 ID 和密碼。請確定這個使用者擁有在 ClearQuest 中提出問題的使用權限。

    • Team Foundation 伺服器名稱。

    • Team Foundation 工作項目追蹤 Team 專案名稱 (您想要移轉工作項目的目標 Team 專案)。

  2. 在 ClearQuest 中建立查詢，以選取要移轉至 Team Foundation 工作項目追蹤的工作項目並儲存查詢。用任何名稱來儲存查詢，例如 TransitionQuery。

  3. 選取目錄，這個目錄是用來存放分析階段所產生的檔案。

  4. 將下列 XML 組態檔複製到文字編輯器：

    <?xml version="1.0" encoding="utf-8"?>
<WorkItemConverter>
  <Source id="ClearQuest">
    <ClearQuest>
      <ConnectionName>CQRep</ConnectionName> 
      <UserDatabase>TEST</UserDatabase> 
      <QueryName>Public Queries/All Defects</QueryName> 
      <UserID>admin</UserID>
    </ClearQuest>
  </Source>
  <VSTS>
    <URI>JoseLugo</URI>
    <ProjectName>JoseLugoProjectX</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>

  5. 變更此檔，使用之前步驟所收集到的資訊來指定設定值。例如，在 <QueryName> 底下，將查詢名稱指定為 TransitionQuery，包括查詢路徑。如需每一個區段應該包含哪些內容的詳細資訊，請參閱本主題之前的「組態檔」一節。

    注意事項：

    檔案中不需要輸入密碼，ClearQuest 轉換器工具稍後會在移轉過程中會要求您提供密碼。

  6. 儲存檔案，例如儲存為 CqConverterConfig.xml。

注意事項：

使用 UTF-8 編碼方式來儲存檔案。例如，如果您使用 [記事本] 來儲存檔案，請在 [另存新檔] 對話方塊中，選取 [編碼] 方塊內的 [UTF-8]。

請參閱

其他資源

工作項目類型定義結構描述