获取队列项目

UiPath.Core.Activities.GetQueueItems

描述

使您能够根据创建日期、优先级、状态和引用等多个筛选条件，从指定的 Orchestrator 队列中检索最多包含 100 个事务的列表。 使用“ 分页 ”属性可以获取不同的集合。

此处提供了该活动的用法示例。

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台、Windows 配置

• Orchestrator 文件夹路径 - 指定队列所在的文件夹路径（可能与运行流程的文件夹不同）。此字段仅支持字符串值，并使用 / 作为分隔符来表示子文件夹。例如："Finance/Accounts Payable"。
  备注：

  Orchestrator Folder Path参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。

  X-UIPATH-FolderPath-Encoded 参数支持相对文件夹路径，如下所示：

  -right: 以 / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。

  -right: 以 . 开头的路径 - 从环境文件夹开始。

  -right: 以 .. 开头的路径 - 对于路径中的每个 ..，在环境文件夹的层次结构中向上启动一个级别（例如../ 表示上一级，../../ 表示上两级）。

  请注意，不应包含尾随斜杠。

• 队列名称 - 要从中提取数据的队列的名称。该名称必须与 Orchestrator 中的名称相同，且要使用相同的大小写。

高级选项

选项

• 持续时间 - 按上次尝试所花费的最短时间筛选事务。
• 开始日期 - 按最早创建日期筛选事务。它接受 DateTime 值。
• 结束日期 - 按最晚创建日期筛选事务。它接受 DateTime 值。

• 优先级 - 根据事务的优先级筛选事务。此字段仅支持整数和整数变量。优先级如下：

  • 0 - 高；
  • 1 - 正常；
  • 2 - 低。

• 队列项目状态 - 筛选队列项目状态。可选择以下选项：

  • 全部 - 默认选项。
  • 新添加
  • 正在进行
  • 失败
  • 成功
  • 已放弃
  • 已重试
  • 已删除

• 筛选器策略 - 根据引用筛选时要使用的策略。可选择以下选项：

  • 起始值 - 查找以引用字段的指定值为引用起点的项目。
  • 相等 - 查找引用值与引用字段的指定值相同的项目。
• “引用 ” - 按引用筛选 Orchestrator 队列 项目。
• 跳过 - 帮助您跳过前“n”个作业。此属性仅支持整数和整数变量。
• 置顶 - 仅返回总数中的指定作业数量。最大值为 100。此属性仅支持整数和整数变量。
• “超时（以毫秒为单位）”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。
• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果未配置该字段且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

输出

• 队列项目 - 要标记为从 Orchestrator 检索的项目列表。此属性仅支持 IEnumerable<队列项目> 变量。

Windows - 旧版配置

属性面板

常见

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
• “显示名称”- 活动的显示名称。
• “超时（以毫秒为单位）”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

输入

• 队列名称 - 要从中提取数据的队列的名称。该名称必须与 Orchestrator 中的名称相同，且要使用相同的大小写。

其他

• 文件夹路径 - 指定队列所在的文件夹路径（可能与运行流程的文件夹不同）。此字段仅支持字符串值，并使用 / 作为分隔符来表示子文件夹。例如："Finance/Accounts Payable"。
  备注：

  FolderPath参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。

  X-UIPATH-FolderPath-Encoded 参数支持相对文件夹路径，如下所示：

  -right: 以 / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。

  -right: 以 . 开头的路径 - 从环境文件夹开始。

  -right: 以 .. 开头的路径 - 对于路径中的每个 ..，在环境文件夹的层次结构中向上启动一个级别（例如../ 表示上一级，../../ 表示上两级）。

  请注意，不应包含尾随斜杠。

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

选项

• 持续时间 - 按上次尝试所花费的最短时间筛选事务。
• 开始日期 - 按最早创建日期筛选事务。它接受 DateTime 值。

• 优先级 - 根据事务的优先级筛选事务。此字段仅支持整数和整数变量。优先级如下：

  • 0 - 高；
  • 1 - 正常；
  • 2 - 低。

• 队列项目状态 - 筛选队列项目状态。可选择以下选项：

  • 全部 - 默认选项。
  • 新添加
  • 正在进行
  • 失败
  • 成功
  • 已放弃
  • 已重试
  • 已删除
• 结束日期 - 按最晚创建日期筛选事务。它接受 DateTime 值。

输出

• 队列项目 - 要标记为从 Orchestrator 检索的项目列表。此属性仅支持 IEnumerable<队列项目> 变量。

分页

• 跳过 - 帮助您跳过前“n”个作业。此属性仅支持整数和整数变量。
• 置顶 - 仅返回总数中的指定作业数量。最大值为 100。此属性仅支持整数和整数变量。

参考

• 筛选器策略 - 根据引用筛选时要使用的策略。可选择以下选项：

  • 起始值 - 查找以引用字段的指定值为引用起点的项目。
  • 相等 - 查找引用值与引用字段的指定值相同的项目。
• “引用 ” - 按引用筛选 Orchestrator 队列 项目。