管理可用於同步處理的工作項目類型

在您可以同步處理 Visual Studio Team Foundation Server 2012 和 Microsoft Project 伺服器之間前的資料，您必須設定兩種伺服器產品的整合。在設定工作中，您必須將 Team 專案與企業專案計劃產生關聯，而且您必須指定將參與同步處理的工作項目類型。在進行初始設定和對應之後，您可以變更對應的工作項目類型。

您可以使用 TfsAdmin ProjectServer 命令列工具的下列選項，管理參與同步處理的工作項目類型：

• /MapWorkItemTypes：定義可以參與 Team 專案同步處理的工作項目類型。雖然您可以對應數個類型，但是只會同步那些被送出進行發佈的工作項目。

• /GetMappedWorkItemTypes：傳回設定為要參與 Team 專案同步處理的工作項目類型清單。

• /UnmapWorkItemTypes：移除工作項目類型對 Team 專案同步處理的參與。

如需如何整合這兩個伺服器產品的概觀，請參閱設定 Team Foundation Server 和 Project Server 的整合。如需了解如何建立企業專案與 Team 專案的關聯，請參閱管理企業專案與 Team 專案的關聯。

若要使用 TfsAdmin ProjectServer 命令列工具，請開啟 Visual Studio 或 Team Explorer 安裝的命令提示字元] 視窗並輸入:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

在 Windows 64 位元版本中，將 %programfiles% 取代為 %programfiles(x86)%.。

必要的使用權限

若要使用這些命令，必須將您的 [管理 Project Server 整合] 權限設定為 [允許]。而且必須將必要權限授與 Team Foundation Server 服務帳戶，以便和將參與資料同步處理的 PWA 執行個體進行互動。如需詳細資訊，請參閱指派權限以支援 Project Server 和 Team Foundation Server 的整合。

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

語法

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName

TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/force]

參數

參數	描述
/collection:tpcUrl	指定 Team 專案集合的統一資源定位器 (URL)。您可以使用下列格式指定 URL： http://ServerName:Port/VirtualDirectoryName/CollectionName 如果您未指定虛擬目錄，則可以使用下列格式指定 URL： http://ServerName:Port/CollectionName
/teamProject:TeamProjectName	指定在專案集合中定義的 Team 專案的名稱。
/workItemTypes:ListofWorkItemTypes	以逗號分隔清單指定一個或多個工作項目類型的參考名稱。您只應該指定那些您要在 Project Professional 中追蹤其資料的工作項目的類型。例如，您可以將下列要支援 Agile 流程的工作項目類型指定為 "使用者劇本,工作" 或 "使用者劇本",工作。逗號後面不可有空格。
/skipUIChanges	指定不應該將工作項目表單中的 [Project Server] 索引標籤變更為您所指定的類型。您應該將這個旗標，則自訂受影響之型別的 [Project Server]索引標籤或 MapWorkItemTypes 命令無法完成。您可以手動更新型別定義。如需詳細資訊，請參閱新增至工作項目類型定義的 XML 項目。
/force	移除所有連結，這些連結將您所指定之類型的工作項目繫結至專案中的工作。如果您使用這個選項，就可以移除工作項目類型使其退出資料同步處理，即使目前有其中一個或多個該類型的工作項目仍在同步處理中。
/? 或 help	顯示命令的相關資訊。

回到頁首

備註

執行命令時會顯示訊息，指出哪個物件上執行何種動作。例如，下列訊息表示正在設定使用者劇本和工作參與資料同步處理。

Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . . 

命令完成後，會出現另一個訊息。例如，下列訊息表示已成功設定使用者劇本和工作。

You have successfully configured the following work item types for team project ProjA: User Story, Task.

除了設定可以參與同步處理的工作項目類型，/MapWorkItemTypes 命令還會執行下列作業：

• 加入您指定給參與資料同步處理的型別集的工作項目類型。也就是，命令不會取消對應任何現有的對應類型。

• 將 [Project Server] 索引標籤加入至您指定的工作項目類型的表單。

  如果已經為您指定的工作項目類型定義 [Project Server] 索引標籤，則會忽略該型別，而且不會對該工作項目類型的表單進行任何變更。

如果嘗試對應未與企業專案計劃相關聯之 Team 專案的工作項目類型，就會出現錯誤。您只能針對設定為參與同步處理的 Team 專案來對應工作項目類型。如需詳細資訊，請參閱管理企業專案與 Team 專案的關聯。

如果您移除工作項目類型的對應，則會從您取消對應之 Team 專案的該類型的表單移除 [Project Server] 索引標籤。

您必須先從企業專案計劃中刪除工作以移除它們與 Team Foundation 工作項目之間的所有關聯，才能取消對應 Team 專案的工作項目類型。在您刪除企業專案計劃的工作後，您必須發行並等待同步完成。或者，您可以指定 /force 旗標來移除將工作項目繫結至 Team 專案工作的所有連結。只有您所指定之類型的工作項目才會被移除而退出同步處理。

提示
如果您刪除工作，您可能想要先將它們複製到另一個計劃，以便保留這些工作的記錄。

回到頁首

範例

列出已對應的工作項目類型

下列範例會擷取在 DefaultCollection 設定參與 Contoso Team 專案同步處理的 AdventureWorksServer 上的工作項目類型。

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso

對應 Team 專案的工作項目類型

下列範例會設定使用者劇本和工作參與 Contoso 專案的資料同步處理。

TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”

移除 Team 專案工作項目類型的對應

下列範例會移除工作使其退出 Contoso 專案的資料同步處理。

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task

回到頁首

請參閱

概念

指定可同步處理的工作項目類型

使用 TfsAdmin ProjectServer 管理 Project Server 整合

其他資源

自訂 Project Server 與 Team Foundation Server 之間的欄位對應