从 ALM 发送即时消息

此任务描述如何向与特定 ALM 实体关联的用户发送 Microsoft Teams 消息。例如,处理相同缺陷、测试或需求的用户。

先决条件

在发送 Teams 聊天之前,请完成以下配置任务。

在 Microsoft Azure 应用服务中

在 Microsoft Azure 应用服务中完成以下任务:

  1. 在 Microsoft Azure 应用服务中创建您的应用程序。

  2. 打开应用程序。在“身份验证”选项卡的“移动和桌面应用程序”部分中,添加以下重定向 URI:

    https://login.microsoftonline.com/common/oauth2/nativeclient

  3. 在“API 权限”选项卡中,添加 Microsoft Graph API 的以下权限:

    • Channel.ReadBasic.All

    • ChannelMessage.Send

    • ChatMessage.Send

    • offline_access

    • Presence.Read

    • Presence.Read.All

    • Team.ReadBasic.All

    • User.Read

    • User.ReadBasic.All

  4. 单击“授予 <您的租户名称> 的管理员同意”按钮。

有关创建和配置应用程序的详细信息,请参考 Microsoft Azure 应用服务文档。

在 ALM 站点管理中

在 ALM 站点管理中完成以下任务:

  • 设置以下站点参数:

    • ENABLE_TEAMS_INTEGRATION 设置为 Y

    • TEAMS_APP_CLIENT_ID设置为应用程序的应用程序 (客户端) ID。

    • TEAMS_APP_TENANT_ID 设置为应用程序的目录 (租户) ID。

    有关应用程序的客户端 ID 和租户 ID 的信息,请转到 Microsoft Azure 应用服务中您的应用程序的“概述”选项卡。

    有关设置站点参数的详细信息,请参阅设置配置参数

  • 用户必须在 ALM 中定义其电子邮件地址。有关设置用户的详细信息,请参阅管理项目中的用户
在防火墙中添加 URL

如果您的组织受到防火墙或代理服务器的保护,请将以下 URL 添加到允许列表,以确保 ALM 客户端可以访问 Microsoft Teams 资源:

  • https://aadcdn.msftauth.net

  • https://login.microsoftonline.com/

  • https://graph.microsoft.com/

返回页首

从实体窗体开始 Teams 聊天

从实体窗体开始 Microsoft Teams 聊天:

  1. 打开实体窗体。

  2. 找到定义了您要与其聊天的用户的用户字段。

  3. 单击用户名左侧的 Microsoft Teams 状态指示器。

    在您使用 ALM 帐户的电子邮件地址登录 Microsoft Teams 之前,该指示器为灰色,不会反映用户的实时 Teams 状态。Teams 状态每 10 秒同步一次。

    如果这是您第一次在当前 ALM 会话中单击指示器,Microsoft 登录窗口将打开并提示您登录 Microsoft。

  4. 与用户的 Teams 聊天窗口将打开,显示一条等待发送的自动消息。

    该消息包括实体的链接和常规信息,例如名称、ID 和摘要。

    已知问题: 由于 Microsoft Teams 中的 API 更改,实体的链接将以纯文本格式显示。要在 ALM 中打开实体,请执行以下任一操作:

    • 复制实体地址 (括在括号中) 并将其粘贴到浏览器中。

    • 删除消息末尾的右括号 ")",然后手动添加右括号。纯文本将变成可点击的链接。

    如果在创建新实体时开始 Teams 聊天,则不会显示自动消息。

  5. 单击“发送”按钮。该消息成为一个链接,使聊天参与者能够在 ALM 中打开实体。

  6. 向用户发送其他消息。

返回页首

另请参见: