activities
latest
false
UiPath logo, featuring letters U and I in white

工作流活动

上次更新日期 2024年12月20日

获取事务项目

UiPath.Core.Activities.GetQueueItem

描述

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

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

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台、Windows 配置

  • Orchestrator 文件夹路径 - 指定队列所在的文件夹路径(可能与运行流程的文件夹不同)。此字段仅支持字符串值,并使用 / 作为分隔符来表示子文件夹。例如:"Finance/Accounts Payable"
    备注:
    Orchestrator FolderPath参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。
    X-UIPATH-FolderPath-Encoded 参数支持相对文件夹路径,如下所示:
    • / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。
    • / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。
    • . 开头的路径 - 从环境文件夹开始。
    • .. 开头的路径 - 路径中的每个 .. 表示在环境文件夹的层次结构中向上一层(例如 ../ 表示向上一层,../../ 表示向上两层)。

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

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

    要在 Orchestrator 文件夹中管理队列,请单击“管理队列”。

高级选项

选项

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

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

输出

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

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

Windows - 旧版配置

属性面板
选项
  • “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此,如果该字段为空且活动引发错误,系统将停止执行项目。如果该值设为“True”,则无论出现何种错误,系统都将继续执行项目。
  • “显示名称”- 活动的显示名称。
  • “超时(以毫秒为单位)”- 指定最长等待时间(以毫秒为单位),如果超出该时间后活动并未运行,系统便会抛出错误。默认值为 30000 毫秒(30 秒)。
输入
  • 队列名称 - 要添加 QueueItem 对象的队列。名称不区分大小写,这表示如果在 Orchestrator 中将其定义为 “MyFirstQueue”,则其会与 “myfirstqueue”相匹配。
其他
  • 文件夹路径 - 指定队列所在的文件夹路径(可能与运行流程的文件夹不同)。此字段仅支持字符串值,并使用 / 作为分隔符来表示子文件夹。例如:"Finance/Accounts Payable"
    备注:
    FolderPath参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。
    X-UIPATH-FolderPath-Encoded 参数支持相对文件夹路径,如下所示:
    -right: 以 / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。
    -right: 以 . 开头的路径 - 从环境文件夹开始。
    -right: 以 .. 开头的路径 - 对于路径中的每个 ..,在环境文件夹的层次结构中向上启动一个级别(例如../ 表示上一级,../../ 表示上两级)。

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

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

输出

  • 事务项目 - 此为检索到的事务项目,存储在 QueueItem 变量中。

参考

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

    • 起始值 - 查找以引用字段的指定值为引用起点的项目。
    • 相等 - 查找引用值与引用字段的指定值相同的项目。
  • 引用 - 根据项目的引用筛选项目。
  • 描述
  • 项目兼容性
  • 跨平台、Windows 配置
  • Windows - 旧版配置

此页面有帮助吗?

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