UiPath Marketplace 用户指南

上次更新日期 2024年9月5日

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

概述

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

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

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

建立与已注册的 Microsoft Teams 应用程序的连接（ Microsoft Teams 作用域）。
查找并返回与您的团队搜索查询 (获取团队) 匹配的团队。
在指定的团队中查找并返回与频道搜索查询 (获取频道) 匹配的频道。
从指定频道检索所有消息 (获取消息)。
通过输出消息正文内容并返回任何消息回复（ “遍历循环”、“写入行”和 “获取消息回复” ），验证是否已检索到消息。

先决条件

在开始之前：

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

步骤

构建您的项目

将“ Microsoft Teams 作用域”活动添加到您的项目中。
输入已注册应用程序的应用程序 ID。
- 有关更多信息，请参阅 设置指南中的 “ 注册应用程序 ”部分。
从“身份验证 类型” 下拉列表中，选择适用的身份验证流程（例如，“ 交互式令牌”）。
- 有关详细信息，请参阅“Microsoft Teams 作用域中的无人值守自动化与有人值守的自动化”活动页面。
在“Microsoft Teams 作用域 ”活动之后添加“ 获取 Teams ”活动。
从列表类型下拉列表中选择要检索的团队类型（例如 我加入的团队）
输入查询选项以从团队列表中查找特定团队（例如，{New QueryOption ("filter", "displayName eq 'Team Name'")} ）。
- 有关详细信息，请参阅 “ 获取 Teams” 活动页面中的 “查询选项”部分。
为 Teams 值创建并输入 Team[] 变量（例如， myTeams ）。
- 创建变量时，选择“ Microsoft.Graph.Team ”作为变量类型。
在 “ 获取团队 ”活动之后添加“ 获取渠道 ”活动。
输入查询选项以查找指定团队中的特定频道（例如 {New QueryOption("filter", "displayName eq 'channel Name'")} ）。
- 有关详细信息，请参阅 “ 获取渠道” 活动页面中的 “ 查询选项 ”部分。
在“团队 ID” 属性中，输入您为“获取团队” 活动创建的 Team[] 变量。要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， myTeams(0).Id ）。
为“频道”值创建并输入 Channel[] 变量（例如， mychannels ）。
- 创建变量时，选择 Microsoft.Graph.channel 作为变量类型。
在“ 获取 渠道 ”活动之后添加“ 获取消息 ”活动。
在“渠道 ID ” 属性中，输入您为“获取渠道” 活动创建的 Channel[] 变量。要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， mychannels(0).Id ）。
在“团队 ID” 属性中，输入您为“获取团队” 活动创建的 Team[] 变量。要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， myTeams(0).Id ）。
要限制要输出的消息数量，请在“限制” 属性中输入一个较小的数字（例如5 ）。
创建并输入“消息”值 ChatMessage[] 变量（例如， myMessages ）。
- 创建变量时，选择“ Microsoft.Graph.ChatMessage ”作为变量类型。

测试您的项目

要测试您的活动是否检索到“团队”、“频道”和“消息”，请在“ 获取消息 ”活动之后添加“ 遍历循环”活动。
1. 在“类型参数” 属性中，选择“ Microsoft.Graph.ChatMessage”。
2. 在值属性中，输入您为 获取消息 活动创建的 ChatMessage[] 变量（例如， myMessages ）。
在“ 遍历循环 ”活动中，添加“ 写入行 ”活动。
1. 在“文本”属性中，输入 “消息：”+ item.Body.Content
在“ 写入行 ”活动之后添加“ 获取消息回复 ”活动。
1. 在“渠道 ID ” 属性中，输入您为“获取渠道” 活动创建的 Channel[] 变量。要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， mychannels(0).Id ）。
要限制要输出的消息数量，请在“限制” 属性中输入一个较小的数字（例如2 ）。
在“消息 ID ” 属性中，输入 “项目 ID” 以获取每条已检索消息的回复。
在“团队 ID” 属性中，输入您为“获取团队” 活动创建的 Team[] 变量。要输入 String 值，请在数组中指定项目，并将 .Id 附加到变量的末尾（例如， myTeams(0).Id ）。
为“ 消息回复 ChatMessage[] ”值创建并输入变量（例如，myRepries ）。
- 创建变量时，选择 _Microsoft.Graph.ChatMessage_ 作为变量类型。
在“ 获取消息回复 ”活动之后添加另一个“遍历循环”活动。
1. 在“类型参数” 属性中，选择“ Microsoft.Graph.ChatMessage”。
2. 在值属性中，输入您为 获取消息回复 活动创建的 ChatMessage[] 变量（例如，我的回复）。
在“遍历循环”活动中，添加“写入行”活动。
1. 在“文本”属性中，输入 “回复：”+ item.Body.Content
单击 “运行” 并验证“输出”窗口是否包含您的消息及其关联的回复。