快速入门 - 获取团队、频道和消息

概述

本指南旨在帮助您创建一个使用不同 Microsoft Teams 活动的工作示例，这些活动包括“获取团队”、 “ 获取频道”、 “ 获取消息”和活动。

此工作示例使您能够快速验证与 已注册 的 Microsoft Teams 应用程序的连接，并熟悉活动的输入/输出数据类型。

完成本指南中的步骤后，您将获得一个自动化序列，该连接器将执行以下操作：

1. 建立与已注册的 Microsoft Teams 应用程序的连接（ Microsoft Teams 作用域）。
2. 查找并返回与您的团队搜索查询 (获取团队) 匹配的团队。
3. 在指定的团队中查找并返回与频道搜索查询 (获取频道) 匹配的频道。
4. 从指定频道检索所有消息 (获取消息)。

5. 通过输出消息正文内容并返回任何消息回复（遍历循环和写入行以及获取消息回复）来验证是否已检索消息。

   
   

   

   
   

先决条件

在开始之前：

1. 完成 Microsoft Teams 安装 步骤。

2. 创建或使用现有团队和频道，发送至少一条消息并回复该消息。

   • 要使用与本指南中相同的值，请创建并发送以下内容：

     • 团队名称： Quickstart_Test1
     • 频道： QS4_频道
     • 消息 1：来自 UiPath 的您好！
     • 回复 1: 嘿，嘿，嘿
     • 回复 2: 很高兴来到这里!
     • 消息 2：几点开会？
     • 回复 1：上午 11 点

步骤

构建您的项目

1. 将“ Microsoft Teams 作用域”活动添加到您的项目中。

2. 输入已注册应用程序的 应用 程序 ID。

   • 有关更多信息，请参阅 设置 指南中的 “ 注册应用程序 ”部分。

3. 从“身份验证 类型” 下拉列表中，选择适用的身份验证流程（例如，“ 交互式令牌”）。

   • 有关详细信息，请参阅“Microsoft Teams 作用域中的 无人值守自动化与有人值守 的自动化”活动页面。
4. 在“Microsoft Teams 作用域 ”活动之后添加“ 获取 Teams ”活动。
5. 从列表 类型 下拉列表中选择要检索的团队类型（例如 我加入的团队）

6. 输入查询选项以从团队列表中查找特定团队（例如，{New QueryOption ("filter", "displayName eq 'Team Name'")} ）。

   • 有关详细信息，请参阅 “ 获取 Teams” 活动 页面中的 “查询选项”部分。
7. 为 Teams 值创建并输入 Team[] 变量（例如， myTeams ）。
   • 创建变量时，选择“ Microsoft.Graph.Team ”作为变量类型。
8. 在 “ 获取团 队 ”活动之后添加“ 获取渠道 ”活动。

9. 输入查询选项以查找指定团队中的特定频道（例如 {New QueryOption("filter", "displayName eq 'channel Name'")} ） 。

   • 有关详细信息，请参阅 “ 获取渠道” 活动页面中的 “ 查询选项 ”部分。
10. 在“团队 ID” 属性中，输入您为“获取团队” 活动创建的 Team[] 变量。 要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， myTeams(0).Id ）。
11. 为“频道”值创建并输入 Channel[] 变量（例如， mychannels ）。
    • 创建变量时，选择 Microsoft.Graph.channel 作为变量类型。
12. 在“ 获取 渠道 ”活动之后添加“ 获取消息 ”活动。
13. 在“渠道 ID ” 属性中，输入您为“获取渠道” 活动创建的 Channel[] 变量。 要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， mychannels(0).Id ）。
14. 在“团队 ID” 属性中，输入您为“获取团队” 活动创建的 Team[] 变量。 要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， myTeams(0).Id ）。
15. 要限制要输出的消息数量，请在“限制” 属性中输入一个较小的数字（例如5 ）。
16. 创建并输入“消息”值 ChatMessage[] 变量（例如， myMessages ）。

    • 创建变量时，选择“ Microsoft.Graph.ChatMessage ”作为变量类型。

      
      

      

      
      

测试您的项目

1. 要测试您的活动是否检索了“团队”、“频道”和“消息”，请在“ 获取消息 ”活动之后添加“ 遍历 循环”活动。

   1. 在“类型参数” 属性中，选择“ Microsoft.Graph.ChatMessage”。
   2. 在 值 属性中，输入您为 获取消息 活动创建的 ChatMessage[] 变量（例如， myMessages ）。

2. 在“遍历循环”活动中，添加“写入行”活动。

   1. 在“文本”属性中，输入 “消息：”+ item.Body.Content

3. 在“ 写入行 ”活动之后添加“ 获取消息回复 ”活动。

   1. 在“渠道 ID ” 属性中，输入您为“获取渠道” 活动创建的 Channel[] 变量。 要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， mychannels(0).Id ）。
4. 要限制要输出的消息数量，请在“限制” 属性中输入一个较小的数字（例如2 ）。
5. 在“消息 ID ” 属性中，输入 “项目 ID” 以获取每条已检索消息的回复。
6. 在“团队 ID” 属性中，输入您为“获取团队” 活动创建的 Team[] 变量。 要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， myTeams(0).Id ）。
7. 为“ 消息回复 ChatMessage[] ”值创建并输入 变量（例如，myRepries ）。
   • 创建变量时，选择 _Microsoft.Graph.ChatMessage_ 作为变量类型。

8. 在“ 获取消息回复 ”活动之后添加另一个“遍历 循环”活动。

   1. 在“类型参数” 属性中，选择“ Microsoft.Graph.ChatMessage”。
   2. 在 值 属性中，输入您为 获取消息回复 活动创建的 ChatMessage[] 变量（例如，我的回复）。

9. 在“遍历循环”活动中，添加“写入行”活动。

   1. 在“文本”属性中，输入 “回复：”+ item.Body.Content

10. 单击 “运行” 并验证“输出”窗口是否包含您的消息及其关联的回复。

    
    

    

    
    

操作完毕！

准备就绪后，请尝试其他 快速入门 指南，以更熟悉不同的 Microsoft Teams 活动。

要了解有关 Microsoft Teams 活动（包括示例属性输入/输出）的更多信息，请参阅以下活动页面以获取完整的活动列表以及指向活动详细信息页面的链接。

• 频道
• 聊天
• 消息
• 团队