匯入和匯出全域工作流程 [witadmin]

使用全域工作流程,可以將此作業所需的工作減到最少:定義及更新多個 Team 專案和工作項目類型共用的工作項目欄位和全域清單。 您可以使用全域工作流程,定義及更新欄位和全域清單。 您可以在 witadmin 命令列工具中使用以下命令,管理 Team 專案集合或 Team 專案的全域工作流程:

  • exportglobalworkflow:將全域工作流程匯出至 XML 檔案或命令提示字元視窗。

  • importglobalworkflow:從 XML 檔案匯入全域工作流程。

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

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

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

如需全域工作流程的詳細資訊,請參閱自訂全域工作流程

需求

  • 若要匯出全域工作流程,您必須是 Team 專案或 Team 專案集合的有效使用者。

  • 若要將全域工作流程匯入 Team 專案,您必須是以下安全性群組的成員:Team Foundation AdministratorsProject Collection AdministratorsProject Administrators

  • 若要將全域工作流程匯入 Team 專案集合,您必須是 Team Foundation AdministratorsProject Collection Administrators 的成員。

請參閱 Team Foundation Server 的權限參考

注意事項注意事項

即使您使用系統管理權限登入,還是必須開啟提升權限的命令提示字元視窗,在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟提升權限的命令提示字元視窗,請選擇 [開始],並開啟 [命令提示字元] 捷徑功能表,然後選擇 [以系統管理員身分執行]。如需詳細資訊,請參閱 Microsoft 網站上的下列網頁:使用者帳戶控制

witadmin exportglobalworkflow /collection:CollectionURL [/p:ProjectName] [/f:FileName] [/e:Encoding] [/exportgloballists] 

witadmin importglobalworkflow /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:Encoding] [/v]

參數

參數

描述

/collection:CollectionURL

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

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

http://ServerName:Port/CollectionName。

/p:ProjectName

選擇項。 要為其匯出或匯入全域工作流程的 Team 專案。 這個 Team 專案必須在使用 /collection 參數所指定的集合中定義。 若您沒有指定 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,但不匯入定義檔。

/exportgloballists

選擇項。 匯出全域工作流程所參考之全域清單的定義。 全域清單的定義會內嵌至全域工作流程的 XML 定義中。 若您沒有指定此參數,則會省略全域清單的定義。

/?help

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

備註

您可以藉由從全域工作流程匯入來定義工作項目欄位。 但您無法使用全域工作流程變更現有欄位的屬性。 若您匯入沒有包含 FIELDS 項目的全域工作流程,則之前為全域工作流程匯入的所有規則都會被刪除。 這不會影響欄位定義。

範例

除非另行指定,下列的值會套用在每個範例:

  • 集合的 URI:http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Team 專案:Contoso

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

匯出 Team 專案的全域工作流程定義

以下範例會匯出 Team 專案的全域工作流程:

witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:myGlobalWorkflow.xml

將全域工作流程定義匯入 Team 專案

以下範例會將全域工作流程匯入 Contoso Team 專案:

witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:collectionGlobalWorkflow.xml 

將全域工作流程定義匯入集合

以下範例會將全域工作流程匯入集合:

witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:collectionGlobalWorkflow.xml 

請參閱

概念

定義全域清單

其他資源

自訂全域工作流程

witAdmin:自訂及管理追蹤工作的物件