活动

获取队列项目

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 值。