匯入和匯出全域工作流程 [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 Administrators、Project Collection Administrators 或 Project Administrators。
若要將全域工作流程匯入 Team 專案集合,您必須是 Team Foundation Administrators 或 Project 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 定義檔路徑及名稱。
|
||
/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