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

工作流活动

上次更新日期 2026年4月16日

添加队列项目并获取引用

UiPath.Persistence.Activities.Queue.AddQueueItemAndGetReference

描述

添加带有参数的 Orchestrator 队列项目,并检索存储在 QueueItemData 变量中的相应队列项目对象,以便在工作流执行期间随时等待事务完成。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、Windows - 旧版配置

设计器面板
  • “队列名称” - 将要添加队列项目对象的队列。名称不区分大小写,这表示如果在 Orchestrator 中将其定义为 “MyFirstQueue”,则其会与 “myfirstqueue”相匹配。最大字符数为50
  • “优先级” - 所添加队列项目的优先级。除了“到期日期”“推迟日期”之外,此属性也是一个用于确定队列项目优先级的条件。
  • “项目信息”- 有关要添加的特定队列项目的附加信息集合。信息存储在项目中,并在事务处理期间使用。建议仅使用以下类型的原始值: 数字、布尔值、字符串和日期时间。字符串参数的值不能包含以下字符: [" "。参数名称不得包含以下字符: :.,@"
  • “队列项目(输出)” - 创建队列后从 Orchestrator 作为QueueItemData对象返回的队列项目。可以将此对象传递给“等待队列项目并继续”活动,以便在事务完成之前暂停工作流的执行。
属性面板

常见

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

    备注:

    如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”,则系统在执行项目时不会捕获任何错误。

  • “显示名称”- 活动的显示名称。

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

输入

  • “截止日期” - 应在此之前处理队列项目的时间戳。可以使用相对时间戳填充此属性,例如DateTime.Now.AddHours(2)DateTime.Now.AddDays(10)DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)) 。此外,您可以使用美国日期表示法来添加确切时间,例如12/10/2017 07:40:00 。系统能自动更正此日期。例如,如果您写入8 9 2018 9:0 ,系统会将其自动转换为08/09/2018 09:00:00

  • Orchestrator 文件夹路径- 与当前流程所在的不同的Orchestrator 文件夹的路径(要在其中创建队列项目)。要了解有关 Orchestrator 文件夹的更多信息,请转到此处。对于传统文件夹,此属性只能用于浮动机器人,并且仅在当前用户在目标文件夹中具有正确的任务权限时才可用。对于新式文件夹,不支持文件夹路径覆盖。此字段仅支持字符串和String变量。

    备注:

    当必须从当前文件夹以外的文件夹启动或查询队列项目时,才必须使用“文件夹路径”属性。如果执行此操作的用户没有目标文件夹所需的权限,则队列项目启动将失败并引发严重错误。您可以在此处查看有关文件夹权限的更多信息。

  • “项目信息”- 有关要添加的特定队列项目的附加信息集合。信息存储在项目中,并在事务处理期间使用。建议仅使用以下类型的原始值: 数字、布尔值、字符串和日期时间。字符串参数的值不能包含以下字符: [" "。参数名称不得包含以下字符: :.,@"

  • “项目信息集合” - 支持导入队列项的整个信息字典。该字段仅接受Dictionary<string, object>变量。

  • “延期”- 处理队列项目之前的时间戳。除了“截止日期”和“延期日期”之外,此属性也是一个用于确定队列项目优先级的条件。此属性可以使用相对时间戳填充,例如 DateTime.Now.AddHours(2)DateTime.Now.AddDays(10)DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0))。此外,您可以使用美国日期表示法来添加确切时间,例如 12/10/2017 07:40:00。系统能自动更正此日期。例如,如果您写入 8 9 2018 9:0,系统会将其自动转换为 08/09/2018 09:00:00

  • “优先级” - 所添加队列项目的优先级。除了“到期日期”“推迟日期”之外,此属性也是一个用于确定队列项目优先级的条件。

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

  • 引用- 对所添加队列项目的引用。该引用可用于将您的事务链接到自动化项目中使用的其他应用程序。此外,此功能使您可以根据提供的字符串在 Orchestrator 中搜索特定事务。

其他

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

输出

  • “队列项目(输出)” - 创建队列后从 Orchestrator 作为QueueItemData对象返回的队列项目。可以将此对象传递给“等待队列项目并继续”活动,以便在事务完成之前暂停工作流的执行。

跨平台配置

  • “队列名称” - 将要添加队列项目对象的队列。名称不区分大小写,这表示如果在 Orchestrator 中将其定义为 “MyFirstQueue”,则其会与 “myfirstqueue”相匹配。最大字符数为50
  • “优先级” - 所添加队列项目的优先级。除了“到期日期”“推迟日期”之外,此属性也是一个用于确定队列项目优先级的条件。
  • “项目信息”- 有关要添加的特定队列项目的附加信息集合。信息存储在项目中,并在事务处理期间使用。建议仅使用以下类型的原始值: 数字、布尔值、字符串和日期时间。字符串参数的值不能包含以下字符: [" "。参数名称不得包含以下字符: :.,@"
  • “队列项目(输出)” - 创建队列后从 Orchestrator 作为QueueItemData对象返回的队列项目。可以将此对象传递给“等待队列项目并继续”活动,以便在事务完成之前暂停工作流的执行。
高级选项

常见

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

    备注:

    如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”,则系统在执行项目时不会捕获任何错误。

  • “显示名称”- 活动的显示名称。

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

输入

  • “截止日期” - 应在此之前处理队列项目的时间戳。可以使用相对时间戳填充此属性,例如DateTime.Now.AddHours(2)DateTime.Now.AddDays(10)DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)) 。此外,您可以使用美国日期表示法来添加确切时间,例如12/10/2017 07:40:00 。系统能自动更正此日期。例如,如果您写入8 9 2018 9:0 ,系统会将其自动转换为08/09/2018 09:00:00

  • “Orchestrator 文件夹路径” - 与当前流程运行的文件夹不同的Orchestrator 文件夹的路径(要在其中创建队列项目)。要了解有关 Orchestrator 文件夹的更多信息,请转到此处。对于传统文件夹,此属性只能用于浮动机器人,并且仅在当前用户在目标文件夹中具有正确的任务权限时才可用。对于新式文件夹,不支持文件夹路径覆盖。此字段仅支持字符串和String变量。

    备注:

    当必须从当前文件夹以外的文件夹启动或查询队列项目时,才必须使用“文件夹路径”属性。如果执行此操作的用户没有目标文件夹所需的权限,则队列项目启动将失败并引发严重错误。您可以在此处查看有关文件夹权限的更多信息。

  • “项目信息集合” - 支持导入队列项的整个信息字典。该字段仅接受Dictionary<string, object>变量。

  • “延期”- 处理队列项目之前的时间戳。除了“截止日期”和“延期日期”之外,此属性也是一个用于确定队列项目优先级的条件。此属性可以使用相对时间戳填充,例如 DateTime.Now.AddHours(2)DateTime.Now.AddDays(10)DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0))。此外,您可以使用美国日期表示法来添加确切时间,例如 12/10/2017 07:40:00。系统能自动更正此日期。例如,如果您写入 8 9 2018 9:0,系统会将其自动转换为 08/09/2018 09:00:00

  • Priority - The priority level of the Queue Item that is added. This property is a criterion for prioritizing queue items, alongside Due Date and Defer Date.

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

  • 引用- 对所添加队列项目的引用。该引用可用于将您的事务链接到自动化项目中使用的其他应用程序。此外,此功能使您可以根据提供的字符串在 Orchestrator 中搜索特定事务。

  • 描述
  • 项目兼容性
  • Windows、Windows - 旧版配置
  • 跨平台配置

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新