添加队列项目并获取引用

UiPath.Persistence.Activities.Queue.AddQueueItemAndGetReference

描述

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、Windows - 旧版配置

设计器面板

• “队列名称 ” - 要在其中添加 QueueItem 对象的队列。 该名称不区分大小写，这意味着如果在 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。
• “优先级 ” - 添加的队列项目的优先级。 此属性与“ 到期日期 ”和“ 延迟日期”一样，是队列项目优先级的标准。
• “队列名称 ” - 要在其中添加 QueueItem 对象的队列。 该名称不区分大小写，这意味着如果在 Orchestrator 中将其定义为“MyFirstQueue”，则它与“myfirstqueue”匹配。 最大字符数为 50。
• “引用 ” - 所添加的队列项目的引用。 该引用可用于将事务链接到自动化项目中使用的其他应用程序。 此外，此功能使您能够根据提供的字符串在 Orchestrator 中搜索某些事务。

其他

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

输出

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

跨平台配置

• “队列名称 ” - 要在其中添加 QueueItem 对象的队列。 该名称不区分大小写，这意味着如果在 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。
• “优先级 ” - 添加的队列项目的优先级。 此属性与“ 到期日期 ”和“ 延迟日期”一样，是用于确定队列项目优先级的条件。
• “队列名称 ” - 要在其中添加 QueueItem 对象的队列。 该名称不区分大小写，这意味着如果在 Orchestrator 中将其定义为“MyFirstQueue”，则它与“myfirstqueue”匹配。 最大字符数为 50。
• “引用 ” - 所添加的队列项目的引用。 该引用可用于将事务链接到自动化项目中使用的其他应用程序。 此外，此功能使您能够根据提供的字符串在 Orchestrator 中搜索某些事务。