建議使用 Visual Studio 2017

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

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

如需如何自訂 Agile 規劃工具頁面的概觀,請參閱Configure and customize Agile tools for a team project

注意事項 注意事項

如果您收到錯誤訊息 TF400917,則表示出現無效的組態。 使用 witadmin importprocessconfig,將流程組態檔重新匯入 Team 專案。 您將會看到解決錯誤所需的訊息。

若要管理 Team 專案的流程組態,請使用 witadmin 命令列工具,以匯出及匯入流程組態 XML 定義檔。 若要深入了解流程組態,請參閱處理序組態 XML 項目參考

用於自訂 WIT 物件的處理序
  • exportprocessconfig:將流程組態定義匯出至 XML 檔案或命令提示字元視窗。

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

只在針對內部部署 TFS 執行時,witadmin 命令列工具才有用。 若要執行這個工具,請開啟已安裝 Visual Studio 或 Team Explorer 的 [命令提示字元] 視窗並輸入:

cd %programfiles(x86)%\Microsoft Visual Studio 14.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

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

安裝最新版的 TFS 會升級現有的 Team 專案。 如果您正在更新已升級的 Team 專案,請參閱Configure features after a TFS upgrade

如果您在升級後存取現有的測試計劃或測試套件時發生問題,請參閱Update a team project manually to support test management

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

  • 集合的 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. 重新整理待處理項目頁面,以檢視更新的面板。

如果您自訂測試計劃或測試套件的 WORKFLOW 區段,則必須將狀態對應到轉移狀態。

在下列範例中,已更新測試計劃工作流程來使用 [設計]、[測試中] 和 [已簽核] 狀態。 為支援回溯相容性,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 項目參考

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

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

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

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

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

  • 測試計劃與測試套件:只有在您支援從根據 Visual Studio 2013.2 或更早版本的 Test Manager 版本,連接至 TFS 的小組成員時,才必須對應這些 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" 的狀態

若要深入了解,請參閱Support bug update status using My Work

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

N/A

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

從 Team 專案移除 WIT

從分類檔移除 WIT。

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

答:有些自訂可以透過使用者介面進行。 其他自訂則需要編輯流程組態或其他 Team 專案物件。 如需概觀,請參閱Configure and customize Agile tools for a team project

答:預設經驗支援一個層級的 Portfolio 待處理項目 (Backlog)。 最多可以加入五個層級,如下所述:Add a backlog to Agile portfolio management

答:如果加入了自訂 WIT,您可以將其加入至待處理項目 (Backlog) 或工作面板。 您無法讓其顯示在兩個位置。 如需深入了解,請參閱將工作項目類型加入至待處理項目和面板

顯示: