管理可用於同步處理的工作項目類型
您先必須設定整合兩個伺服器產品，才能同步處理 Visual Studio Team Foundation Server 2010 與 Microsoft Project Server 2007 或 Project Server 2010 之間的資料。 在設定工作中，您必須將 Team 專案與企業專案計劃產生關聯，而且您必須指定將參與同步處理的工作項目類型。 在進行初始設定和對應之後，您可以變更對應的工作項目類型。
您可以使用 TFSAdmin ProjectServer 命令列工具的下列選項，管理參與同步處理的工作項目類型：
/MapWorkItemTypes：定義可以參與 Team 專案同步處理的工作項目類型。 雖然您可以對應數個類型，但是只會同步那些被送出進行發佈的工作項目。
/GetMappedWorkItemTypes：傳回設定為要參與 Team 專案同步處理的工作項目類型清單。
/UnmapWorkItemTypes：移除工作項目類型對 Team 專案同步處理的參與。
如需如何整合這兩個伺服器產品的概觀，請參閱設定 Team Foundation Server 和 Project Server 的整合。 如需了解如何建立企業專案與 Team 專案的關聯，請參閱管理企業專案與 Team 專案的關聯。
若要使用 TFSAdmin ProjectServer 命令列工具，請在任何執行 Team 總管 和 Visual Studio Team Foundation Server 2010 Service Pack 1 的電腦上開啟命令提示字元視窗。您可以在下列目錄中執行此工具：磁碟機:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE。 若是 64 位元電腦，此工具位於 Drive:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE。
必要的使用權限
若要使用這些命令，必須將您的 [管理 Project Server 整合] 權限設定為 [允許]。 而且必須將必要權限授與 Team Foundation Server 服務帳戶，以便和將參與資料同步處理的 PWA 執行個體進行互動。 如需詳細資訊，請參閱 指派權限以支援 Project Server 和 Team Foundation Server 的整合。
.gif "注意事項") 注意事項 |
|---|
即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 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] 索引標籤，則應該包含這個旗標。 |
/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 上的 Collection0 中擷取設定為參與 Contoso Team 專案同步處理的工作項目類型。
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/Collection0 /teamproject:Contoso
對應 Team 專案的工作項目類型
下列範例會設定使用者本文和工作參與 Contoso 專案的資料同步處理。
TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/Collection0/ /teamproject:Contoso /workitemtypes:”User Story, Task”
移除 Team 專案工作項目類型的對應
下列範例會移除工作使其退出 Contoso 專案的資料同步處理。
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/Collection0/ /teamproject:Contoso /workitemtypes:Task
回到頁首