在 Azure DevOps 中重新命名專案

Azure DevOps Services |Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018-TFS 2015

瞭解如何重新命名專案。 當您重新命名專案時,它會更新下欄區域中的專案名稱:

  • 版本控制路徑
  • 工作項目
  • 查詢
  • 其他專案構件

專案可以重新命名多次,且可以重複使用較舊的名稱。 重新命名後,可能會有一些 必要的小組成員動作

警告

如果有少於1000的使用者,重新命名專案會將電子郵件通知傳送給專案中的每個人。 如果專案中有大於1000的使用者,則只有 project collection 系統管理員會收到電子郵件通知。

必要條件

您必須是 Project Collection Administrators 群組的成員。 當您是組織擁有者時,系統會自動將您新增至 Project Collection Administrators 群組。 如果您不是成員,請立即加入。 如需詳細資訊,請參閱 在專案或集合層級設定許可權

您必須是 Project Collection Administrators 群組的成員。 如果您不是成員,請立即加入。 如需詳細資訊,請參閱 在專案或集合層級設定許可權

您必須是 Project Collection Administrators 群組的成員。 如果您不是成員,請立即加入。 如需詳細資訊,請參閱 在專案或集合層級設定許可權

您必須具有專案的 [ 編輯專案層級資訊 ] 許可權,才能將其重新命名。

重新命名專案

  1. 登入您的組織 (https://dev.azure.com/{yourorganization}) ,然後開啟您想要重新命名的專案。

  2. 選取Project 設定] ,然後輸入新名稱並選取[儲存]。

    輸入新名稱,然後選取 [儲存] 以重新命名您的專案

  3. 若要確認重新命名,請輸入新的專案名稱,勾選 [我瞭解重新命名此專案的後果] 旁邊的方塊,然後選取 [ 儲存]。

    輸入新的專案名稱,勾選核取方塊,然後儲存

    您的專案已重新命名。

  1. 登入您的組織。

  2. 從 [專案] 頁面中,選擇 您想要重新命名之專案的 [動作],然後選擇 [重新命名]。

    選擇 [重新命名]。

  3. 編輯名稱。

    輸入新的專案名稱

    如果 [重新命名 Project] 對話方塊未出現,表示您不是該特定專案的 Project Administrators 群組成員。 瞭解如何新增至 Project Administrators 群組。

  1. 登入您的組織。

  2. 在 [總覽] 索引標籤中,開啟 您想要重新命名之專案的功能表,然後選擇 [重新命名]。

    選擇 [重新命名]。

  3. 編輯名稱。

    輸入新的專案名稱

    如果 [重新命名 Project] 對話方塊未出現,表示您不是該特定專案的 Project Administrators 群組成員。 瞭解如何新增至 Project Administrators 群組。

使用重新命名的專案時所需的使用者動作

小組中的每位使用者都必須重新開機其用戶端,並根據他們使用的功能執行其他動作。

重新開機您的用戶端

開啟的用戶端會將所有專案名稱的快取保留在記憶體中,但在重新命名專案之後,將不會自動清除此快取。 若要清除快取,請重新開機您的用戶端,使其填入新的專案名稱。 如果您未重新開機用戶端,則使用快取專案名稱的作業會失敗,並出現「找不到專案」例外狀況。

針對下列用戶端,請在每個用戶端中儲存您的工作,然後重新開機:

  • Visual Studio/Team Explorer

  • Eclipse (如果您的小組使用 Team Explorer Everywhere 外掛程式)

  • Microsoft Excel、PowerPoint 或 Project,如果您的小組使用這些 Office 產品的 Team Foundation Server 延伸模組

  • 使用 .net Team Foundation Server 用戶端物件模型的任何其他用戶端

更新您的 Git 遠端

如果您的專案使用 Git,則必須更新已重新命名之專案中每個存放庫的遠端參考。 這些更新是必要的,因為遠端存放庫 URL 包含專案和存放庫名稱。 Git 會使用遠端參考,在您的本機存放庫與儲存在伺服器上的遠端版本之間提取和推送變更。 小組的每個成員都必須更新其本機 Git 存放庫,才能繼續從其開發電腦連接。

如需更新 Git 遠端的詳細資訊,請參閱在 您的開發電腦上更新 git 遠端

更新您的 TFVC 伺服器工作區

如果您的專案使用 TFVC 與 伺服器工作區,則必須以新的專案名稱更新這些工作區。 針對下列用戶端,執行取得或簽入,然後更正工作區對應以使用新的專案名稱:

  • Visual Studio 2015 (RC 或更新版本)
  • Visual Studio 2013
  • Visual Studio 2012
  • Visual Studio 2010 (只支援伺服器工作區)
  • Team Explorer Everywhere (2012 或更新版本)

原始檔控制瀏覽器,取得最新版本

更新您的 TFVC 本機工作區

如果您的小組在 本機工作區中使用 TFVC,則必須以新的專案名稱更新這些工作區。 針對下列用戶端,執行取得或簽入,工作區對應會更正以使用新的專案名稱:

建議您盡可能將用戶端更新為最新的更新或版本。 針對所有其他支援的 Visual Studio 版本,您必須建立新的本機工作區,對應至新的專案名稱。 有兩個例外狀況包含 Visual Studio 2010 (僅支援伺服器工作區),以及適用于 Eclipse 的 Team Foundation Server 外掛程式。

  1. 擱置您的變更

  2. 建立新的工作區 ,對應至新的專案名稱。

  3. 解除擱置您的變更。

本機工作區是在本機進行管理,而不是在伺服器上。 沒有更新重新命名邏輯的舊版用戶端無法將本機工作區更新為新的專案名稱。

更新內部部署 (的 Team Foundation Server SharePoint 和報表整合)

SharePoint 與 Reporting Services 整合都會繼續運作,但在填入新的專案名稱之前,某些報表將無法如預期般運作。 舊的專案名稱仍會存在,直到以新名稱更新快取為止。 報告和 SharePoint server 系統管理員可以手動執行這些作業,以立即填入新的名稱。

  • 如果您的小組使用報表,則會在下次執行資料倉儲的累加式分析作業之後反映新的名稱。 根據預設,工作會每隔兩小時執行一次。 但是,您可以 手動執行倉儲工作和增量分析作業。 然後,新的名稱會同步處理至倉儲,而且報表會開始使用新的名稱。 在工作執行之前,報表不會如預期般運作。

  • 如果您的小組使用 SharePoint 整合,並且具有直接參考專案名稱的自訂查詢或網頁元件,請將每個專案中的名稱更新為新的專案名稱。 您不需要更新預設的查詢和網頁元件,因為它們會繼續運作。 使用 @project 也會在專案重新命名之後繼續運作,而且也不需要更新。

  • 在您執行下列動作之前,MOSS 上的 Excel 報表和 Excel web 元件都不會顯示正確的資料。

    1. 倉儲作業:執行倉儲工作,讓 Excel 報表包含正確的資料。 如果新的專案名稱未同步處理至倉儲,Excel 報表不會顯示正確的資料。 若要避免這種結果,請手動執行倉儲工作。

    2. SharePoint 計時器工作-執行 SharePoint 管理中心的「Team Foundation Server 儀表板更新」工作,以更新儀表板上 Excel 的 web 元件。 依預設,它會每隔30分鐘執行一次。 在執行此作業之前,儀表板上的 Excel web 元件以及直接來自 [報表] 資料夾的報表將無法運作。 這些 web 元件使用錯誤的專案名稱或錯誤的報表資料夾。

    3. SharePoint 快取-手動清除 SharePoint 快取,以避免在儀表板中出現過時的資料,例如報表資料夾位置。 根據預設,此快取會每隔一小時清除一次。 您也可以使用 TFS 重新導向 url 來清除某些 TFS 特定的快取,並提供 "clearcache" 參數。 例如:

      http://<SharePointServer>/sites/<TeamProjectCollectionName>/<TeamProjectName>/_layouts/TfsRedirect.aspx?tf:type=Report&tf:clearcache=1
      

重新命名作業的結果

  • 工作專案識別碼在組織中是唯一的。 這兩個新的小組名稱和舊的小組名稱都能繼續使用此 URL。 這項功能的目的是要避免中斷連結。

  • 只要 URL 中的專案是組織中的有效專案,我們就會顯示提供的工作專案識別碼。 下列範例顯示具有名為 "範例 1" 和 "Example2" 之專案的組織。

    https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ -顯示工作專案 40 https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ -顯示工作專案 40 https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ -顯示404錯誤

  • 工作專案連結不會過期。

  • 您可以再次使用舊的專案名稱。