添加队列项目

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 文件夹开始。

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

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

  请注意，不应包含尾随斜杠。

• “队列名称”- 将要添加队列项目对象的队列。名称不区分大小写，这表示如果在 Orchestrator 中将其定义为“MyFirstQueue”，则其会与“myfirstqueue”相匹配。最大字符数为 50。
  • 如果单击“ 队列名称” 旁边的“管理队列” 按钮，则会转到 Studio 所连接到的 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。
• 项目集合- 支持导入队列项的整个信息字典。该字段仅接受 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 中搜索特定事务。

  注意：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。
• 项目集合- 支持导入队列项的整个信息字典。该字段仅接受 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 中搜索特定事务。

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

其他

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

  Folder Path参数不适用于机器人在传统文件夹中执行的流程。只有新式文件夹中的机器人才能将数据传递到其文件夹之外。

  X-UIPATH-FolderPath-Encoded 参数支持相对文件夹路径，如下所示：

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

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

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

  请注意，不应包含尾随斜杠。

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