共用方式為


管理全域工作流程

在定義和更新多個 Team 專案和工作項目類型共用的工作項目欄位和全域清單時,使用全域工作流程可將定義和更新工作減至最低。 您可以透過全域工作流程定義並更新欄位和全域清單。 您可以使用 witadmin 命令列工具中的下列命令,管理 Team 專案集合或 Team 專案的全域工作流程:

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

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

注意事項注意事項

在定義全域工作流程之前,應用程式層伺服器必須啟用此功能。 因此,伺服器必須執行支援此功能的 Visual Studio Team Foundation Server 版本,例如 Team Foundation Server 2010 Service Pack 1 (SP1)。 您可以從下列 Microsoft 網站的網頁下載 Service Pack:Visual Studio Team Foundation Server 2010 Service Pack 1,Beta 版 (英文)。

您可以在任何執行 Team 總管 之電腦的 Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 中,找到 witadmin 命令列工具。在 64 位元電腦中,工具是位於 Drive:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE 中。

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

必要的使用權限

對於定義全域工作流程的 Team 專案集合,您必須已設定下列使用權限:

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

  • 若要匯入全域工作流程,您必須是下列安全性群組的成員:[Team Foundation Administrators]、[Project Administrators] (其成員可將全域工作流程匯入至 Team 專案) 或 [Project Collection Administrators] (其成員可將全域工作流程匯入至專案集合)。

如需詳細資訊,請參閱Team Foundation Server 使用權限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 專案集合中定義。 如果沒有指定 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/AWTeam/Collection1

  • Team 專案:Contoso

  • 伺服器網站的通訊埠編號:8080

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

下列範例會將全域工作流程匯出至 Team 專案:

witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:Contoso /f:C:myGlobalWorkflow.xml

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

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

witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:Contoso /f:C:collectionGlobalWorkflow.xml 

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

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

witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:collectionGlobalWorkflow.xml 

請參閱

工作

加入、使用和管理全域清單

概念

定義全域清單

其他資源

自訂全域工作流程

witAdmin:管理追蹤工作項目的物件