管理企業專案與 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