TeamCity On-Premises 2024.03 Help

Azure Board 工作项

您可以将 TeamCity 与 Azure Board 工作项(或 Team Foundation 工作项)集成,以在 TeamCity 用户界面中提供指向 工作项 的链接。 TeamCity 支持 Azure DevOps Server(以前称为 Team Foundation Server — 2012 版本或更高版本)和 Azure DevOps Services。

在 TeamCity 用户界面中显示工作项的链接

当启用与 Azure Board Work Items 的集成时,TeamCity 会自动检测在 VCS 提交注释中提到的工作项 ID。 它将这些 ID 转换为链接到相应的工作项,并在 UI 中向 TeamCity 用户显示:

  • 要查看 TeamCity UI 中工作项的基本详情,请打开相关构建结果的 Changes 选项卡,然后将鼠标悬停在工作项 ID 旁的图标上。

  • 在构建结果的 Issues 标签页上可以查看构建中已修复的工作项。

  • 要查看与整个构建配置(而不仅仅是单个构建)相关的工作项,您可使用 构建配置主页问题日志选项卡。 您可以过滤列表,只显示某一范围的构建,和 / 或启用 只显示已解决的问题 选项,以便只显示在构建中修复的问题。

另外,如果您的更改集有相关的工作项,即使未在更改集中添加评论,TeamCity 也可以检索到关于它们的信息,并在 UI 中显示信息。

为了从与 Azure Board 工作项的集成中获得最大的益处,請遵循以下建议:

  • 当您将更改提交到版本控制时,始终在提交的注释中提到与修复相关的工作项 ID

  • 马克在问题跟踪器中将工作项标记为 已解决,以在 TeamCity 日志中以 已修复 状态显示它们(解决的时间并不真正重要)。

配置连接至 Azure Board 工作项

启用 TeamCity 与 Azure Board 工作项的集成需要项目管理员权限,因为它是在项目级别配置的。 请注意,为一个项目启用集成会同时为其所有子项目启用。 如果子项目中的设置与父项目的设置不同,那么子项目的设置将优先于父项目的设置。

要启用集成,请在 Project Settings | Issue Trackers 页面创建一个到 Azure Board 工作项的连接,并指定以下设置:

设置

描述

连接类型

从列表中选择 Team Foundation Work Items

显示名称

指定连接名称以便将其与其他连接区分开。

服务器 URL

在以下格式中输入 Azure DevOps Server URL:

  • Azure DevOps Serviceshttps://dev.azure.com/<organization>/<project>

  • Azure DevOps Serverhttp[s]://<主机>:<端口>/tfs/<集合>/<项目>

用户名

指定一个用户来访问 Azure DevOps Server。 这可以是用户名或 DOMAIN\UserName 字符串。
若为空,将由 Azure DevOps 选择一个用于运行 TeamCity 服务器 的用户帐户。

密码

输入上述用户的密码。

要通过访问令牌而不是密码进行身份验证,将 用户名 字段留空,并将您的访问令牌输入到 密码 中。 您可以在您的 Azure DevOps 帐户中创建一个 个人访问令牌。 将 Code 的访问范围设置为在您即将从 TeamCity 访问的仓库中的 Work Items (读取,写入和管理)

模式

在评论文本中指定一个 Java 正则表达式 模式来识别工作项 ID。 匹配的文本(如果有定义的组,则使用第一个组)被用作工作项编号。 最常见的情况是 #(\d+)—— 这将从文本 修复 #1234 中提取 1234 作为工作项的 ID。

自定义解决状态

TeamCity 支持工作项的自定义状态。 例如,要自定义 已解决 的状态,将 teamcity.tfs.workItems.resolvedStates 内部属性 设置为 已关闭?|完成?|已修复?|已解决?|已删除?

最后修改日期: 16日 7月 2024年