orchestrator

2022.10

false

重要 :

请注意，此内容已使用机器翻译进行了部分本地化。新发布内容的本地化可能需要 1-2 周的时间才能完成。

Orchestrator 用户指南

适用平台：

上次更新日期 2025年7月1日

管理触发器

创建时间触发器

在文件夹中，导航到“自动化”>“触发器”，然后在“触发器”页面上，单击“添加新触发器”。系统将显示“创建触发器”页面。
选择“时间”作为触发器类型。
在“名称”字段中，为触发器添加一个名称，以方便识别。
从“流程名称”下拉菜单中，选择要配置时间触发器的流程。
从“作业优先级”下拉菜单中，选择作业的优先级。默认值为“已继承”，这意味着作业优先级与为所选流程定义的优先级相同。
从“运行时类型”下拉菜单中，选择用于执行触发器启动的作业的运行时。

在“执行目标”选项卡上，选择作业的分配机制和执行目标。

描述
动态分配	动态分配无需显式选择帐户和计算机的动态分配允许您在首先可用的帐户和计算机下多次执行前台流程。只要您有足够的运行时，后台流程就可以在任何帐户上执行，无论其是否忙碌。使用“动态分配”选项，您可以在一个作业中最多执行一个流程 10000 次。
	帐户该流程在特定帐户下执行。仅指定帐户会导致 Orchestrator 动态分配计算机。同时指定帐户和计算机模板意味着作业将在该帐户-计算机对上启动。
	计算机此流程在附加到所选计算机模板的其中一台主机上执行。仅指定计算机模板会导致 Orchestrator 动态分配帐户。同时指定帐户和计算机模板意味着作业将在该帐户-计算机对上启动。注意：确保将执行作业所需的运行时许可证分配给关联的计算机模板。
	主机名选择计算机模板后，系统将显示“主机名”选项，允许您选择所需的工作站/机器人会话以执行流程。系统将显示活动文件夹中的所有可用会话，包括未连接、已断开连接或已连接的会话。注意：只有无人值守运行时可用于配置映射。确保将执行作业所需的运行时许可证分配给关联的计算机模板。
选择有效的帐户-计算机映射	该流程可以在特定的帐户-计算机对上执行。了解有关用户-计算机映射的更多信息。备注：选择未激活的主机名（即处于“无响应”或“已断开连接”状态）时，系统将显示警告。无法从触发器所在的文件夹中删除或取消分配触发器中使用的映射中的帐户。确保未在触发器中将该帐户设置为执行目标，以便将其删除。

注意：选择未激活的主机名（即处于“无响应”或“已断开连接”状态）时，系统将显示警告。在与 Orchestrator 建立相应的连接之前，计划由非活动会话执行的作业将保持“待处理”状态。

要确定选择未激活的主机名，请单击“确认”。

要返回并选择另一个主机名，请单击“取消”。

使用相同的帐户-计算机映射配置相同的触发器，但如果使用额外的主机名选择，会导致要执行的作业数量增加一倍。

例如，假设您配置了触发器 T1，其中帐户 A1 映射到计算机模板 MT1。在此配置中，有十个作业排队等待执行。

稍后，您使用映射到计算机模板 MT1 的帐户 A1 配置相同的触发器 T1，但现在您还要选择主机名 H1。在这种情况下，十个相同的作业将再次排队，因为 Orchestrator 会将配置解释为新配置。

在“ 参数 ” 选项卡上，如果您的流程中有输入参数，请提供输入参数的值。有关输入和输出参数的更多详细信息。
从“时区”下拉菜单中，选择触发触发器所根据的时区。
备注：
- 触发器时区不依赖于租户时区。您可以为时间触发器执行设置不同的时区。
- 使用夏令时 (DST) 的位置在其 UTC 偏移量中列出。 DST 生效时，UTC 偏移量不会增加。例如，在 DST 期间，伦敦时区显示为 UTC+00:00。
- Orchestrator 的计划机制会在启动作业时自动考虑DST，因此无需调整时区将 DST 考虑在内。计划在 12:00 运行的作业在冬季和夏季的运行时间均为 12:00。
选择触发器的执行频率（“分钟”、“每小时”、“每天”、“每周”、“每月”、“高级”）。在本部分的右侧，根据所选选项（频率，确切时间或 CRON 表达式）配置详细信息。Orchestrator 使用开源库来解析和显示 CRON 描述，请参见此处。

备注：
CRON 表达式可以与非工作日结合使用。这意味着，如果通过 CRON 表达式将触发器配置为在某个被排除的日期运行，则系统会跳过这一天，并将触发器重新安排在下一个可用的日子，依此类推。
选择希望触发器执行的频率（以分钟为单位）。
重要提示：
我们的 CRON 表达式采用的 CRON 标准使用基于 60 分钟到一个小时的时间系统。这意味着只有该间隔的值是 60 的除数时，才能以在“重复间隔”字段中配置的确切间隔执行触发器。否则，重复周期将不完全遵循该字段中的分钟数，从而导致出现执行差异。为避免这种情况，我们建议调整触发器设置或使用事件触发器。
示例：您将触发器设置为每 21 分钟执行一次，并在 9:00 开始作业。这将呈现以下执行计划：
- 第一个作业于 9:00 开始。
- 第二个作业于 9:21 开始。
- 第三个作业于 9:42 开始。
- 第四个作业于 10:00 开始。
第四个作业在 18 分钟后开始而不是在 21 分钟后启动的原因是，CRON 组件会匹配 1 到 59 分钟之间的分钟集合中的第 21 分钟。在此示例中，这些项目为 00、21、42。
如果您希望触发器在某些非工作日停止触发，请从“ 非工作日限制 ”下拉菜单中选择一个非工作日日历。有关非工作日的更多详细信息。
打开“ 计划结束作业执行” 开关，以选择作业终止策略。
备注：
- 即使作业在排队等待，此处指定的时间仍会按照您的要求计算。例如，如果您将某个作业计划为在下午 1 点运行，并将其设置为在 20 分钟后停止，则即使该作业一直停留在队列中，直到下午 1:15 才开始，也会在下午 1:20 停止。
- 为手动启动的作业保留触发器的“计划结束作业执行”选项。
例如，假设您创建了触发器 T1 并激活了以下作业结束计划：
- 计划作业执行结束：10 分钟后停止作业
- 如果作业没有停止，则安排自动“终止”：2 分钟后终止作业
  
  在“自动化”>“触发器”页面上，当您单击触发器 T1 的“立即启动作业”时，系统将打开“启动作业”页面，其中已应用了您在创建触发器时配置的作业结束计划。
示例：如果您计划在 2 小时后停止“待处理”或“正在运行”的作业，并配置为在 3 小时后终止同一作业，则该作业将在 5 小时后终止。发生这种情况是因为，首先，系统会向 Orchestrator 发送信号，表明作业确实在 2 小时后停止。Orchestrator 收到信号后，终止作业操作将在 3 小时内触发，因此总共需要 5 小时。
- 从下拉列表中选择“停止”- 在作业一直处于“待处理”状态以来，经过已定义的时间间隔后尝试正常结束执行（可设置的最短时间为 1 分钟，最长时间为 10 天 23 小时 59 分钟）；
  示例：Orchestrator 将尝试停止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。
- 从下拉列表中选择“终止”- 在作业一直处于“待处理”或“正在运行”状态以来，经过已定义的时间间隔后尝试强制结束执行（可设置的最短时间为 1 分钟，最长时间为 10 天 23 小时 59 分钟）；
  
  示例：Orchestrator 将尝试终止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。
- 从下拉列表中选择“停止”，并启用“如果作业没有停止，请终止作业”选项 - 在作业一直处于“待处理”或“正在运行”状态以来，经过已定义的时间间隔后尝试正常结束执行，然后在作业一直处于“正在停止”状态以来，经过已定义的时间间隔后尝试强制结束作业（可设置的最短时间为 1 分钟，最长时间为 10 天 23 小时 59 分钟）。
  
  示例：Orchestrator 将尝试停止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。如果无法终止，Orchestrator 将尝试终止处于“正在停止”状态至少 20 分钟的作业。
打开“计划自动禁用触发器”切换开关，然后输入要禁用触发器的日期和时间。所选时区决定了何时禁用时间触发器。
打开“在作业卡住（处于挂起或已恢复状态）时生成警示”开关，并设置完成作业所需的预期时长，以使其保持“挂起”或“已恢复”状态。可配置时长最短为一分钟。可配置时长最长为 11 天。如果作业超过配置的持续时间，则会弹出“错误”严重性警报，并使用以下文本通知您：“#process {process_number} 的 N 个作业已挂起或恢复超过 X 小时 Y 分钟”。其中：
- N - 是触发警示的作业编号；
- {process_number} - 流程标识符；
- X - 作业处于挂起或已恢复状态时超过的配置小时数；天数将转换为小时。
- Y - 作业处于挂起或已恢复状态时超过的配置分钟数。
打开“在作业已启动但尚未完成时生成警示”开关，并设置完成作业所需的预期时长。可配置的持续时间最短为一分钟，最长为十一天。如果作业超过配置的持续时间，则会弹出“错误”严重性警报，并使用以下文本通知您：“#process {process_number} 的作业已挂起或已运行超过 X 小时 Y 分钟”。其中：
- {process_number} - 流程标识符；
- X - 作业尝试完成时超出的配置小时数；天数将转换为小时。
- Y - 作业尝试完成时超出的配置分钟数。
要保持配置用于启动作业的相同用户-计算机上下文，请选中“在作业恢复时保持用户/计算机分配”复选框。这可优化您的许可证和资源使用情况。

创建队列触发器

注意：就队列-流程关联而言，队列触发器和 SLA 预测是相互依赖的。因此，每当配置其中一者时，另一者都会预填充，以使配置之间保持对等。假设我为队列 Y 定义了一个队列触发器以使用流程 X，队列 Y 的 SLA 预测只能使用流程 X 进行，那么，为 Y 启用队列 SLA 时，X 会预填充，并且为只读状态。

重要提示：对于包含队列触发器活动的流程，您只需在创建流程时从“ 包要求 ” 页面创建和编辑相应的队列触发器。工作流中的队列触发器活动无法识别手动创建的触发器（即从“ 触发器 ”页面创建的触发器）。

在文件夹中，导航到“自动化”>“触发器”，然后在“触发器”页面上，单击“添加新触发器”。系统将显示“创建触发器”页面。
选择“队列”作为触发器类型。
在“名称”字段中，为触发器添加一个名称，以方便识别。
从“流程名称”下拉菜单中，选择要配置时间触发器的流程。
从“作业优先级”下拉菜单中，选择作业的优先级。默认值为“已继承”，这意味着作业优先级与为所选流程定义的优先级相同。
从“ 运行时类型 ” 下拉菜单中，选择运行时许可证类型。

在“执行目标”选项卡上，选择作业的分配机制和执行目标。

描述
帐户	该流程在特定帐户下执行。仅指定帐户会导致 Orchestrator 动态分配计算机。同时指定帐户和计算机模板意味着作业将在该帐户-计算机对上启动。
计算机	此流程在附加到所选计算机模板的其中一台主机上执行。仅指定计算机模板会导致 Orchestrator 动态分配帐户。同时指定帐户和计算机模板意味着作业将在该帐户-计算机对上启动。注意：确保将执行作业所需的运行时许可证分配给关联的计算机模板。
主机名	选择计算机模板后，系统将显示“主机名”选项，允许您选择所需的工作站/机器人会话以执行流程。系统将显示活动文件夹中的所有可用会话，包括未连接、已断开连接或已连接的会话。注意：只有无人值守运行时可用于配置映射。确保将执行作业所需的运行时许可证分配给关联的计算机模板。

要确定选择未激活的主机名，请单击“确认”。

要返回并选择另一个主机名，请单击“取消”。

使用相同的帐户-计算机映射配置相同的触发器，但如果使用额外的主机名选择，会导致要执行的作业数量增加一倍。

例如，假设您配置了触发器 T1，其中帐户 A1 映射到计算机模板 MT1。在此配置中，有十个作业排队。

稍后，您使用映射到计算机模板 MT1 的帐户 A1 配置相同的触发器 T1，但现在您还要选择主机名 H1。在这种情况下，十个相同的作业将再次排队，因为 Orchestrator 会将配置解释为新配置。

在“ 参数 ” 选项卡上，如果您的流程中有输入参数，请提供输入参数的值。有关输入和输出参数的更多详细信息。

填写“触发第一个作业的最小项目数”、“允许同时等待和运行的最大作业数”、“为每 _ 个新项目触发其他作业”字段。

描述
触发第一个作业的最小项目数	项目处理作业仅在目标队列中具有至少此数量的新项目之后才开始。延迟的队列项目不计算在内。
允许同时等待和运行的最大作业数	允许的待处理作业和正在运行的作业的最大数量（一起计算）。对于同时允许的 2 个或多个作业，需要按如下所述定义第三个选项。
每 __ 个新项目触发另一个作业	触发新作业的新队列项目数（在为“触发第一个作业的最小项目数”选项配置的数值基础上）。

从“时区”下拉菜单中，选择禁用队列触发器所依据的时区（请参阅步骤 13）。
如果您希望触发器在某些非工作日停止触发，请从“ 非工作日限制 ”下拉菜单中选择一个非工作日日历。有关非工作日的更多详细信息。
打开“ 计划结束作业执行” 开关，以选择作业终止策略。
备注：
- 即使作业在排队等待，此处指定的时间仍会按照您的要求计算。例如，如果您将某个作业计划为在下午 1 点运行，并将其设置为在 20 分钟后停止，则即使该作业一直停留在队列中，直到下午 1:15 才开始，也会在下午 1:20 停止。
- 为手动启动的作业保留触发器的“计划结束作业执行”选项。
例如，假设您创建了触发器 T1 并激活了以下作业结束计划：
- 计划作业执行结束：10 分钟后停止作业
- 如果作业没有停止，则安排自动“终止”：2 分钟后终止作业
  
  在“自动化”>“触发器”页面上，当您单击触发器 T1 的“立即启动作业”时，系统将打开“启动作业”页面，其中已应用了您在创建触发器时配置的作业结束计划。
示例：如果您计划在 2 小时后停止“待处理”或“正在运行”的作业，并配置为在 3 小时后终止同一作业，则该作业将在 5 小时后终止。发生这种情况是因为，首先，系统会向 Orchestrator 发送信号，表明作业确实在 2 小时后停止。Orchestrator 收到信号后，终止作业操作将在 3 小时内触发，因此总共需要 5 小时。
- 从下拉列表中选择“停止”- 在作业一直处于“待处理”状态以来，经过已定义的时间间隔后尝试正常结束执行（可设置的最短时间为 1 分钟，最长时间为 10 天 23 小时 59 分钟）；
  示例：Orchestrator 将尝试停止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。
- 从下拉列表中选择“终止”- 在作业一直处于“待处理”或“正在运行”状态以来，经过已定义的时间间隔后尝试强制结束执行（可设置的最短时间为 1 分钟，最长时间为 10 天 23 小时 59 分钟）；
  
  示例：Orchestrator 将尝试终止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。
- 从下拉列表中选择“停止”，并启用“如果作业没有停止，请终止作业”选项 - 在作业一直处于“待处理”或“正在运行”状态以来，经过已定义的时间间隔后尝试正常结束执行，然后在作业一直处于“正在停止”状态以来，经过已定义的时间间隔后尝试强制结束作业（可设置的最短时间为 1 分钟，最长时间为 10 天 23 小时 59 分钟）。
  
  示例：Orchestrator 将尝试停止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。如果无法终止，Orchestrator 将尝试终止处于“正在停止”状态至少 20 分钟的作业。
启用“计划自动禁用触发器”切换开关，然后输入要禁用触发器的日期和时间。所选时区决定了何时禁用队列触发器。
打开“在作业卡住（处于挂起或已恢复状态）时生成警示”开关，并设置完成作业所需的预期时长，以使其保持“挂起”或“已恢复”状态。可配置时长最短为一分钟。可配置时长最长为 11 天。如果作业超过配置的持续时间，则会弹出“错误”严重性警报，并使用以下文本通知您：“#process {process_number} 的 N 个作业已挂起或恢复超过 X 小时 Y 分钟”。其中：
- N - 是触发警示的作业编号；
- {process_number} - 流程标识符；
- X - 作业处于挂起或已恢复状态时超过的配置小时数；天数将转换为小时。
- Y - 作业处于挂起或已恢复状态时超过的配置分钟数。
打开“在作业已启动但尚未完成时生成警示”开关，并设置完成作业所需的预期时长。可配置的持续时间最短为一分钟，最长为十一天。如果作业超过配置的持续时间，则会弹出“错误”严重性警报，并使用以下文本通知您：“#process {process_number} 的作业已挂起或已运行超过 X 小时 Y 分钟”。其中：
- {process_number} - 流程标识符；
- X - 作业尝试完成时超出的配置小时数；天数将转换为小时。
- Y - 作业尝试完成时超出的配置分钟数。
要保持配置用于启动作业的相同用户-计算机上下文，请选中“在作业恢复时保持用户/计算机分配”复选框。这可优化您的许可证和资源使用情况。

编辑触发器

单击相应的“编辑”按钮，进行所需的更改，然后在“编辑触发器”窗口中单击“更新”。

禁用触发器

要禁用触发器，请单击相应的更多操作按钮，然后单击禁用。禁用的时间触发器前面会显示图标。禁用的队列触发器前面将显示图标。

或者，也可以选择该触发器，然后单击“禁用”图标。

您还可以将触发器配置为在将来的特定日期和时间自动禁用。您可以按如下方式执行此操作：

单击相应的“编辑”按钮。
启用“计划自动禁用触发器”选项。
填写所需的日期和时间。触发器时区会影响触发器的禁用时间。
单击“更新”以使更改生效。
默认情况下，如果触发器在过去一天未能成功启动，则该触发器将在启动失败 10 次后自动禁用。

可以使用 Triggers.DisableWhenFailedCount 参数自定义此值。

启用触发器

要启用触发器，请单击相应的更多操作按钮，然后单击启用。启用的时间触发器前面会显示图标。启用的队列触发器前面将显示图标。

或者，也可以选择该触发器，然后单击“启用”图标。

删除触发器

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

或者，也可以选择该触发器，然后单击“删除”。

显示由触发器启动的作业

要显示由特定触发器启动的作业，请单击更多操作按钮，然后单击查看作业。这将显示作业窗口，其中包含过去通过选定的触发器（如果有）执行的所有作业。

管理非工作日

创建新日历

在“设置”页面上打开“非工作日”选项卡。将显示一个列表，其中包含先前定义的所有日历，并按字母顺序排列。

如果有节假日日历，则会在此处显示。如果您在先前版本中定义了非工作日，则在将 Orchestrator 升级到 19.10 时会创建此日历。
单击添加以创建新日历，然后在高亮显示的空白字段中键入其名称。名称必须是唯一的，并且最多只能包含 150 个字母数字字符。无法创建没有名称或仅包含空格字符的日历。
单击保存或按键盘上的 Enter 键以保存新日历。日历即会保存并显示在日历列表中。
对于选定的日历，可以手动或通过上传 .csv 文件定义非工作日，也可以两者结合来完成。
在“触发器”页面中创建新触发器或编辑现有触发器时，请从“非工作日限制”下拉列表中选择所需的日历。

注意：使用非工作日时，触发器时区必须与租户时区（“租户”>“设置”>“常规”）相同，因为不能为不同时区应用日历限制。没有显式定义时区的租户将继承主机的时区。
单击更新以使更改生效。对日历做出的每次更改随后都会传播到与该日历关联的所有触发器。