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

构建一个示例自动化，在 UiPath Studio 中使用 Microsoft Teams 活动检索团队、频道和消息。

概述

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

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

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

1. 与已注册的 Microsoft Teams 应用程序（ Microsoft Teams 作用域）建立连接。

2. 查找并返回与您的团队搜索查询（ “获取团队”）匹配的团队。

3. 从指定的团队中查找并返回与频道搜索查询 匹配的频道（获取频道）。

4. 从指定频道检索所有消息（获取消息）。

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

   

先决条件

在开始之前：

1. 完成 Microsoft Teams设置步骤。
2. 创建或使用现有团队和频道，发送至少一条消息并回复该消息。
   • 要使用与本指南中相同的值，请创建并发送以下内容：
     • 团队名称: Quickstart_Test1
     • 通道： QS4_Channel
     • 消息 1：来自 UiPath 的消息，您好！
     • 回复 1：嘿嘿
     • 回复 2：很高兴来到这里!
     • 消息 2：会议时间是几点？
     • 回复 1：上午 11 点

步骤

构建项目

1. 将“Microsoft Teams 作用域”活动添加到您的项目。
2. 输入已注册应用程序的应用程序 ID（有关更多信息，请参阅此处）。
   • 有关更多信息，请参阅 设置 指南中的 注册应用程序 部分。
3. 从“身份验证类型”下拉列表中，选择适用的身份验证流程（例如， “交互式令牌”）。
   • 有关更多信息，请参阅“Microsoft Teams 作用域中的 Unattended 与 Attended 自动化” 页面。
4. 在“Microsoft Teams 作用域”活动之后添加“获取 Teams” 活动。
5. 从“列表类型”下拉列表中选择要检索的团队类型（例如MyJoinedTeams ）
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[]变量（例如myReplies ）。

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

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

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

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

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

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

    

操作完毕！

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

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

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