搜索

UiPath.Slack.Activities.Channels.Search

概述

搜索活动使用 Slack search.all API 查找与搜索参数（查询）匹配的消息和文件。 搜索参数遵循的修饰符与您在 Slack 应用程序中搜索时使用的修饰符相同（例如， "in:#channel-name, in:@user.name,keyword" ）。 有关更多信息，请参阅 Slack 帮助文档中的在 Slack 中搜索。

执行搜索后，该活动将返回匹配的 Message 对象（FirstMessage 和 Messages）和 SlackFile 对象（FirstFile 和 Files），您可以在后续活动（例如， 下载文件）中将其用作输入变量。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成 设置 步骤。
2. 将“ Slack 作用域 ”活动添加到您的项目中。
3. 在“ 松弛作用域 ”活动中添加“搜索”活动。
4. 输入“ 输入 ”属性的值。

5. 为“ 输出 ”属性创建并输入以下变量。

   • SlackFile 和 SlackFile[]
   • Message 和 Message[]

6. 运行活动。

   • 您的输入属性值将发送到search.all API。
   • API 将 SlackFile、 SlackFile[]、 Message和 Message[] 值返回到您的输出属性变量。
     
     

     

     
     

在活动正文中

• 查询 - 您的搜索参数（例如，频道、用户、关键字）。 此字段仅支持 Strings 或 String 变量。
• MaxResults - 您希望在 Message 和 SlackFile 数组中返回的最大结果数。 此字段仅支持 Int32 或 Int32 变量。

• “排序依据” - 指定结果返回时的排序方式。 从三个选项中选择：“相关性”、“最新”、“最旧”。 三个选项将相应地排序：

  • 相关性 - 包含与您的查询最匹配的内容的消息和文件。
  • “最新” - 包含与您的查询匹配的内容的最新消息和文件。
  • 最早 - 包含与查询匹配的内容的最早消息和文件。
• “文件” - 包含与“ 查询 ”值匹配的内容的文件。 输入 File[] 变量。
• “消息 ” - 包含与“ 查询 ”值匹配的内容的消息。 输入 Message[] 变量。
  • 如果未找到任何消息，则返回空数组。
  • Message 对象还包含文件信息。 您可以通过获取 Message 对象的 File 属性（例如 item.File(0))
  • 如果计划使用该活动来处理数组输出，请选择 UiPath.Slack.Models.Message 作为类型参数。

属性

常见

• “显示名称”- 活动的显示名称。此字段仅支持 Strings 和 String 变量。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

• “响应 状态” - 请求的状态（成功/失败信息）。 输入 ResponseStatus 变量 (UiPath.BAF.Models.ResponseStatus)。 ResponseStatus 对象包含三个可在其他活动中使用的属性。
  • “成功” - Boolean - 指定 API 请求是否成功。
  • 错误代码 - String - API 请求不成功 (Success=False) 时的响应错误。
  • 消息 - String - 错误消息。

示例

下图显示了活动依赖关系和输入/输出属性值的示例。

有关分步说明和示例，请参阅 快速入门 指南。