工作流活动

上次更新日期 2025年10月31日

获取事务项目

UiPath.Core.Activities.GetQueueItem

从 Orchestrator 队列中获取一个项目，以便您可以处理 (启动事务) 并将其状态设置为“处理中”。并将其状态设置为“处理中”。

请注意，要执行此活动，机器人角色需要对队列具有编辑权限。该活动在执行它的 Robot 下运行。

如果队列为空，则系统会在访问检索到的“TransactionItem”时抛出以下错误：System.Exception: Object reference not set to an instance of an object.

Windows - 旧版 | Windows | 跨平台

Orchestrator 文件夹路径 - 指定队列所在的文件夹路径（可能与运行流程的文件夹不同）。此字段仅支持字符串值，并使用 / 作为分隔符来表示子文件夹。例如："Finance/Accounts Payable"。
备注：
Orchestrator FolderPath参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。

X-UIPATH-FolderPath-Encoded 参数支持相对文件夹路径，如下所示：
- 以 / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。
- 以 / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。
- 以 . 开头的路径 - 从环境文件夹开始。
- 以 .. 开头的路径 - 路径中的每个 .. 表示在环境文件夹的层次结构中向上一层（例如 ../ 表示向上一层，../../ 表示向上两层）。
不接受尾随斜杠。
队列名称- 要添加QueueItem对象的队列。名称不区分大小写，这意味着如果在 Orchestrator 中将其定义为“MyFirstQueue”，则它与“myfirstqueue”匹配。要在 Orchestrator 文件夹中管理队列，请选择“管理队列” 。

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

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

选项

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

输出

事务项目 - 此为检索到的事务项目，存储在 QueueItem 变量中。
“特定数据” - 此属性可用于具有架构定义的队列。允许您从队列的特定内容架构访问属性。

如果队列已应用新的架构版本，请单击“刷新” 以检索最新更改。

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

队列名称 - 要添加 QueueItem 对象的队列。名称不区分大小写，这表示如果在 Orchestrator 中将其定义为 “MyFirstQueue”，则其会与 “myfirstqueue”相匹配。