在 Microsoft Teams 中使用Azure Boards应用

  • 项目

Azure DevOps Services

如果使用 Microsoft Teams，可以从 Teams 频道创建工作项并监视Azure Boards项目中的工作项活动。 通过将 Microsoft Teams Azure Boards 应用添加到 Teams 频道来实现此目的。

Microsoft Teams 的 Azure Boards 应用使用户能够完成以下任务：

  • 设置和管理用于创建和更新工作项的订阅
  • 管理其他工作项事件
  • 在其 Teams 频道中接收和管理工作项事件的通知
  • 从频道中的对话创建工作项
  • 使用消息传递扩展搜索和共享频道中的其他成员的工作项
  • 从其 URL 查看工作项预览，开始讨论并保持对话上下文。

图片：通知

阅读本文，了解如何：

  • 将Azure Boards应用添加到 Microsoft Teams 中的团队
  • 将Azure Boards项目链接到Azure Boards应用
  • 在 Teams 频道中设置工作项相关事件的订阅
  • 从 Teams 频道创建工作项
  • 在 Teams 频道中监视工作项活动

注意

Azure Boards和 Microsoft Teams 集成仅支持Azure DevOps Services。

此外，如果你是 O365 政府社区云 (GCC) 客户，则不支持Azure Boards和 Microsoft Teams 集成，客户将 Azure 商业版订阅与 GCC 租户结合使用。

先决条件

  • 若要创建工作项，你必须是Azure Boards项目的参与者。 如果还没有项目，可以注册并创建项目。 有关详细信息，请参阅开始使用Azure Boards。
  • 若要在 Teams 频道中创建工作项事件的订阅，你必须是Azure Boards项目管理员组的成员，或已添加到团队的团队管理员角色。 若要添加，请参阅 更改项目级权限 或 添加团队管理员。
  • 若要接收通知，必须通过 Azure DevOps 组织的 OAuth 设置启用第三方应用程序访问 。 请参阅 为组织更改应用程序访问策略。

注意

  • 此时，可以将适用于 Microsoft Teams 的 Azure Boards 应用链接到托管在 Azure DevOps Services 上的项目。
  • 直接消息中当前不支持通知。
  • 仅支持公共频道。

将Azure Boards应用添加到 Microsoft Teams

将应用添加到 Microsoft Teams 中的 Teams 频道。

  1. 访问 Microsoft Teams 中的应用商店并搜索Azure Boards应用。 安装后，来自应用的欢迎消息会显示如下图所示。

    图片：欢迎消息

  2. @azure boards使用句柄与应用交互。 有关命令列表，请参阅本文后面的 命令参考 。

若要使用应用，必须先将Azure Boards项目链接到 Teams 频道。

  1. 在团队中安装应用后，将自己连接到Azure Boards并对其进行身份验证。 如果 Microsoft Teams 和Azure Boards位于不同的租户中，请使用不同电子邮件登录。

    将自己连接到Azure Boards并进行身份验证。

    将自己连接到 Azure Boards，步骤 2。

  2. 登录后，在 Teams 频道中使用以下命令链接到使用 URL 指定的Azure Boards项目：

     @azure boards link [project url]

    例如：

     @azure boards link https://dev.azure.com/myorg/myproject

链接项目后，可以使用命令或使用消息操作创建工作项 @azure boards create 。

设置订阅

可以使用命令随时创建用于监视工作项的 @azure boards subscriptions 订阅。

  1. 选择所需的区域路径和感兴趣的事件。 使用关联的筛选器自定义在 Teams 频道中收到通知的内容。 为了帮助轻松设置订阅，最近访问的区域路径将显示在区域路径下拉列表中。

    设置订阅。

如果所需的区域路径未显示在“区域路径”下拉菜单中，请按照下一部分“ 添加区域路径”中所述的说明进行操作。 使用 @azure boards addAreapath 通道中创建订阅的命令和区域路径添加的区域路径始终显示在“区域路径”下拉列表中，以及最近访问的区域路径。

添加区域路径

你可以向频道添加团队工作的区域，以便他们始终可用于创建工作项和订阅。 此功能适用于项目中具有 100 多个区域路径的团队。

  • 使用以下命令将项目中的区域路径添加到 Teams 频道。

      @azure boards addAreapath [area path]

    例如：

      @azure boards addAreapath myproject\fabrikam

    添加 areapath 成功消息

  • 如果选择项目名称作为区域路径，则会收到项目中所有区域路径的通知。

使用命令创建工作项

使用Azure Boards应用，可以从频道创建工作项。 该应用还支持自定义工作项。

  • 若要创建工作项，请使用 @azure boards create。

    使用命令创建工作项

从邮件操作创建工作项

通常，频道中的讨论需要创建工作项。 可以使用消息操作创建工作项。 所选邮件已预先填写工作项的说明部分。 新添加的工作项的“讨论”部分将链接存储回频道中的对话。

  • 使用消息操作创建工作项

    使用消息操作创建工作项

    使用消息操作创建工作项，步骤 2。

管理Azure Boards订阅

  1. 若要查看频道，请添加和删除频道订阅，请使用 @azure boards subscriptions 以下命令：

     @azure boards subscriptions

此命令列出了频道的所有当前订阅，并允许添加新订阅并删除现有订阅。 添加订阅时，还可以使用各种筛选器自定义收到通知的内容。

查看订阅

注意

团队管理员无法删除或修改 Project 管理员创建的订阅。

使用撰写扩展搜索和共享工作项

为了帮助用户搜索和共享工作项，Microsoft Teams Azure Boards 应用支持撰写扩展。 可以按工作项 ID、标题或受支持的功能命令搜索工作项。 有关命令列表，请参阅 功能工作项搜索。 若要使用 compose 扩展，用户必须通过运行@azure boards signin命令或直接登录到 compose 扩展登录到Azure Boards应用。

登录到 compose 扩展。

预览工作项 URL

为了支持在频道中讨论的工作项的协作，该频道将显示引用的工作项预览。 当用户粘贴工作项 URL 时，将显示类似于下图的预览。 此预览有助于保持与工作项相关的对话相关且正确。

工作项 URL 展开。

若要使此功能正常工作，用户必须登录。 登录后，此功能适用于 Microsoft Teams 团队中的所有频道。

Teams 频道一次只能链接到一个Azure Boards项目。 若要链接到其他项目，必须先使用 @azure boards unlink 命令取消链接当前项目。

取消链接项目会删除所有订阅以及频道中添加的区域路径。 如果频道没有订阅，则任何用户都可以取消链接项目。 但是，如果频道具有订阅，则只有项目管理员才能从频道取消链接项目。

Teams 频道线程通知，以便以逻辑方式链接和减少通道中的相关通知。 链接到特定工作项的所有通知都链接在一起。

线程通知的压缩视图

压缩线程

线程通知的展开视图

展开的线程

Azure Boards命令参考

下表列出了可在 Microsoft Teams 频道中使用的所有 @azure boards 命令。

命令 功能
@azure板链接 [项目 URL] 将项目链接到此通道以创建工作项并接收通知
@azure板订阅 添加或删除此频道的订阅
@azure板创建 创建工作项
@azure boards addAreapath [区域路径] 将项目的区域路径添加到此频道
@azure板登录 登录到Azure Boards组织
@azure板注销 从Azure Boards组织注销
@azure板取消链接 从此频道取消链接项目
@azure板反馈 报告问题或建议功能

在 Microsoft Teams 中配置Azure DevOps Services选项卡

  1. 若要将看板或仪表板引入 Microsoft Teams，请选择团队频道顶部导航栏上的“+” (“添加新选项卡”) 按钮。

    此时会显示 “添加选项卡” 对话框。 图标通常根据最新访问进行排列。 可以为按字母顺序排列的列表选择 A-Z。

    向 Teams 频道添加新选项卡的屏幕截图。

  2. 选择 Azure DevOps 图标并验证标识。 （可选）可以选择 “网站” 图标，并将看板或仪表板的 URL 添加到频道。

  3. 选择要添加其董事会或仪表板的组织。

  4. 填写显示的表单。 例如，此处为 TechnicalContent 项目的 Azure DevOps 团队添加仪表板。

    用于向 Teams 频道添加团队仪表板的对话框。

  5. 所选的看板或仪表板将显示。

多租户支持

如果你使用的是 Microsoft Teams 和 Azure DevOps 的其他电子邮件或租户，请完成以下步骤，根据用例登录和连接。

情况 下

Microsoft Teams 中的Email ID 和租户

Azure DevOps 中的Email ID 和租户

要执行的步骤

1

email1@abc.com
(租户 1)

email1@abc.com
(租户 1)

使用 “登录 ”按钮登录。

2

email1@abc.com
(租户 1)

email1@abc.com
(租户 2)

  • 登录 Azure DevOps 帐户
  • 在同一浏览器中，启动新选项卡，导航到 https://teams.microsoft.com
  • signin运行命令，然后选择“登录”按钮。

3

email1@abc.com
(租户 1)

email2@pqr.com
(租户 2)

使用 不同电子邮件地址登录登录，在电子邮件 ID 选取器中使用 email2 登录到 Azure DevOps。

4

email1@abc.com
(租户 1)

email2@pqr.com
(非默认租户 3)

目前不支持此方案

排查错误

如果使用适用于 Microsoft Teams 的 Azure Boards 应用时遇到以下错误，请按照本节中的过程进行操作。

很抱歉，出现了问题。 请重试。

Azure Boards应用使用 OAuth 身份验证协议，并要求通过 OAuth 对组织启用第三方应用程序访问。 若要启用此设置，请导航到 “组织设置>安全>策略”，并通过 OAuth 将第三方应用程序访问 设置为 “打开”。

通过 OAuth 为组织设置启用第三方应用程序访问

配置失败。 请确保组织“{组织名称}”存在，并且你有足够的权限。

导航到 https://aka.ms/VsSignout 使用浏览器注销 Azure DevOps。

打开 “私人 ”或 “隐身 浏览器”窗口并导航到 https://aex.dev.azure.com/me 并登录。 在左侧配置文件图标下的下拉列表中，选择包含要链接的项目的组织所在的目录。

选择包含包含项目的组织的目录

在同一 浏览器中，启动新选项卡，导航到 https://teams.microsoft.com/。 @azure boards signout运行该命令，然后在安装 Microsoft Teams Azure Boards 应用的频道中运行@azure boards signin该命令。

选择该 Sign in 按钮，你将重定向到同意页面，如以下示例中的同意页面。 确保电子邮件旁显示的目录与上一步中选择的目录相同。 接受并完成登录过程。

同意请求的应用权限

如果这些步骤无法解决身份验证问题，请在开发者社区联系我们。