在 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. 在“队列”页面中，单击所需队列对应的“更多选项” 按钮。
2. 单击“编辑”。系统将显示“更新队列”向导。
3. 在“名称”字段中，输入所选队列的新名称。
   备注：

   • 确保输入唯一名称。如果租户中已存在同名的队列，则系统会提示以下错误消息：The name <QueueName> is already used. (#1001)
   • 名称不区分大小写。因此，NEW_QueueName 和 new_queuename 是重复项。
4. 在“说明”字段中，更新队列的说明。
5. 单击“更新”。
   重要提示：请务必在 Studio 中更新相应工作流中的队列名称。您必须手动执行此操作，因为 Studio 中没有提供自动更新队列名称的方法。

更改自动重试选项

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

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

设置最大重试次数

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

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

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

重要提示：

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

2. 手动重试不计入为队列项目设置的最大重试次数。在这种情况下，在 API 中，RetryNumber 为 0，AncestorId 为 null。

此外，每个队列项目点都通过 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. 完成后，单击“更新”。您的队列已更新，标签已删除。

删除队列

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

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

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

注意：删除一个队列后，属于该队列的已分配事务项目在审核请求页面中不再可见。

记录失败的队列事务

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

可通过“其他设置”选项卡的“作业记录”部分在流程级别启用此选项。

如果包含队列的流程失败，则系统会在 Orchestrator 的以下位置记录其执行情况：

• 在队列级别，通过单击受影响队列的上下文菜单中的“打开录制”。

  在以下情况下，此选项不处于活动状态：

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

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

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

录制时长

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

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