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

工作流活动

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

等待队列项目

UiPath.Core.Activities.WaitQueueItem

描述

从指定的Orchestrator队列检索队列项目,并将其存储在QueueItem变量中。此活动与获取事务项目活动不同,因为在运行时,如果指定的队列为空,则该活动会向 Orchestrator 发送一条消息,声明它已准备好接收队列项目,然后会等待要添加到的新队列项目指定的队列。检索到队列项目后,系统会将其状态设置为“正在进行”

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、跨平台配置

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

    备注:

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

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

    不接受尾随斜杠。

  • 队列名称- 要从中搜索队列项目的队列名称。此字段仅支持字符串和字符串变量。

    备注:

    要使“等待队列项目”活动使用机器人的实时通信方法,系统活动包版本和 Orchestrator 版本必须均低于 v20.10,或均高于 v20.10。否则,“等待队列项目”活动不使用机器人的实时通信方法,并且其最大延迟等于心跳间隔的持续时间。心跳间隔的默认持续时间为 30 秒,可以在 Orchestrator 中进行配置。

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

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

高级选项

选项

  • 轮询时间(毫秒)- 指定两次尝试检索新项目之间的时间间隔(以毫秒为单位)。默认值为 30000 毫秒(30 秒)。
  • “筛选器策略”- 根据引用筛选时要使用的策略。可选择以下选项:
    • “起始值”- 查找以“引用”字段的指定值为引用起点的项目。
    • “相等”- 查找引用值与“引用”字段的指定值相同的项目。
  • “引用” - 根据项目的引用筛选项目。表达式不能超过 128 个字符,也不包含单引号字符'
  • “超时(毫秒)”- 指定最长等待时间(以毫秒为单位),如果超出该时间后活动并未运行,系统便会抛出错误。默认值为 300000 毫秒 (300 秒)。
  • “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(TrueFalse)。默认值为 False。因此,如果未配置该字段且活动引发错误,系统将停止执行项目。如果该值设为“True”,则无论出现何种错误,系统都将继续执行项目。

输出

  • “结果”- 此为检索到的队列项目,存储在“QueueItem”变量中。

Windows - 旧版配置

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

    要使“等待队列项目”活动使用机器人的实时通信方法,系统活动包版本和 Orchestrator 版本必须均低于 v20.10,或均高于 v20.10。否则,“等待队列项目”活动不使用机器人的实时通信方法,并且其最大延迟等于心跳间隔的持续时间。心跳间隔的默认持续时间为 30 秒,可以在 Orchestrator 中进行配置。

输入
  • 轮询时间(毫秒)- 指定两次尝试检索新项目之间的时间间隔(以毫秒为单位)。默认值为 30000 毫秒(30 秒)。
  • “队列名称”- 要从中搜索队列项目的队列名称。此字段仅支持字符串和字符串变量。
其他
  • 文件夹路径- 指定队列所在的文件夹路径(可能与运行流程的文件夹不同)。此字段仅支持字符串值,并使用/作为分隔符来表示子文件夹。例如"Finance/Accounts Payable"

    备注:

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

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

    不接受尾随斜杠。

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

输出

  • “结果”- 此为检索到的队列项目,存储在“QueueItem”变量中。

参考

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

此页面有帮助吗?

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