共用方式為


管理企業專案與 Team 專案之間的對應

您必須先執行幾項工作,包括將企業專案計劃與 Team 專案產生關聯,才能同步處理 Visual Studio Team Foundation Server (TFS) 與 Microsoft Project Server 之間的資料。 如需如何整合這兩個產品的概觀,請參閱設定 TFS 與 Project Server 整合

您可以在 TfsAdmin ProjectServer 命令列工具中使用下列命令,管理 TFS 中企業專案計劃與 Team 專案的關聯:

  • /MapPlanToTeamProject:對應企業專案計劃至 Team 專案。 您可以將多個計劃對應到相同的 Team 專案,但是每個計劃只能對應到一個 Team 專案。

  • /GetMappedProjects:傳回企業專案計劃清單,這些計劃會對應到您所指定之小組專案集合中的任何 Team 專案。

  • /UnmapPlanFromTeamProject:移除企業專案計劃與 Team 專案之間的對應。

注意事項注意事項

將企業專案計劃對應至 Team 專案之後,您可以變更進行同步處理的工作項目類型。如需詳細資訊,請參閱定義可用於同步處理的工作項目類型

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

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

在 Windows 32 位元版本中,將 %programfiles(x86)% 取代為 %programfiles%.

需求

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

語法

TfsAdmin ProjectServer /GetMappedProjects /collection:tpcUrl

TfsAdmin ProjectServer /MapPlanToTeamProject /collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName [/workItemTypes:ListOfWorkItemTypes] [/noFixedWork] [/projectFieldForWorkItemType:ProjectFieldName] [/skipUIChanges]

TfsAdmin ProjectServer /UnmapPlanFromTeamProject /collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName [/force]

參數

參數

描述

/collection:tpcUrl

指定 Team 專案集合的統一資源定位器 (URL)。 您可以使用下列格式指定 URL:http://ServerName:Port/VirtualDirectoryName/CollectionName

如果您未指定使用虛擬目錄,則可以使用下列格式指定 URL:

http://ServerName:Port/CollectionName

/enterpriseProject:EnterpriseProjectName

指定企業專案計劃的名稱。 計劃必須儲存和發佈在 Project Server,而 PWA 的執行個體必須先註冊於儲存專案集合所在之 Team Foundation Server 的部署。

/teamProject:TeamProjectName

指定在專案集合中定義的 Team 專案的名稱。

/workItemTypes:ListofWorkItemTypes

以逗號分隔清單指定一個或多個工作項目類型的參考名稱。 您只應該指定那些您要在 Project Professional 中追蹤其資料的工作項目的類型。 例如,您可以將下列要支援 Agile 流程的工作項目類型指定為 "User Story,Task"或"User Story",Task (逗號之後不要包含空格)。

/noFixedWork

指定不要針對在 Team Foundation 中對應至工作項目的工作,自動將 Project Professional 中的工作類型設定為固定工時。 根據預設,在兩個伺服器產品之間進行整合的過程中,企業專案計劃中對應到 Team Foundation 工作項目的工作會將其工作類型設定為 [固定工時]。 您可以使用這個選項覆寫這個行為。 固定工作 (Fixed Work) 是您可在 Project 中使用的三種工作 (Task) 之一。 如需詳細資訊,請參閱 變更工作類型專案用途來計算工作期間

/projectFieldForWorkItemType: ProjectFieldName

指定用來顯示定義於 Team Foundation 之工作項目類型值的 Microsoft Project 欄位的名稱。 您應該指定介於 pjTaskText1 和 pjTaskText30 之間的值。 根據預設,這個值為 pjTaskText30。

/force

移除所有工作項目的所有的對應,這些工作項目是在 Team 專案中定義而目前連結至專案計劃。 未對應的 Team 專案不能包含任何連結的工作項目。 只有在您確定不再需要 Team 專案中的任何工作項目繼續參與資料同步處理時,才應該指定這個選項。

/skipUIChanges

指定不應該將工作項目表單中的 [Project Server] 索引標籤變更為您所指定的類型。 如果您已經為受影響的型別自訂 [Project Server] 索引標籤,則應該包含這個旗標。

/?help

顯示命令的相關資訊。

備註

執行命令時會顯示訊息,指出正在執行的動作以及動作正在處理的物件。 例如,下列訊息表示正在對應企業專案計劃:

Mapping enterprise project EntProjA . . . Done.

命令完成後,會出現另一個訊息。 例如,下列訊息表示企業專案計劃已經對應至 Team 專案:

Mapping enterprise project EntProjA to team project MyTeamProj . . . Done.

除了將企業專案計劃與 Team 專案相關聯,/MapPlantoTeamProject 選項還會將 [Project Server] 索引標籤加入至您指定的工作項目類型的工作項目表單。

如果嘗試將企業專案對應到沒有欄位對應的 Team 專案,則會有訊息表示需要對應,並且不再執行其他作業。 如需詳細資訊,請參閱自訂 TFS 與 Project Server 之間的欄位對應

如果您移除企業專案和 Team 專案 (後者沒有其他企業專案對應) 之間的對應,則會從您取消對應之 Team 專案中的所有工作項目類型的表單移除 [Project Server] 索引標籤。

您必須先移除企業專案計劃的工作與 Team Foundation 的工作項目之間關聯,才能取消對應 Team 專案。 您刪除企業專案計劃中的工作、發佈計劃,並等待同步處理完成,即可移除此關聯。 或者,您可以使用 /force 旗標來移除專案工作與工作項目間的關聯。

提示

刪除工作之前,您可能想要將它們複製到另一個計劃來記錄您正在刪除的工作。

範例

除非另行指定,下列的值會套用在每個範例:

  • PWA 執行個體的 URL:http://MyPWAServer/MyPWAInstance/

  • Team Foundation Server 的 URL:http://AdventureWorksServer:8080/tfs/

  • Team 專案集合的 URL:http://AdventureWorksServer:8080/tfs/DefaultCollection

列出已對應的企業專案

下面範例會列出在 AdventureWorksServer 上對應至 Collection0 中的 Team 專案的企業專案。

TfsAdmin ProjectServer /GetMappedProjects /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

將企業專案對應至 Team 專案

下列範例在 AdventureWorksServer 上將 MyEnterpriseProjA 對應到 DefaultCollection 中的 MyTeamProjB,並指定使用者劇本和工作將參與同步處理:

TfsAdmin ProjectServer /MapPlanToTeamProject /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ enterpriseProject:MyEnterpriseProjA /teamProject:MyTeamProjB /workItemTypes:"User Story, Task"

移除企業專案到 Team 專案的對應

下列範例會在 AdventureWorksServer 上的 DefaultCollection 中移除 MyEnterpriseProjA 對 MyTeamProjB 的關聯。

TfsAdmin ProjectServer /UnmapPlanFromTeamProject /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ enterpriseProject:MyEnterpriseProjA /teamProject:MyTeamProjB

請參閱

工作

設定 TFS 與 Project Server 整合

概念

對應整合元件 [TfsAdmin ProjectServer]