定義可用於同步處理的工作項目類型
您先必須設定整合兩個伺服器產品，才能同步處理 Visual Studio Team Foundation Server(TFS) 與 Microsoft Project Server 2007 或 Project Server 2010 之間的資料。 在設定工作中，您必須將 Team 專案與企業專案計劃產生關聯，而且您必須指定將參與同步處理的工作項目類型。 在進行初始設定和對應之後，您可以變更對應的工作項目類型。
您可以使用 TfsAdmin ProjectServer 命令列工具的下列選項，管理參與同步處理的工作項目類型：
/MapWorkItemTypes：定義可以參與 Team 專案同步處理的工作項目類型。 雖然您可以對應數個類型，但是只會同步那些被送出進行發佈的工作項目。
/GetMappedWorkItemTypes：傳回設定為要參與 Team 專案同步處理的工作項目類型清單。
/UnmapWorkItemTypes：移除工作項目類型對 Team 專案同步處理的參與。
如需如何整合這兩個伺服器產品的概觀，請參閱設定 TFS 與 Project Server 整合。 如需了解如何建立企業專案與 Team 專案的關聯，請參閱管理企業專案與 Team 專案的關聯。
若要使用 TfsAdmin ProjectServer 命令列工具，請開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
在 Windows 32 位元版本中，將 %programfiles(x86)% 取代為 %programfiles%.。
需求
若要使用這些命令，必須將您的 [管理 Project Server 整合] 權限設定為 [允許]。 而且必須將必要權限授與 Team Foundation Server 服務帳戶，以便和將參與資料同步處理的 PWA 執行個體進行互動。如需詳細資訊，請參閱指派權限以支援 TFS 與 Project Server 整合。
語法
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 流程，像是「“User Story,Task”」或 「“User Story”,Task」 等 。 逗號後面不可有空格。 |
/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 專案工作的所有連結。 只有您所指定之類型的工作項目才會被移除而退出同步處理。
提示
如果您刪除工作，您可能想要先將它們複製到另一個計劃，以便保留這些工作的記錄。
範例
列出已對應的工作項目類型
下列範例會在 AdventureWorksServer 上的 DefaultCollection 中擷取設定為參與 Contoso Team 專案同步處理的工作項目類型。
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]