在 Orchestrator 中管理队列

在 Orchestrator 中创建和管理队列，包括配置队列设置以及跨文件夹链接队列。

创建队列

1. 在“队列”页面中，单击“添加队列”。系统将显示两个选项，用于创建新队列或链接其他文件夹中的队列。
2. 单击“创建新队列”。系统将显示“创建队列”窗口。
3. 在“名称”字段中，输入队列的名称。
4. 在“描述”字段中，添加队列的描述。
5. 如果您希望事务引用是唯一的，请选中“强制执行唯一引用”复选框。
6. 如果要在数据库中加密队列项目数据和输出，请选中“以加密格式存储”复选框。
   备注：

   • 加密操作无法撤消。
   • 数据使用应用程序级加密进行加密。有关更多信息，请参阅应用程序级加密 (ALE)。
   • The Specific Data, Output, and Processing Exceptions values of a queue item are encrypted in the database, protecting sensitive content from database admins. Orchestrator UI continues to display the decrypted content. For end to end encryption, you need to encrypt the queue item before adding it to the queue.
   • 现有队列无法加密。作为替代方案，您可以重新创建队列并选中“以加密格式存储”复选框。
   • Due to the encrypted format, reporting analytics on Specific Data, Output, and Processing Exceptions database fields is no longer possible for new queues, and the corresponding dashboards in Insights are unavailable.
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. 在“选择队列”部分，从列表中选择一个或多个队列。

图 1. 选择队列

4. 选择“继续”。 您会被引导到“文件夹验证”部分。在这里，您可以看到队列已链接到的文件夹。如果有多个文件夹，则显示其名称。

图 2. 正在验证文件夹

5. 为相应队列选择“移除”以还原更改，或单击“退出”以取消操作。
6. 如果您希望在选定队列与当前文件夹之间建立链接，请选择“链接”。队列将显示在“队列”页面上。

图 3. “队列”页面

将队列链接到多个文件夹

1. 导航到要链接的队列所在的文件夹。
2. 选择所需队列的“更多操作”>“管理链接”，以打开“管理链接”窗口。显示“管理队列链接”窗口。

图 4. “管理队列链接”页面

3. 选择“更新”。系统会显示确认窗口。
4. 如果要中止更改，请选择“取消”，如果要使更改生效，请选择“继续”。现在，根据您的更改，操作会反映在 Orchestrator 中。

取消队列与文件夹的链接

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

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

重要提示：

删除存在于多个文件夹中的队列时，只能将其从执行删除操作的文件夹中删除，不会从其他文件夹中删除。为了完全删除队列，您必须删除其所有现有链接。 在以下情况下，您无法取消队列与文件夹的链接：

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

显示事务

In the Queues page, click More Actions > View Transactions. The Transactions page is displayed, containing only the items from the indicated queue.

显示审核请求

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

显示队列图表

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

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

图 5. 队列图

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

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

监控队列

To monitor a queue, click the corresponding More Actions button and then Monitor Queue. Alternatively, select it from the Queues Overview widget (Monitoring > Queues).

Note that monitoring a queue requires your user to have View permissions on Queues and on Monitoring. Additionally, Edit on Monitoring is required in order to disable errors from the Error Feed widget on the Monitoring > Queues page.

向队列添加标签

备注：

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

备注：

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

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

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

从队列中删除标签

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

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

删除队列

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

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

重要提示：

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

备注：

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

记录失败的队列事务

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

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

图 6. 作业记录的额外设置

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

• 在队列级别，通过单击受影响队列的上下文菜单中的“打开录制” 。在以下情况下，此选项不处于活动状态：
  • 队列已关联至执行未失败的流程。
  • 尚未为与该队列关联的流程启用“记录并存储失败的队列事务”选项。
• 在事务级别，通过单击受影响事务的“查看详细信息”窗口中的“打开录制” 。

录制时长

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

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