添加队列项目

UiPath.Core.Activities.AddQueueItem

描述

在 Orchestrator 队列中添加新项目。项目的状态将为新。此处提供了该活动的用法示例。

备注：

• 要使UiPath.Core.Activities.AddQueueItem活动在流程中正常运行，机器人必须连接到 Orchestrator。这是发送和检索有关队列、项目和状态的信息所必需的。
• 系统会将添加到 Orchestrator 中的队列并标记为“必填”的架构定义值，自动导入到活动的“字典生成器”中。
• 可以将标记为不需要的值添加到队列项目中，但不强制执行。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、跨平台配置

• Orchestrator 文件夹路径- 指定队列所在的文件夹路径（可能与运行流程的文件夹不同）。此字段仅支持字符串值，并使用/作为分隔符来表示子文件夹。例如"Finance/Accounts Payable" 。

  备注：

  Orchestrator folder path参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。X-UIPATH-FolderPath-Encoded标头中支持相对文件夹路径，如下所示：

  以 / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。

  以 . 开头的路径 - 从环境文件夹开始。

  以 .. 开头的路径 - 路径中的每个 .. 表示在环境文件夹的层次结构中向上一层（例如 ../ 表示向上一层，../../ 表示向上两层）。

  不接受尾随斜杠。

• 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.

  • 如果单击“队列名称”旁边的“管理队列”按钮，则会转到 Studio 连接到的 Orchestrator 中的“队列”部分。

• 项目信息- 有关要添加的特定队列项目的附加信息集合。信息存储在项目中，并在事务处理期间使用。要检索最新的队列架构，请选择字段右侧的“刷新参数” 。要打开项目列表并编辑其属性，请选中“项目信息”字段框。

  重要提示：

  建议仅使用以下类型的原始值: 数字、布尔值、字符串和日期时间。

  字符串参数的值不能包含以下字符：[ 和 " "。

  参数名称不得包含以下字符：:、.、,、@、"。

  架构中未按要求设置的参数不会上传到集合中。

¹对于在 Studio Web 中创建的作为解决方案一部分的跨平台项目， Orchestrator 文件夹路径字段不可用。

²对于在 Studio Web 中创建的作为解决方案一部分的跨平台项目， “名称”字段提供了用于在设计时定义新的Orchestrator 资源（例如队列、资产或存储桶）或“打开 Orchestrator进行资源管理”的选项。

高级选项

输入

• “截止日期”- 应在此之前处理队列项目的时间戳。除了“截止日期”和“延期日期”之外，此属性也是一个用于确定队列项目优先级的条件。此属性可以使用相对时间戳填充，例如 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。
• Item Collection - Enables importing an entire dictionary of information for a queue item. This field only accepts Dictionary<string, object> variables.
• “延期”- 处理队列项目之前的时间戳。除了“截止日期”和“延期日期”之外，此属性也是一个用于确定队列项目优先级的条件。此属性可以使用相对时间戳填充，例如 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 中搜索特定事务。
  备注：

  DueDate是保留关键字。配置此活动时，不能在任何属性中使用它。

其他

• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。
• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  备注：

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

Windows - 旧版配置

属性面板

常见

• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（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。
• Item Collection - Enables importing an entire dictionary of information for a queue item. This field only accepts Dictionary<string, object> variables.
• Item Information - A collection of additional information about the specific QueueItem that is to be added. The information is stored in the item and is used during a transaction processing. It is recommended to use only primitive values of the following types: Number, Boolean, String and DateTime. The value of string arguments cannot contain the following characters: [ and " ". Argument names cannot contain the following characters: :, ., ,, @, ".
• “延期”- 处理队列项目之前的时间戳。除了“截止日期”和“延期日期”之外，此属性也是一个用于确定队列项目优先级的条件。此属性可以使用相对时间戳填充，例如 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。
• 要添加的队列项目的优先级。除了“截止日期”和“延期日期”之外，此属性也是一个用于确定队列项目优先级的条件。
• 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.
• “引用”- 对添加的队列项目作出的引用。您可通过该引用，以将事务链接到自动化项目中所用的其他应用程序。此外，此功能还可用于根据给定字符串在 Orchestrator 中搜索特定事务。
  备注：

  DueDate是保留关键字。配置此活动时，不能在任何属性中使用它。

其他

• 文件夹路径- 指定队列所在的文件夹路径（可能与运行流程的文件夹不同）。此字段仅支持字符串值，并使用/作为分隔符来表示子文件夹。例如"Finance/Accounts Payable" 。

  备注：

  Folder Path参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。X-UIPATH-FolderPath-Encoded标头中支持相对文件夹路径，如下所示：

  以 / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。

  以 . 开头的路径 - 从环境文件夹开始。

  以 .. 开头的路径 - 路径中的每个 .. 表示在环境文件夹的层次结构中向上一层（例如 ../ 表示向上一层，../../ 表示向上两层）。

  不接受尾随斜杠。

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