添加队列项目并获取引用

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 文件夹路径” - 与当前流程运行的文件夹不同的Orchestrator 文件夹的路径（要在其中创建队列项目）。要了解有关 Orchestrator 文件夹的更多信息，请转到此处。对于传统文件夹，此属性只能用于浮动机器人，并且仅在当前用户在目标文件夹中具有正确的任务权限时才可用。对于新式文件夹，不支持文件夹路径覆盖。此字段仅支持字符串和String变量。
• “队列名称” - 将要添加队列项目对象的队列。名称不区分大小写，这表示如果在 Orchestrator 中将其定义为 “MyFirstQueue”，则其会与 “myfirstqueue”相匹配。最大字符数为50 。
• “项目信息”- 有关要添加的特定队列项目的附加信息集合。信息存储在项目中，并在事务处理期间使用。建议仅使用以下类型的原始值: 数字、布尔值、字符串和日期时间。字符串参数的值不能包含以下字符: [ 和 " "。参数名称不得包含以下字符: :、.、,、@、"。
• “优先级” - 所添加队列项目的优先级。除了“到期日期”和“推迟日期”之外，此属性也是一个用于确定队列项目优先级的条件。
• “队列项目（输出）” - 创建队列后从 Orchestrator 作为QueueItemData对象返回的队列项目。可以将此对象传递给“等待队列项目并继续”活动，以便在事务完成之前暂停工作流的执行。

属性面板

输入

• 引用- 对所添加队列项目的引用。该引用可用于将您的事务链接到自动化项目中使用的其他应用程序。此外，此功能使您可以根据提供的字符串在 Orchestrator 中搜索特定事务。
• 项目信息收集
  • 启用导入队列项目的整个信息字典。该字段仅接受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。
• “截止日期” - 应在此之前处理队列项目的时间戳。可以使用相对时间戳填充此属性，例如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 。

其他

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

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

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