工作流活动

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

获取事务项目

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”相匹配。