工作項目轉換器組態檔

發行項
08/21/2008

更新：2007 年 11 月

工作項目組態檔是提供 ClearQuest 轉換器設定的 XML 檔案。本主題稍後將說明這個檔案中的區段，隨後附上的範例組態檔可讓您用來建立自己的組態檔。

組態檔區段

工作項目轉換器組態 XML 檔案包含數個區段，會指定如何將工作項目從 ClearQuest 移轉至 Team Foundation。本主題稍後會詳細說明這些區段。

<ClearQuest>

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

ConnectionName：ClearQuest 連接名稱。
UserDatabase：ClearQuest 使用者資料庫名稱。
QueryName：儲存在 ClearQuest 中的查詢名稱。
UserID：ClearQuest 使用者 ID。您必須使用 "admin" 使用者 ID，且這位使用者應該具備建立所有工作項目類型的權限。

<VSTS>

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

URI：Team Foundation Server 易記名稱或完整 URI。例如，"MyAtServer" 或 "http://MyAtServer:8080"。
ProjectName：Team Foundation 工作項目追蹤 Team 專案名稱。

其他組態設定

XML 檔案中可控制的其他區段。

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

注意事項：
這項設定僅套用至非嚴重錯誤。如果是類似 ClearQuest 轉換器無法連接到 ClearQuest 的嚴重錯誤，即使這項設定為 False，轉換器也一定會結束。

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

範例工作項目轉換器組態檔

下列是範例工作項目轉換器組態檔，可使用所有缺失查詢並透過 CQRep 連接，將 ClearQuest TEST 資料庫移轉至 Team Foundation 中的 JoseLugoProjectX Team 專案。同時指定發生錯誤時轉換器應該停止，並指定轉換器所建立之輸出檔的目錄。

<?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>