在 Microsoft Teams 中使用 Azure Boards 应用

  • 项目

Azure DevOps Services

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

借助适用于 Microsoft Teams 的 Azure Boards 应用，用户能够完成以下任务：

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

图片：通知

阅读此文，了解如何：

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

注意

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

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

先决条件

  • 若要创建工作项，你必须是 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

    添加区域路径成功消息

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

使用命令创建工作项

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

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

    使用命令创建工作项

从消息操作创建工作项

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

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

    使用消息操作创建工作项

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

管理 Azure Boards 订阅

  1. 若要查看、添加和删除通道的订阅，可使用 @azure boards subscriptions 命令：

     @azure boards subscriptions

此命令会列出通道的所有当前订阅，并可用于添加新订阅和删除现有订阅。 作为添加订阅的一部分，还可以使用各种筛选器自定义通知内容。

查看订阅

注意

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

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

为了帮助用户搜索和共享工作项，适用于 Microsoft Teams 的 Azure Boards 应用支持 compose 扩展。 可以按工作项 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 boards link [project url] 将项目链接到此通道以创建工作项并接收通知
@azure boards subscriptions 添加或删除此通道的订阅
@azure boards create 创建工作项
@azure boards addAreapath [area path] 将项目中的区域路径添加到此通道
@azure boards sign in 登录到 Azure Boards 组织
@azure boards sign out 从 Azure Boards 组织注销
@azure boards unlink 取消链接项目与此通道
@azure boards feedback 报告一个问题或建议一项功能

在 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 使用了其他电子邮件或租户，请完成以下步骤，以根据你的用例进行登录和连接。

Case

Microsoft Teams 中的电子邮件 ID 和租户

Azure DevOps 中的电子邮件 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 访问第三方应用程序”设置

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

转到浏览器注销 Azure DevOps https://aka.ms/VsSignout 。

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

选择项目所在的组织位于的目录

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

选择 Sign in 按钮，随即会转到以下示例中所示的同意页面。 确保电子邮件旁显示的目录与上一步中选择的目录相同。 选择“接受”并完成登录过程。

同意请求的应用权限

如果上述步骤无法解决你遇到的身份验证问题，请通过开发者社区联系我们。