orchestrator
latest
false
UiPath logo, featuring letters U and I in white
Orchestrator 用户指南
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 2024年10月30日

在 Orchestrator 中管理队列

创建队列

  1. 在“队列”页面中,单击“添加队列”。系统将显示两个选项,用于创建新队列或链接其他文件夹中的队列。
  2. 单击“创建新队列”。系统将显示“创建队列”窗口。
  3. 在“名称”字段中,输入队列的名称。
  4. 在“描述”字段中,添加队列的描述。
  5. 如果您希望事务引用是唯一的,请选中“强制执行唯一引用”复选框。
  6. 如果要在数据库中加密队列项目数据和输出,请选中“以加密格式存储”复选框。
    备注:
    • 加密操作无法撤消。
    • 仅对队列项目的“特定数据”和“输出”值进行加密。这些值仅在数据库中加密,从而保护敏感内容,使其免受数据库管理员的侵害。Orchestrator 用户界面将继续显示经过解密的内容。对于端到端加密,您需要先加密队列项目,然后再将其添加到队列中。
    • 现有队列无法加密。作为替代方案,您可以重新创建队列并选中“以加密格式存储”复选框。
    • 由于采用加密格式,因此无法再报告特定数据输出数据库字段,并且 Insights 中的相应仪表板也不可用。
  7. 在“自动重试”部分中,您可以找到如下两个选项:
    • 失败的项目 - 如果处于活动状态,则会在创建队列后重试失败的队列项目。
    • 已放弃的项目 - 如果处于活动状态,则会显示“最大重试次数”字段,您可以在其中设置已放弃的队列项目的最大重试次数。如果未处于活动状态,则事务将在不活动 24 小时后放弃。
    注意:系统会在用户界面中对重试的队列项目做出相应标记。
  8. 使用相应的“ 浏览 ” 按钮为“ 特定数据” 、“输出数据” 和“ 分析数据 ” 中的任何一个或每个上传 JSON 架构。
  9. 如果您想更好地控制项目的处理时间,并评估所需的资源以确保其在截止日期之前完成,请启用 SLA 预测。如果启用了 SLA 预测,请配置以下字段:
    • 流程下拉列表中选择处理队列项目的流程,然后在下面填写 SLA 值。最大值为 90 天。
    • 如果要在实际SLA 之前定义缓冲区,请启用风险 SLA,并填写以下值。风险 SLA 必须小于 SLA。
  10. 单击“添加”。该队列已创建并显示在“队列”页面上,但为空。

您可以使用 Studio 或在“上传项目”窗口中填充队列。只有使用 Studio 才能处理队列中的项目。有关更多信息,请参阅“在 Studio 中管理队列”页面。

编辑队列

您可以更新现有队列设置,例如:

  • 队列名称说明
  • 自动重试”部分
  • 最大重试次数

编辑队列名称或说明

要在 Orchestrator 中编辑现有队列名称,请执行以下操作:

  1. 在“队列”页面中,单击所需队列对应的“更多选项”docs image 按钮。
  2. 单击“编辑”docs image。系统将显示“更新队列”向导。
  3. 在“名称”字段中,输入所选队列的新名称。
    备注:
    • 确保输入唯一名称。如果租户中已存在同名的队列,则系统会提示以下错误消息:The name <QueueName> is already used. (#1001)
    • 名称区分大小写。因此,NEW_QueueNamenew_queuename 是重复项。
  4. 在“说明”字段中,更新队列的说明。
  5. 单击“更新”
    重要提示:请务必在 Studio 中更新相应工作流中的队列名称。您必须手动执行此操作,因为 Studio 中没有提供自动更新队列名称的方法。

更改自动重试选项

要更改现有队列的“自动重试”部分中的选项,请执行以下操作:

  1. 在“队列”页面中,选择所需队列对应的“更多选项”docs image 按钮。
  2. 选择“编辑”docs image。系统将显示更新队列向导。
  3. 在“自动重试”部分中,选择所需的选项。
  4. 选择“更新”

设置最大重试次数

已放弃的项目:选中复选框

如果您选择了“已放弃的项目”选项,则会显示“最大重试次数”字段。

输入 1 到 50 范围内的值作为失败事务的重试次数。

重要提示

1. 系统不会重试现有的失败事务。只有在设置新值后,系统才会重试失败的事务。

2. 手动重试不计入为队列项目设置的最大重试次数。在这种情况下,在 API 中,RetryNumber0AncestorIdnull
此外,每个队列项目点都通过 Key 字段指向重试链的原始队列项目。

包括以下字段:

  • ManualRetryNumber - 队列项目的手动重试次数
  • ManualAncestorId - 已手动重试的队列项目的 ID
  • ManualAncestorUniqueKey - 已手动重试的队列项目的全局唯一 GUID
  • UniqueKey - 任何队列项目的全局唯一 GUID(每次重试时都不同,无论手动或自动重试)
  • AncestorUniqueKey - 已自动重试的队列项目的全局唯一 GUID
  • RetryNumber - 队列项目的自动重试次数
  • AncestorId - 已自动重试的队列项目的 ID
  • Key - 重试链的初始队列项目的 GUID

目标是使队列项目重试完全可追踪。

3. 重试和删除的队列项目不参与唯一引用检查。因此,我们建议您不要从重试链中删除初始队列项目,因为这会阻止验证唯一引用。但是,如果数据保留期已选取初始队列项目,则仍会执行此验证。

假设您有一系列失败事务,且这些失败事务已重试一次。“最大重试次数”的当前值为 2。将值更新为 3 后,失败事务将再重试两次,而不是一次。

已放弃的项目:未选中复选框

如果您没有选择“自动重试”选项,则“最大重试次数”字段会隐藏。

所有事务都不会重试。

管理队列链接

在文件夹之间共享队列可在基础流程针对同一队列时,在多个文件夹中启动作业,而无需在 Studio 中重新设计工作流。将目录链接到文件夹可使该队列和所有与队列关联的对象(如队列项目)在该文件夹中可用。

备注:

链接到多个文件夹的队列会以 图标标记。如果未显示该图标,则当前文件夹是队列所在的唯一文件夹。在此处删除此队列会完全将其从 Orchestrator 中删除。

对于要添加队列的文件夹(目标文件夹),您需要“队列 - 创建”权限,对于队列当前所在的文件夹(原始文件夹),您需要“队列 - 查看”权限。如果在目标文件夹中有“队列 - 编辑”权限,则原始文件夹中也需要“队列 - 编辑”权限。

将多个队列链接到当前文件夹

  1. 在您要将队列链接到的文件夹中,在“队列”页面上,单击“添加”。系统将显示三个按钮,用于添加队列、从其他文件夹链接队列或隐藏选项。
  2. 单击“从其他文件夹链接”。系统将显示“链接队列”窗口,其中显示您具有队列查看权限的文件夹中所有队列的列表。
  3. 在“选择队列”部分,从列表中选择一个或多个队列。


  4. 单击“继续”。您将转到“文件夹验证”部分。在这里,您可以看到队列已链接到的文件夹。如果有多个文件夹,则显示其名称。


  5. 单击“删除”以还原相应队列的更改,或单击“退出”取消操作。
  6. 如果要在所选队列和当前文件夹之间建立链接,请单击“链接”。队列将显示在“队列”页面上。


将队列链接到多个文件夹

  1. 导航到要链接的队列所在的文件夹。
  2. 针对所需队列单击“更多操作”>“管理链接”,打开“管理链接”窗口。显示“管理队列链接”窗口。

    1 - 左侧窗格,显示您已被授予查看队列权限的所有文件夹。2 - 队列的当前状态,显示队列当前所在文件夹的数量及其名称。3 - 根据您在左侧窗格中的选择要添加队列的文件夹。4 - 要从中删除队列的文件夹。



  3. 单击“更新”。系统会显示确认窗口。
  4. 单击“取消”以中止更改,或单击“继续”以使更改生效。现在,这些操作将根据您的更改反映在 Orchestrator 中。

取消队列与文件夹的链接

取消队列与文件夹的链接可以通过类似于链接操作的方式执行。导航到上述过程中显示的链接管理区域,并删除特定队列和特定文件夹之间的连接。

或者,您可以使用删除功能删除队列。

重要提示:

删除存在于多个文件夹中的队列时,只能将其从执行删除操作的文件夹中删除,不会从其他文件夹中删除。为了完全删除队列,您必须删除其所有现有链接。

在以下情况下,您无法取消队列与文件夹的链接:

  • 已在该文件夹中启用队列 SLA;
  • 队列触发器附加到队列。

显示事务

队列页面中,单击更多操作>查看事务。系统将显示事务页面,其中仅包含指定队列中的项目。

显示审核请求

在“队列”页面中,单击“查看请求”以显示分配给当前登录用户进行修订的所有队列项目。该页面允许状态更改和管理项目信息。

显示队列图表

要查看特定队列的图表,请单击“更多操作”按钮,然后单击“查看图表”

折线图显示特定时间段内事务状态的演变。时间段(过去一小时、一天、一周、30 天)可以更改,并且您可以查看平均执行时间和最大重试次数。



使用 CSV 文件将项目上传到队列

有关 使用 CSV 文件上传队列项目的详细信息,请参阅此处。

监控队列

要监控队列,请单击相应的更多操作按钮,然后单击监控队列。或者,从队列概述微件(监控>队列)中选择。

请注意,监控机器人要求您的用户具有对机器人和监控的查看权限。此外,需要使用监控的编辑权限功能来禁用监控>作业页面中错误订阅源微件中的错误。

向队列添加标签

备注:

要向队列添加现有标签,您需要“编辑”队列和“查看”标签权限。

要向队列添加新标签,您需要“编辑”队列和“创建”标签权限。

备注:
  • 每个队列最多可以有 100 万个键/值对。
  • 标签和键/值属性限制为 256 个字符。
  • 标签名称不能包含以下字符:<>%&\)\)?/:

您可以在创建队列或编辑现有队列时将标签应用于队列。要在编辑队列时向其添加标签,请执行以下步骤:

  1. 在“队列”页面中,单击所需队列旁边的“更多操作”>“编辑”。系统将打开队列以进行编辑。
  2. 在“标签”字段中,开始键入标签的名称。您可以选择现有标签或创建新标签。
  3. 在“属性 (键值对)”字段上,单击“新增”。
  4. 添加新的键和值。您可以选择现有的键和/或值,也可以创建新的键和/或值。
  5. 完成后,单击“更新”。您的队列已更新,新创建的标签(如有)可用于其他对象。

从队列中删除标签

要从队列中删除标签,请执行以下步骤:

  1. 在“队列”页面中,单击所需队列旁边的“更多操作”>“编辑”。系统将打开队列以进行编辑。
  2. 在“标签”字段中,单击标签名称旁边的 X 以将其删除。标签已删除。
  3. 在“属性(键值对)”字段中,单击键和/或值旁边的 X 以将其删除。键和/或值已删除。
  4. 要删除键/值对,请单击与该条目相对应的“删除”图标。键/值对已删除。
  5. 完成后,单击“更新”。您的队列已更新,标签已删除。

删除队列

要删除队列,请单击相应的“更多操作”按钮,然后单击“删除”

或者,从“队列”页面中选择该队列,然后单击“删除”。队列将不再显示在“队列”页面上。

重要提示:删除存在于多个文件夹中的队列时,只会将其从执行删除操作的文件夹中删除,不会从其他文件夹中删除。为了完全删除队列,您必须删除其所有现有链接。
注意:删除一个队列后,属于该队列的已分配事务项目在审核请求页面中不再可见。

记录失败的队列事务

您可以记录与启用了记录选项的流程关联的失败队列事务。这有助于识别导致失败的问题并对其进行故障排除,并有助于监控和审核。

可通过“其他设置”选项卡的“作业记录”部分在流程级别启用此选项。
docs image
如果包含队列的流程失败,则系统会在 Orchestrator 的以下位置记录其执行情况:
  • 在队列级别,通过单击受影响队列的上下文菜单中的“打开录制”。

    在以下情况下,此选项不处于活动状态:

    • 队列已关联至执行未失败的流程。

    • 尚未为与该队列关联的流程启用“记录并存储失败的队列事务”选项。

  • 在事务级别,通过单击受影响事务的“查看详细信息”窗口中的“打开录制”。

录制时长

最长录制时间为 3 分钟,适用于执行的最后时刻。

最短记录时长为 10 秒。如果处理事务的时间不到 10 秒,则记录中可能还会包括其他事务。

此页面有帮助吗?

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