在 Azure DevOps 中重命名项目

Azure DevOps Services |Azure DevOps Server 2022 |Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018

了解如何重命名项目。 重命名项目时,它会更新以下区域中的项目名称:

  • 版本控制路径
  • 工作项
  • 查询
  • 其他项目项目项目

项目可以多次重命名,旧名称可以重复使用。 重命名后,可能有一些 必需的团队成员操作

警告

重命名项目会向项目中的每个人发送电子邮件通知(如果用户少于 1,000 个)。 如果项目中的用户数超过 1,000 个,则仅项目集合管理员会收到电子邮件通知。

先决条件

  • 你必须是 项目管理员 组的成员,或者将项目级 重命名团队项目 权限设置为 “允许”。 有关详细信息,请参阅 更改项目级权限
  • 你必须是 项目管理员 组的成员,或者将项目级 重命名团队项目 权限设置为 “允许”。 有关详细信息,请参阅 更改项目级权限

重命名项目

  1. () https://dev.azure.com/{yourorganization} 登录到组织,然后打开要重命名的项目。

  2. 选择 “项目设置>概述”,然后输入新名称,然后选择“ 保存”。

    输入新名称,然后选择“保存”重命名项目

  3. 若要确认重命名,请输入新项目名称,选中“我了解重命名此项目的后果”旁边的框,然后选择“ 保存”。

    输入新项目名称,选中该框,然后保存

    项目已重命名。

  1. 登录到组织。

  2. 从“项目”页中,选择要重命名的项目的操作,然后选择“重命名”。

    选择“重命名”。

  3. 编辑名称。

    输入新项目名称

    如果未显示“ 重命名项目 ”对话框,则不是该特定项目的 Project Administrators 组的成员。

使用重命名项目所需的用户操作

团队中的每个用户都必须重启其客户端,并根据他们使用的功能执行其他操作。

重启客户端

打开的客户端在内存中保留所有项目名称的缓存,但在重命名项目后不会自动清除此缓存。 若要清除缓存,请重启客户端,以便填充新项目名称。 如果未重启客户端,则使用缓存项目名称的操作失败,项目找不到异常。

对于以下客户端,请在每个客户端中保存工作,然后重启:

  • Visual Studio/Team Explorer

  • Eclipse(如果你的团队使用 Team Explorer Everywhere 插件)

  • 如果你的团队使用这些 Office 产品的 Team Foundation Server 扩展,Microsoft Excel、PowerPoint 或 Project

  • 使用 .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 和 Reporting Integrations (本地)

SharePoint 和Reporting Services集成都继续工作,但某些报表在填充新项目名称之前无法按预期工作。 旧项目名称仍然存在,直到缓存使用新名称进行更新。 报告和 SharePoint 服务器管理员可以手动运行这些作业以立即填充新名称。

  • 如果团队使用报表,则它们反映下一个增量分析作业运行数据仓库后的新名称。 默认情况下,作业每隔两小时运行一次。 但是,可以 手动运行仓库作业和增量分析作业。 然后,新名称将同步到仓库,报表开始使用新名称。 在作业运行之前,报表无法按预期工作。

  • 如果团队使用 SharePoint 集成,并且具有直接引用项目名称的自定义查询或 Web 部件,请将每个名称更新到新项目名称。 无需更新默认查询和 Web 部件,因为它们将继续工作。 使用@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
      

重命名操作的结果

  • 工作项 ID 在组织中是唯一的。 该 URL 将继续适用于新团队名称和旧团队名称。 此功能旨在避免中断链接。

  • 只要 URL 中的项目是组织中的有效项目,我们会显示提供的工作项 ID。 以下示例演示名为“Example1”和“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 错误

  • 工作项链接不会过期。

  • 可以再次使用旧项目名称。