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

工作流活动

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

添加队列项目并获取引用

UiPath.Persistence.Activities.Queue.AddQueueItemAndGetReference

描述

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、Windows - 旧版配置

设计器面板
  • Queue Name - The queue where the QueueItem object is to be added. The name is case insensitive, meaning that if in Orchestrator it was defined as "MyFirstQueue", it matches "myfirstqueue". The maximum number of characters is 50.
  • Priority - The priority level of the Queue Item that is added. This property is a criterion for the prioritization of queue items, alongside Due Date and Defer Date.
  • “项目信息”- 有关要添加的特定队列项目的附加信息集合。信息存储在项目中,并在事务处理期间使用。建议仅使用以下类型的原始值: 数字、布尔值、字符串和日期时间。字符串参数的值不能包含以下字符: [" "。参数名称不得包含以下字符: :.,@"
  • “队列项目(输出)” - 创建队列后从 Orchestrator 作为QueueItemData对象返回的队列项目。可以将此对象传递给“等待队列项目并继续”活动,以便在事务完成之前暂停工作流的执行。
属性面板

常见

  • ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

    备注:

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

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

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

输入

  • Deadline - The timestamp before which the queue item should be processed. This property can be filled in with relative timestamps such as DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) and DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Additionally, you can use the US notation to add an exact time, such as 12/10/2017 07:40:00. Automatically correcting this date is available. For example, if you write 8 9 2018 9:0, it is automatically transformed to 08/09/2018 09:00:00.

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

    备注:

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

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

  • ItemInformationCollection - Enables importing an entire dictionary of information for a queue item. This field accepts Dictionary<string, object> variables only.

  • “延期”- 处理队列项目之前的时间戳。除了“截止日期”和“延期日期”之外,此属性也是一个用于确定队列项目优先级的条件。此属性可以使用相对时间戳填充,例如 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 the prioritization of queue items, alongside Due Date and Defer Date.

  • Queue Name - The queue where the QueueItem object is to be added. The name is case insensitive, meaning that if in Orchestrator it was defined as "MyFirstQueue", it matches "myfirstqueue". The maximum number of characters is 50.

  • Reference - The reference of the Queue Item that is added. The reference can be used to link your transactions to other applications used within an automation project. Additionally, this feature enables you to search for certain transactions, in Orchestrator, according to the provided string.

其他

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

输出

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

跨平台配置

  • Queue Name - The queue where the QueueItem object is to be added. The name is case insensitive, meaning that if in Orchestrator it was defined as "MyFirstQueue", it matches "myfirstqueue". The maximum number of characters is 50.
  • Priority - The priority level of the Queue Item that is added. This property is a criterion for the prioritization of queue items, alongside Due Date and Defer Date.
  • “项目信息”- 有关要添加的特定队列项目的附加信息集合。信息存储在项目中,并在事务处理期间使用。建议仅使用以下类型的原始值: 数字、布尔值、字符串和日期时间。字符串参数的值不能包含以下字符: [" "。参数名称不得包含以下字符: :.,@"
  • “队列项目(输出)” - 创建队列后从 Orchestrator 作为QueueItemData对象返回的队列项目。可以将此对象传递给“等待队列项目并继续”活动,以便在事务完成之前暂停工作流的执行。
高级选项

常见

  • ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

    备注:

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

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

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

输入

  • Deadline - The timestamp before which the queue item should be processed. This property can be filled in with relative timestamps such as DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) and DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Additionally, you can use the US notation to add an exact time, such as 12/10/2017 07:40:00. Automatically correcting this date is available. For example, if you write 8 9 2018 9:0, it is automatically transformed to 08/09/2018 09:00:00.

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

    备注:

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

  • ItemInformationCollection - Enables importing an entire dictionary of information for a queue item. This field accepts Dictionary<string, object> variables only.

  • “延期”- 处理队列项目之前的时间戳。除了“截止日期”和“延期日期”之外,此属性也是一个用于确定队列项目优先级的条件。此属性可以使用相对时间戳填充,例如 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.

  • Queue Name - The queue where the QueueItem object is to be added. The name is case insensitive, meaning that if in Orchestrator it was defined as "MyFirstQueue", it matches "myfirstqueue". The maximum number of characters is 50.

  • Reference - The reference of the Queue Item that is added. The reference can be used to link your transactions to other applications used within an automation project. Additionally, this feature enables you to search for certain transactions, in Orchestrator, according to the provided string.

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

此页面有帮助吗?

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