匯入和匯出流程組態 [witadmin]

  • 發行項

您可以自訂處理序組態，來修改透過 Team Web Access (TWA) 檢視的 Agile 規劃工具頁面顯示方式。 有些其他工具會要求您將工作流程狀態對應到轉移狀態對應。

如需如何自訂 Agile 規劃工具頁面的概觀，請參閱設定及自訂 Team 專案的 Agile 計劃工具.

注意事項注意事項

如果您收到錯誤訊息 TF400917，則表示 TWA 中存在無效的組態。使用 witadmin importcommonprocessconfig，將流程組態檔重新匯入 Team 專案。您將會看到解決錯誤所需的訊息。

若要管理 Team 專案的流程組態，請使用 witadmin 命令列工具，以匯出及匯入流程組態 XML 定義檔。 若要了解處理序組態的詳細資訊，請參閱處理序組態 XML 元素參考.

用於自訂 WIT 物件的處理序

  • exportprocessconfig：將流程組態定義匯出至 XML 檔案或命令提示字元視窗。

  • importprocessconfig：匯入流程組態定義 XML 檔案。

若要執行 witadmin 命令列工具，請開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

在 Windows 32 位元版本中，將 %programfiles(x86)% 取代為 %%programfiles%。

需求

  • 若要匯出流程組態定義，您必須是 Team 專案或集合的有效使用者。

  • 若要匯入流程組態定義，您必須是下列安全性群組的成員：[Team Foundation Administrators] 或 [Project Administrators]。

如需詳細資訊，請參閱Team Foundation Server 的權限參考。

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding] 

witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

參數

參數

描述

/collection:CollectionURLx

必要項。 指定集合的 URL。 您必須以下列格式指定 URI：http://ServerName:Port/VirtualDirectoryName/CollectionName

如果您未指定虛擬目錄，則必須以下列格式指定 URI：

http://ServerName:Port/CollectionName。

/p:ProjectName

必要項。 指定要為其匯出或匯入處理序組態的 Team 專案。 這個 Team 專案必須在使用 /collection 參數所指定的集合中定義。 指定 /v 參數時，無需指定 Team 專案。

/f:FileName

要匯出或匯入之流程組態的 XML 定義檔路徑及名稱。

注意事項注意事項

如果用戶端電腦執行 Windows Vista，您可能沒有某些資料夾的權限。如果您嘗試將全域清單匯出至您沒有權限的位置，登錄模擬技術會自動重新導向已匯出的檔案，並將其儲存至虛擬存放區。如需詳細資訊，請參閱 Microsoft 網站上的下列頁面：登錄模擬 (英文) 及 Windows Vista 中常見的檔案及登錄模擬問題。若要避免重新導向，您可以將檔案匯出至您有權限的位置。

/e:Encoding

選擇項。 .NET Framework 2.0 編碼格式的名稱。 指定的編碼方式將會用來匯出或匯入 XML 資料。 例如，/e utf-7 會指定 Unicode (UTF-7) 編碼。 如果您省略這個參數，witadmin 會嘗試偵測編碼，如果偵測失敗，則會使用 UTF-8。

/v

選擇項。 驗證定義流程組態的 XML，但不匯入定義檔。

/? 或 help

顯示 [命令提示字元] 視窗中命令的說明。

備註

注意事項注意事項

安裝 VS TFS 2013 會升級現有的 Team 專案。這些專案會使用流程組態檔，此流程組態檔會結合敏捷式組態檔與 TFS 2012 中支援的常見組態檔。下列 witadmin 命令連同其對應的組態檔皆已被取代：

  • exportagileprocessconfig

  • exportcommonprocessconfig

  • importagileprocessconfig

  • importcommonprocessconfig

如果您正在更新已升級的 Team 專案，請參閱在 TFS 升級後設定功能.

如果您在升級至 TFS 2013.3 之後存取現有的測試計劃或測試套件時發生問題，請參閱手動更新 Team 專案以支援測試管理.

範例

下列值適用於每一個範例：

  • 集合的 URL：http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Team 專案：Contoso

  • 伺服器網站的連接埠號碼：8080

將欄位加入快速加入面板

您可以對快速加入面板加入任何欄位。 例如，下列範例是將 [商務價值] 加入至產品待處理項目 (Backlog) 面板。

已加入 [商務價值] 欄位的 [待處理項目] 面板

對於，面板只會顯示包含在所選取 WIT 之 WIT 定義 FIELDS 區段中的欄位。 例如，如果您選取 Bug WIT，則只會顯示 [標題]，因為並未對 Bug 定義商務價值。 若要將其他 WIT 加入至面板，請將其加入至 [需求分類]，如此處所述。

  1. 如果您沒有 Team 專案的系統管理權限，請取得這些權限。

  2. 開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：

    cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

    在 Windows 32 位元版本中，將 %programfiles(x86)% 取代為 %programfiles%。 您可以免費下載 Team Explorer。

  3. 匯出流程組態檔。

    witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"

    CollectionURL 的範例為 http://MyServer:8080/tfs/TeamProjectCollectionName。

  4. 將欄位參考名稱加入 AddPanel 區段。

    例如，下列語法會將 [Priority] 項目加入面板。

    <AddPanel>
   <Fields>
      <Field refname="System.Title" />
      <Field refname="Microsoft.VSTS.Common.BusinessValue" />
   </Fields>
</AddPanel>

    祕訣：

    • 您可以使用這個索引查詢欄位的參考名稱。

    • 加入針對需求分類定義之工作項目類型的所有必要欄位。 這樣一來，您可以避免在透過面板加入待處理項目時，必須開啟工作項目表單以進行填寫。

  5. 匯入流程組態檔。

    witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"

  6. 重新整理待處理項目頁面，以檢視更新的面板。

更新轉移狀態對應以支援 Test Manager

如果您自訂測試計劃或測試套件的 WORKFLOW 區段，則必須將狀態對應到轉移狀態。 這可支援版本為 Visual Studio 2013.2 或更早之前版本的 Test Manager 用戶端。

在下列範例中，已更新測試計劃工作流程來使用 [設計]、[測試中] 和 [已簽核] 狀態。 為支援回溯相容性，TestPlanWorkItems 會加入處理序組態定義的 ProjectProcessConfiguration 區段。

WORKFLOW

轉移狀態對應

 
<WORKFLOW>
      <STATES>
        <STATE value="Design" />
        <STATE value="Testing" />
        <STATE value="Signed Off" />
      </STATES>
      <TRANSITIONS>
        <TRANSITION from="" to="Design">
          <REASONS>
            <DEFAULTREASON value="New test plan" />
          </REASONS>
        </TRANSITION>
     <TRANSITION from="Design" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Authoring complete" />
          </REASONS>
        </TRANSITION>        
     <TRANSITION from="Testing" to="Signed Off">
          <REASONS>
            <DEFAULTREASON value="Signed Off testing" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Design">
          <REASONS>
            <DEFAULTREASON value="Reactivating to authoring phase" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Reactivating to run tests" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Testing" to="Design">
          <REASONS>
            <DEFAULTREASON value="Back to authoring" />
          </REASONS>
        </TRANSITION>
      </TRANSITIONS>
    </WORKFLOW>
 
<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">
    <States>
      <State type="InProgress" value="Design" />
      <State type="InProgress" value="Testing" />
      <State type="Complete" value="Signed Off" />
    </States>
  </TestPlanWorkItems>
<TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">
    <States>
      <State type="Proposed" value="In Planning" />
      <State type="InProgress" value="In Progress" />
      <State type="Complete" value="Completed" />
    </States>
  </TestSuiteWorkItems>

如果您修改測試套件工作流程，則必須在想要對應新的狀態時，進行類似更新。 您應在 TestSuiteWorkItems 區段內加入它。 請參閱 處理序組態 XML 元素參考。

問與答

問：在 TFS 升級之後，我如何進行自訂且仍使用設定功能精靈更新我的 Team 專案？

**答：**您可以自訂快速加入面板。 設定功能精靈會更新您的 Team 專案，且您可以存取最新的功能。

其他變更可能需要您在更新 Team 專案時執行部分手動作業。 若要了解您可以安全地進行哪些自訂，以及您應該避免哪些自訂的詳細資訊，請參閱自訂工作追蹤經驗：請先了解維護和升級的含意再進行自訂。

問：需要在何時將工作流程狀態對應至轉移狀態？

**答：**當您在下列 WIT 中加入或移除工作流程狀態時，應考慮更新處理序組態以加入或移除相對應的轉移狀態對應。

  • 屬於需求分類或工作分類的 WIT：轉移狀態對應可支援顯示 Agile 規劃工具。

  • 屬於 Bug 分類的 ＷIT：支援 [我的工作] 工具 (Agile 與 CMMI 式 Team 專案) 的轉移狀態對應。

  • 測試計劃與測試套件：只有在您支援從根據 Visual Studio 2013.2 或更早版本的 Test Manager 版本，連接至 TFS 的小組成員時，才必須對應這些 WIT 的工作流程更新。

    只有升級到 TFS 2013.3 才可使用測試計劃與測試套件 WIT，其可從此下載頁面 (英文) 取得。

    如果您在連接到 Team 專案時收到 [應用程式偵測到未預期的錯誤]，請更新轉移狀態對應。

    在 TFS 升級之後的應用程式錯誤 (fault) 的錯誤 (error) 訊息

如何解決處理序組態錯誤？

**答：**當您對 Team 專案進行下列其中一項變更時，將需要更新 WIT、分類或處理序組態的定義。 為避免發生錯誤，請務必依照下列順序進行變更：(1) WIT、(2) 分類及 (3) 處理序組態。

自訂

更新或確認 WIT 定義

更新或確認處理序組態定義

將 WIT 加入需求分類

(WIT 可以屬於需求分類或工作分類，但不能同時屬於兩者。)

若要包括下列欄位：

  • 待處理項目優先權 (Scrum) 或堆疊順位 (Agile 或 CMMI)

    (必須符合處理序組態檔中指派給 type=Order 的欄位值)

  • 投入時間 (Scrum)、劇本點數 (Agile) 或大小 (CMMI)

    (必須符合處理序組態檔中指派給 type=Effort 的欄位值)

  • 處理序組態檔中指派給 type=Team 的區域路徑或欄位值

  • 處理序組態檔的 AddPanel 區段中包括的所有欄位 (欄位必須在 FIELDS 區段內定義，但不必包含在 FORM 區段內。

若要包含必要的轉移狀態對應：

  • 將每個工作流程狀態的開頭對應到 type="Proposed"

  • 將每個您顯示在看板上的中繼工作流程狀態，對應到 type="InProgress"

  • 將每個工作流程狀態的結尾對應到 type="Complete"

    您只能有一個對應到 type="Complete" 的狀態

包含要定義與 WIT 相關聯之色彩編碼的項目。 例如：

<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

變更需求分類中 WIT 的工作流程

N/A

若要包含必要的轉移狀態對應 (如上所述)，以將 WIT 加入需求分類。

將 WIT 加入工作分類

若要包括下列欄位：

  • 待處理項目優先權 (Scrum) 或堆疊順位 (Agile 或 CMMI)

  • 活動 (Scrum 或 Agile) 或專業領域 (CMMI)

    (必須符合處理序組態檔中指派給 type=Activity 的欄位值)

  • 剩餘工作

    (必須符合處理序組態檔中指派給 type=RemainingWork 的欄位值)

  • 處理序組態檔中指派給 type=Team 的區域路徑或欄位值

  • (選用) 原始工作和完成的工作 (僅限 Agile 和 CMMI)

若要包含必要的轉移狀態對應：

  • 將每個工作流程狀態的開頭對應到 type="Proposed"

  • 將每個您要顯示在工作面板上的中繼工作流程狀態，對應到 type="InProgress"

  • 將每個工作流程狀態的結尾對應到 type="Complete"

    您只能有一個對應到 type="Complete" 的狀態

包含要定義與 WIT 相關聯之色彩編碼的項目。 例如：

<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />

變更工作分類中 WIT 的工作流程

N/A

若要包含必要的轉移狀態對應 (如上所述)，以將 WIT 加入工作分類。

將 WIT 加入 Bug 分類 (僅限 Agile 和 CMMI)

變更 Bug 分類中 WIT 的工作流程 (僅限 Agile 和 CMMI)

N/A

若要包含必要的轉移狀態對應：

  • 將每個工作流程狀態的開頭對應到 type="Proposed"

  • 將每個您要為 [我的工作] 顯示的中繼工作流程狀態，對應到 type="InProgress"

  • 將每個工作流程狀態的結尾對應到 type="Complete"

    您只能有一個對應到 type="Complete" 的狀態

若要進一步了解，請參閱使用我的工作支援 Bug 更新狀態。

從需求分類或工作分類移除 WIT

N/A

移除只與該 WIT 相關聯的所有轉移狀態對應

從 Team 專案移除 WIT

從分類檔移除 WIT。

移除只與您所移除的 WIT 相關聯之所有轉移狀態對應，以及定義您所移除之 WIT 的色彩編碼之 WorkItemColor 項目。

問：如何自訂在 TWA 中出現於敏捷式軟體開發規劃工具上的其他功能？

**答：**有些自訂可以透過使用者介面進行。 其他自訂則需要編輯流程組態或其他 Team 專案物件。 如需概觀說明，請參閱設定及自訂 Team 專案的 Agile 計劃工具.

問：您是否要使用兩個以上的 Portfolio 待處理項目 (Backlog)？

**答：**預設經驗支援一個層級的 Portfolio 待處理項目 (Backlog)。 最多可以加入五個層級，如下所述：將待處理項目加入至 Agile Portfolio 管理.

問：是否要加入或變更出現在工作面板或產品待處理項目 (Backlog) 中的 WIT？

**答：**如果加入了自訂 WIT，您可以將其加入至待處理項目 (Backlog) 或工作面板。 您無法讓其顯示在兩個位置。 閱讀下列資訊以了解做法：將 Bug 加入待處理項目或工作面板.