activities
latest
false
重要 :
请注意,此内容已使用机器翻译进行了部分本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

工作流活动

上次更新日期 2026年2月19日

获取队列项目

UiPath.Core.Activities.GetQueueItems

描述

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

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

重要提示:

如果在使用“ 结束” 或“起始”日期筛选器时,“获取队列项目” 活动引发错误,请在“Orchestrator”>“租户”>“设置”>“常规”>“API 设置” 中禁用“严格 API 设置”。

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台、Windows 配置

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

    备注:

    Orchestrator Folder Path参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。X-UIPATH-FolderPath-Encoded标头中支持相对文件夹路径,如下所示:

    • / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。
    • . 开头的路径 - 从环境文件夹开始。
    • .. 开头的路径 - 路径中的每个 .. 表示在环境文件夹的层次结构中向上一层(例如 ../ 表示向上一层,../../ 表示向上两层)。

    不接受尾随斜杠。

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

1对于在 Studio Web 中创建的作为解决方案一部分的跨平台项目, Orchestrator 文件夹路径字段不可用。

2对于在 Studio Web 中创建的作为解决方案一部分的跨平台项目, “名称”字段提供了用于在设计时定义新的Orchestrator 资源(例如队列、资产或存储桶)或“打开 Orchestrator进行资源管理”的选项。

高级选项

选项

  • “持续时间”- 按上次尝试所花费的最短时间筛选事务。
  • “开始日期”- 按最早创建日期筛选事务。它接受DateTime值。
  • “结束日期”- 按最晚创建日期筛选事务。它接受DateTime值。
  • “优先级”- 根据事务的优先级筛选事务。该字段仅支持整数和整型变量。优先级如下:
    • 0 - 高;
    • 1 - 正常;
    • 2 - 低。
  • “队列项目状态” - 筛选队列项目状态。可选择以下选项:
    • “全部”- 默认选项。
    • 新添加
    • 正在进行
    • 失败
    • 成功
    • 已放弃
    • 已重试
    • 已删除
  • “筛选器策略”- 根据引用筛选时要使用的策略。可用的选项如下:
    • “起始值”- 查找以“引用”字段的指定值为引用起点的项目。
    • “相等”- 查找引用值与“引用”字段的指定值相同的项目。
  • 引用- 按引用筛选Orchestrator 队列项目。表达式不能超过 128 个字符,也不包含单引号字符'
  • Skip - Helps you skip the first "n" items. This property supports only integers and integer variables.
  • “置顶”- 仅返回总数中的指定项目数量。最大值为 100。该属性仅支持整数和整型变量。
  • “超时(毫秒)”- 指定最长等待时间(以毫秒为单位),如果超出该时间后活动并未运行,系统便会抛出错误。默认值为 30000 毫秒(30 秒)。
  • “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此,如果未配置该字段且活动引发错误,系统将停止执行项目。如果该值设为“True”,则无论出现何种错误,系统都将继续执行项目。

输出

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

Windows - 旧版配置

属性面板
常见
  • “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此,如果该字段为空且活动引发错误,系统将停止执行项目。如果该值设为“True”,则无论出现何种错误,系统都将继续执行项目。
  • “显示名称”- 活动的显示名称。
  • “超时(毫秒)”- 指定最长等待时间(以毫秒为单位),如果超出该时间后活动并未运行,系统便会抛出错误。默认值为 30000 毫秒(30 秒)。
输入
  • Queue Name - The name of the queue you want to extract data from. The name has to be the same as the one in Orchestrator and needs to have the same capitalization.
其他
  • 文件夹路径- 指定队列所在的文件夹路径(可能与运行流程的文件夹不同)。此字段仅支持字符串值,并使用/作为分隔符来表示子文件夹。例如"Finance/Accounts Payable"

    备注:

    Folder Path参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。X-UIPATH-FolderPath-Encoded标头中支持相对文件夹路径,如下所示:

    • / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。
    • . 开头的路径 - 从环境文件夹开始。
    • .. 开头的路径 - 路径中的每个 .. 表示在环境文件夹的层次结构中向上一层(例如 ../ 表示向上一层,../../ 表示向上两层)。

    不接受尾随斜杠。

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

选项

  • “持续时间”- 按上次尝试所花费的最短时间筛选事务。
  • “开始日期”- 按最早创建日期筛选事务。它接受DateTime值。
  • “优先级”- 根据事务的优先级筛选事务。该字段仅支持整数和整型变量。优先级如下:
    • 0 - 高;
    • 1 - 正常;
    • 2 - 低。
  • “队列项目状态” - 筛选队列项目状态。可选择以下选项:
    • “全部”- 默认选项。
    • 新添加
    • 正在进行
    • 失败
    • 成功
    • 已放弃
    • 已重试
    • 已删除
  • “结束日期”- 按最晚创建日期筛选事务。它接受DateTime值。

输出

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

分页

  • Skip - Helps you skip the first "n" items. This property supports only integers and integer variables.
  • “置顶”- 仅返回总数中的指定项目数量。最大值为 100。该属性仅支持整数和整型变量。

参考

  • “筛选器策略”- 根据引用筛选时要使用的策略。可用的选项如下:
    • “起始值”- 查找以“引用”字段的指定值为引用起点的项目。
    • “相等”- 查找引用值与“引用”字段的指定值相同的项目。
  • 引用- 按引用筛选Orchestrator 队列项目。表达式不能超过 128 个字符,也不包含单引号字符'
  • 描述
  • 项目兼容性
  • 跨平台、Windows 配置
  • Windows - 旧版配置

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo
信任与安全
© 2005-2026 UiPath。保留所有权利。