等待队列项目

UiPath.Core.Activities.WaitQueueItem

描述

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、跨平台配置

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

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

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

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

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

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

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

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

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

高级选项

选项

• 轮询时间（毫秒）- 指定两次尝试检索新项目之间的时间间隔（以毫秒为单位）。默认值为 30000 毫秒（30 秒）。

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

  • 起始值 - 查找以引用字段的指定值为引用起点的项目。
  • 相等 - 查找引用值与引用字段的指定值相同的项目。
• 引用 - 根据项目的引用筛选项目。
• 超时（以毫秒为单位）- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 300000 毫秒 (300 秒)。
• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果未配置该字段且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

输出

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

Windows - 旧版配置

属性面板

常见

• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
• “显示名称”- 活动的显示名称。

• 超时（以毫秒为单位）- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 300000 毫秒 (300 秒)。

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

输入

• 轮询时间（毫秒）- 指定两次尝试检索新项目之间的时间间隔（以毫秒为单位）。默认值为 30000 毫秒（30 秒）。
• 队列名称- 要从中搜索队列项目的队列名称。此字段仅支持字符串和字符串变量。

其他

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

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

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

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

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

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

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

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

输出

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

参考

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

  • 起始值 - 查找以引用字段的指定值为引用起点的项目。
  • 相等 - 查找引用值与引用字段的指定值相同的项目。
• 引用 - 根据项目的引用筛选项目。