重命名Azure DevOps中的项目

  • 项目

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

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

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

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

警告

重命名项目会向项目中的每个人发送电子邮件通知（如果用户少于 1，000 个）。 如果项目中有超过 1，000 个用户，则只有项目集合管理员会收到电子邮件通知。

先决条件

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

重命名项目

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

  2. 选择ProjectsettingsOverview>，然后输入新名称，然后选择“保存”。

    Enter a new name, and then select Save to rename your project

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

    Enter new project name, check the box, and then save

    项目已重命名。

  1. 登录到组织。

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

    Choose Rename.

  3. 编辑名称。

    Enter a new project name

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

用于处理重命名项目所需的用户操作

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

重启客户端

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

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

  • Visual Studio/团队资源管理器

  • 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 或更高版本)

Source control explorer, get latest version

更新 TFVC 本地工作区

如果团队将 TFVC 与 本地工作区配合使用，则需要使用新项目名称更新这些工作区。 对于以下客户端，请执行获取或签入，并更正工作区映射以使用新的项目名称：

建议将客户端更新到最新的更新或发布（如果可能）。 对于所有其他受支持的Visual Studio版本，必须创建映射到新项目名称的新本地工作区。 两个例外包括 Visual Studio 2010，它仅支持服务器工作区，以及用于 Eclipse 的Team Foundation Server插件。

  1. 搁置更改。

  2. 创建映射到新项目名称的新工作区。

  3. 取消保存更改。

本地工作区在本地进行管理，而不是在服务器上进行管理。 没有更新的重命名逻辑的旧客户端无法将本地工作区更新到新的项目名称。

更新本地 (Team Foundation Server SharePoint和报告集成)

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 错误

  • 工作项链接不会过期。

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