匯入和匯出流程組態 [witadmin]
您可以自訂處理序組態,來修改透過 Team Web Access (TWA) 檢視的 Agile 規劃工具頁面顯示方式。 有些其他工具會要求您將工作流程狀態對應到轉移狀態對應。
如需如何自訂 Agile 規劃工具頁面的概觀,請參閱設定及自訂 Team 專案的 Agile 計劃工具.
注意事項 |
---|
如果您收到錯誤訊息 TF400917,則表示 TWA 中存在無效的組態。使用 witadmin importcommonprocessconfig,將流程組態檔重新匯入 Team 專案。您將會看到解決錯誤所需的訊息。 |
若要管理 Team 專案的流程組態,請使用 witadmin 命令列工具,以匯出及匯入流程組態 XML 定義檔。 若要了解處理序組態的詳細資訊,請參閱處理序組態 XML 元素參考.
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 定義檔路徑及名稱。
|
||
/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 命令連同其對應的組態檔皆已被取代:
|
如果您正在更新已升級的 Team 專案,請參閱在 TFS 升級後設定功能.
如果您在升級至 TFS 2013.3 之後存取現有的測試計劃或測試套件時發生問題,請參閱手動更新 Team 專案以支援測試管理.
範例
下列值適用於每一個範例:
集合的 URL:http://AdventureWorksServer:8080/tfs/DefaultCollection
Team 專案:Contoso
伺服器網站的連接埠號碼:8080
將欄位加入快速加入面板
您可以對快速加入面板加入任何欄位。 例如,下列範例是將 [商務價值] 加入至產品待處理項目 (Backlog) 面板。
對於,面板只會顯示包含在所選取 WIT 之 WIT 定義 FIELDS 區段中的欄位。 例如,如果您選取 Bug WIT,則只會顯示 [標題],因為並未對 Bug 定義商務價值。 若要將其他 WIT 加入至面板,請將其加入至 [需求分類],如此處所述。
如果您沒有 Team 專案的系統管理權限,請取得這些權限。
開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗,並輸入:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
在 Windows 32 位元版本中,將 %programfiles(x86)% 取代為 %programfiles%。 您可以免費下載 Team Explorer。
匯出流程組態檔。
witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
CollectionURL 的範例為 http://MyServer:8080/tfs/TeamProjectCollectionName。
將欄位參考名稱加入 AddPanel 區段。
例如,下列語法會將 [Priority] 項目加入面板。
<AddPanel> <Fields> <Field refname="System.Title" /> <Field refname="Microsoft.VSTS.Common.BusinessValue" /> </Fields> </AddPanel>
祕訣:
您可以使用這個索引查詢欄位的參考名稱。
加入針對需求分類定義之工作項目類型的所有必要欄位。 這樣一來,您可以避免在透過面板加入待處理項目時,必須開啟工作項目表單以進行填寫。
匯入流程組態檔。
witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
重新整理待處理項目頁面,以檢視更新的面板。
更新轉移狀態對應以支援 Test Manager
如果您自訂測試計劃或測試套件的 WORKFLOW 區段,則必須將狀態對應到轉移狀態。 這可支援版本為 Visual Studio 2013.2 或更早之前版本的 Test Manager 用戶端。
在下列範例中,已更新測試計劃工作流程來使用 [設計]、[測試中] 和 [已簽核] 狀態。 為支援回溯相容性,TestPlanWorkItems 會加入處理序組態定義的 ProjectProcessConfiguration 區段。
WORKFLOW |
轉移狀態對應 |
---|---|
|
|
如果您修改測試套件工作流程,則必須在想要對應新的狀態時,進行類似更新。 您應在 TestSuiteWorkItems 區段內加入它。 請參閱 處理序組態 XML 元素參考。
問與答
問:在 TFS 升級之後,我如何進行自訂且仍使用設定功能精靈更新我的 Team 專案?
**答:**您可以自訂快速加入面板。 設定功能精靈會更新您的 Team 專案,且您可以存取最新的功能。
其他變更可能需要您在更新 Team 專案時執行部分手動作業。 若要了解您可以安全地進行哪些自訂,以及您應該避免哪些自訂的詳細資訊,請參閱自訂工作追蹤經驗:請先了解維護和升級的含意再進行自訂。
問:需要在何時將工作流程狀態對應至轉移狀態?
**答:**當您在下列 WIT 中加入或移除工作流程狀態時,應考慮更新處理序組態以加入或移除相對應的轉移狀態對應。
屬於需求分類或工作分類的 WIT:轉移狀態對應可支援顯示 Agile 規劃工具。
屬於 Bug 分類的 WIT:支援 [我的工作] 工具 (Agile 與 CMMI 式 Team 專案) 的轉移狀態對應。
測試計劃與測試套件:只有在您支援從根據 Visual Studio 2013.2 或更早版本的 Test Manager 版本,連接至 TFS 的小組成員時,才必須對應這些 WIT 的工作流程更新。
只有升級到 TFS 2013.3 才可使用測試計劃與測試套件 WIT,其可從此下載頁面 (英文) 取得。
如果您在連接到 Team 專案時收到 [應用程式偵測到未預期的錯誤],請更新轉移狀態對應。
如何解決處理序組態錯誤?
**答:**當您對 Team 專案進行下列其中一項變更時,將需要更新 WIT、分類或處理序組態的定義。 為避免發生錯誤,請務必依照下列順序進行變更:(1) WIT、(2) 分類及 (3) 處理序組態。
自訂 |
更新或確認 WIT 定義 |
更新或確認處理序組態定義 |
---|---|---|
將 WIT 加入需求分類 (WIT 可以屬於需求分類或工作分類,但不能同時屬於兩者。) |
若要包括下列欄位:
|
若要包含必要的轉移狀態對應:
包含要定義與 WIT 相關聯之色彩編碼的項目。 例如: <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" /> |
變更需求分類中 WIT 的工作流程 |
N/A |
若要包含必要的轉移狀態對應 (如上所述),以將 WIT 加入需求分類。 |
將 WIT 加入工作分類 |
若要包括下列欄位:
|
若要包含必要的轉移狀態對應:
包含要定義與 WIT 相關聯之色彩編碼的項目。 例如: <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" /> |
變更工作分類中 WIT 的工作流程 |
N/A |
若要包含必要的轉移狀態對應 (如上所述),以將 WIT 加入工作分類。 |
將 WIT 加入 Bug 分類 (僅限 Agile 和 CMMI) 變更 Bug 分類中 WIT 的工作流程 (僅限 Agile 和 CMMI) |
N/A |
若要包含必要的轉移狀態對應:
若要進一步了解,請參閱使用我的工作支援 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 加入待處理項目或工作面板.