管理触发器

创建时间触发器

1. 在文件夹中，导航到“自动化”>“触发器”，然后在“触发器”页面上，单击“添加新触发器”。系统将显示“创建触发器”页面。

2. 选择“时间”作为触发器类型。

3. 在“名称”字段中，为触发器添加一个名称，以方便识别。

4. 从“流程名称” 下拉菜单中，选择要为其配置时间触发器的流程。

5. 从“作业优先级” 下拉菜单中，选择作业的优先级。 默认值为Inherited ，这意味着作业优先级与为选定流程定义的优先级相同。

6. From the Runtime type drop-down menu, select the runtime used to execute the jobs that are launched by the trigger.

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

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

   备注：

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

   • 要确定选择未激活的主机名，请单击“确认”。
   • 要返回并选择另一个主机名，请单击“取消”。

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

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

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

8. On the Arguments tab, provide values for input arguments if your process has any.

9. 从“时区” 下拉菜单中，选择触发触发器的时区。

   备注：

   • 触发器时区不依赖于租户时区。 您可以为时间触发器执行设置不同的时区。
   • 使用夏令时 (DST) 的位置在其 UTC 偏移量中列出。 DST 生效时，UTC 偏移量不会增加。 例如，在 DST 期间，伦敦时区显示为 UTC+00:00。
   • Orchestrator 的计划机制会在启动作业时自动考虑DST，因此无需调整时区将 DST 考虑在内。计划在 12:00 运行的作业在冬季和夏季的运行时间均为 12:00。

10. 选择触发器的执行频率（分钟、每小时、每天、每周、每月、高级）。在本部分的右侧，根据所选选项（频率，确切时间或 CRON 表达式）配置详细信息。Orchestrator 使用开源库来解析和显示 CRON 描述，请参见此处。

    备注：

    CRON 表达式可以与非工作日结合使用。这意味着，如果通过 CRON 表达式将触发器配置为在某个被排除的日期运行，则系统会跳过这一天，并将触发器重新安排在下一个可用的日子，依此类推。

11. 选择希望触发器执行的频率（以分钟为单位）。

    重要提示：

    The cron standard employed by our cron expressions uses a time system based on 60 minutes to an hour. This means that the only way it can execute a trigger at the exact interval configured in the Repeat every field is if the value of that interval is a divisor of 60. Otherwise, the recurrence will not entirely abide by the number of minutes in that field, thus causing execution discrepancies. To avoid this, we recommend adjusting your trigger settings or using event triggers.

    示例：您将触发器设置为每 21 分钟执行一次，并在 9:00 开始作业。这将呈现以下执行计划：

    • 第一个作业于 9:00 开始。
    • 第二个作业于 9:21 开始。
    • 第三个作业于 9:42 开始。
    • 第四个作业于 10:00 开始。

    The reason why the fourth job starts after 18 minutes instead of 21 is that the cron component matches every 21^st item from a set of minutes between 1 and 59. In this example, these items are 00, 21, 42.

12. From the Non-working days restrictions drop-down menu, select a non-working days calendar, if you want your trigger to stop firing on certain non-business days.

13. 打开“计划结束作业执行”开关，以选择作业终止策略。

    备注：

    • 即使作业在排队等待，此处指定的时间仍会按照您的要求计算。例如，如果您将某个作业计划为在下午 1 点运行，并将其设置为在 20 分钟后停止，则即使该作业一直停留在队列中，直到下午 1:15 才开始，也会在下午 1:20 停止。
    • 为手动启动的作业保留触发器的“计划结束作业执行”选项。

    例如，假设您创建了触发器 T1 并激活了以下作业结束计划：

    • 计划作业执行结束：10 分钟后停止作业

    • Schedule automatic "Kill", if the job does not stop:Kill job after 2 mins

      在“自动化”>“触发器”页面上，当您单击触发器 T1 的“立即启动作业”时，系统将打开“启动作业”页面，其中已应用了您在创建触发器时配置的作业结束计划。

    Example: If you schedule to stop a Pending or Running job after 2 hours and also configure to kill the same job after 3 hours, the job will be killed after 5 hours. This happens because, first, the signal is sent to Orchestrator that the job was indeed stopped after 2 hours. Once the signal has been received, the kill job action is triggered to occur in 3 hours, thus resulting a total of 5 hours.

    • 从下拉列表中选择“停止- 在作业一直处于“待处理”或“正在运行”状态后经过已定义的时间间隔后尝试正常结束执行（将时间设置为最短 1 分钟、最长 10 天零 23 小时） 59 分钟）；

      示例：Orchestrator 将尝试停止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。

      

    • 从下拉列表中选择“终止” - 从作业一直处于“待处理”或“正在运行”状态以来，经过已定义的时间间隔后尝试强制结束执行（将时间设置为最短 1 分钟，最长 10 天零 23 小时） 59 分钟）；

      示例：Orchestrator 将尝试终止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。

      

    • 从下拉列表中选择“停止”，然后启用“如果作业未停止，则终止作业”选项 - 自作业一直处于“待处理”或“正在运行”状态以来，在定义的时间间隔过后尝试正常结束执行，然后尝试强制终止作业在作业一直处于“正在停止”状态以来，已经过定义的时间间隔后结束作业（将时间设置为最短 1 分钟，最长 10 天 23 小时 59 分钟）。

      示例：Orchestrator 将尝试停止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。如果无法终止，Orchestrator 将尝试终止处于“正在停止”状态至少 20 分钟的作业。

      

14. 打开“计划自动禁用触发器”切换开关，然后输入要禁用触发器的日期和时间。所选时区决定了何时禁用时间触发器。

15. 要保持配置用于启动作业（步骤 7）的相同用户-计算机上下文，请选中“在作业恢复时保持用户/计算机分配”复选框。这可优化您的许可证和资源使用情况。

创建队列触发器

备注：

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

1. 在文件夹中，导航到“自动化”>“触发器”，然后在“触发器”页面上，单击“添加新触发器”。系统将显示“创建触发器”页面。

2. 选择“队列”作为触发器类型。

3. 在“名称”字段中，为触发器添加一个名称，以方便识别。

4. 从“流程名称” 下拉菜单中，选择要为其配置时间触发器的流程。

5. 从“作业优先级” 下拉菜单中，选择作业的优先级。 默认值为Inherited ，这意味着作业优先级与为选定流程定义的优先级相同。

6. From the Runtime type drop-down menu, select the runtime license type.

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

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

   备注：

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

   • 要确定选择未激活的主机名，请单击“确认”。
   • 要返回并选择另一个主机名，请单击“取消”。

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

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

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

8. On the Arguments tab, provide values for input arguments if your process has any.

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

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

10. From the Timezone drop-down menu, select the time zone according to which the queue trigger gets disabled.

11. From the Non-working days restrictions drop-down menu, select a non-working days calendar if you want your trigger to stop firing on certain non-business days.

12. 打开“计划结束作业执行”开关，以选择作业终止策略。

    备注：

    • 即使作业在排队等待，此处指定的时间仍会按照您的要求计算。例如，如果您将某个作业计划为在下午 1 点运行，并将其设置为在 20 分钟后停止，则即使该作业一直停留在队列中，直到下午 1:15 才开始，也会在下午 1:20 停止。
    • 为手动启动的作业保留触发器的“计划结束作业执行”选项。

    例如，假设您创建了触发器 T1 并激活了以下作业结束计划：

    • 计划作业执行结束：10 分钟后停止作业

    • Schedule automatic "Kill", if the job does not stop:Kill job after 2 mins

      在“自动化”>“触发器”页面上，当您单击触发器 T1 的“立即启动作业”时，系统将打开“启动作业”页面，其中已应用了您在创建触发器时配置的作业结束计划。

    Example: If you schedule to stop a Pending or Running job after 2 hours and also configure to kill the same job after 3 hours, the job will be killed after 5 hours. This happens because, first, the signal is sent to Orchestrator that the job was indeed stopped after 2 hours. Once the signal has been received, the kill job action is triggered to occur in 3 hours, thus resulting a total of 5 hours.

    • 从下拉列表中选择“停止- 在作业一直处于“待处理”或“正在运行”状态后经过已定义的时间间隔后尝试正常结束执行（将时间设置为最短 1 分钟、最长 10 天零 23 小时） 59 分钟）；

      示例：Orchestrator 将尝试停止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。

      

    • 从下拉列表中选择“终止” - 从作业一直处于“待处理”或“正在运行”状态以来，经过已定义的时间间隔后尝试强制结束执行（将时间设置为最短 1 分钟，最长 10 天零 23 小时） 59 分钟）；

      示例：Orchestrator 将尝试终止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。

      

    • 从下拉列表中选择“停止”，然后启用“如果作业未停止，则终止作业”选项 - 自作业一直处于“待处理”或“正在运行”状态以来，在定义的时间间隔过后尝试正常结束执行，然后尝试强制终止作业在作业一直处于“正在停止”状态以来，已经过定义的时间间隔后结束作业（将时间设置为最短 1 分钟，最长 10 天 23 小时 59 分钟）。

      示例：Orchestrator 将尝试停止一直处于“待处理”或“正在运行”状态至少 10 分钟的作业。如果无法终止，Orchestrator 将尝试终止处于“正在停止”状态至少 20 分钟的作业。

      

13. 启用“计划自动禁用触发器”切换开关，然后输入要禁用触发器的日期和时间。所选时区决定了何时禁用队列触发器。

14. 要保持配置用于启动作业（步骤 7）的相同用户-计算机上下文，请选中“在作业恢复时保持用户/计算机分配”复选框。这可优化您的许可证和资源使用情况。

编辑触发器

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

禁用触发器

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

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

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

1. 单击相应的“编辑”按钮。

2. 启用“计划自动禁用触发器”选项。

3. 填写所需的日期和时间。 触发器时区会影响触发器的禁用时间。

4. 单击“更新”以使更改生效。

   默认情况下，如果触发器在过去一天未能成功启动，则该触发器将在启动失败 10 次后自动禁用。

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

启用触发器

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

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

删除触发器

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

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

显示由触发器启动的作业

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

管理非工作日

创建新日历

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

   如果有节假日日历，则会在此处显示。如果您在先前版本中定义了非工作日，则在将 Orchestrator 升级到 19.10 时会创建此日历。

2. 单击“添加”以创建新日历，然后在高亮显示的空白字段中键入其名称。名称必须是唯一的，并且最多只能包含 150 个字母数字字符。无法创建没有名称或仅包含空格字符的日历。

3. 单击“保存”或按键盘上的 Enter 键以保存新日历。日历即会保存并显示在日历列表中。

4. 对于选定的日历，可以手动或通过上传 .csv 文件定义非工作日，也可以两者结合来完成。

5. 在“触发器”页面中创建新触发器或编辑现有触发器时，请从“非工作日限制”下拉列表中选择所需的日历。

   备注：

   When you use non-working days, the trigger time zone must be the same as the tenant time zone (Tenant> Settings> General), because calendar restrictions cannot be applied in different time zones. A tenant without an explicitly defined time zone inherits it from the host.

6. 单击“更新”以使更改生效。对日历做出的每次更改随后都会传播到与该日历关联的所有触发器。

手动选择非工作日

1. 选择日历。窗口右侧的日历会相应更新。
2. 在显示的日历上，单击您希望触发器停止触发的日期。在选定日期重新选择，以将其取消选择。
3. 选择“保存”，以将选定日期保存为非工作日。

通过上传 .csv 文件

使您能够直接从 .csv 文件将一系列日期上传到所选日历。请注意，必须事先使用预定义的格式填充文件，以确保上传操作成功。上传的文件中的新日期将覆盖日历中已包含的所有日期。

备注：

.csv 文件必须包含 ExcludedDate 列标题。所有非工作日必须在该列中，并以 YYYY-MM-DD、YYYY/MM/DD 或 YYYY MM DD 格式编写。

See the Example section below for more information.

选项 1

1. 在所选日历上，单击“上传 CSV”。
2. 导航至所需的 .csv 文件，然后选择该文件并单击“打开”。Orchestrator 会解析文件以确认其符合格式设置规则（请参阅下面的“示例”部分）。
3. 在确认对话框中单击“是”，将日历中已包含的日期替换为上传的文件中的新日期。
4. 单击“保存”以保存修改后的日历。

选项 2

1. 将所需的 . 文件拖放到所选日历的顶部。Orchestrator 会解析文件以确认其符合格式设置规则（请参阅下面的“示例”部分）。
2. 在确认对话框中单击“是”，将日历中已包含的日期替换为上传的文件中的新日期。
3. 单击“保存”以保存修改后的日历。

示例

Let's say you upload into a calendar the content of the following .csv file. An easy way to create such a file is to populate the data into an excel file and save it as a .csv file:

或者，您也可以下载具有所有预填充列标题的 .csv 文件，并根据需要自定义它。

下载文件

请注意，此文件包含预定义的列标题 ExcludedDate。使用 YYYY-MM-DD、YYYY/MM/DD 或 YYYY MM DD 格式在该列中输入所有非工作日。

重命名日历

1. 在“设置”页面的“非工作日”选项卡中选择日历。
2. 修改日历名称。
3. 单击“保存”以保存更改后的名称。

删除日历

1. 在“设置”页面的“非工作日”选项卡中选择日历。

2. 单击“删除”。

3. 在弹出窗口中单击“是”以确认您的意图。日历即会删除。

   备注：

   只能删除未附加到任何触发器的日历。

您还可以从日历中删除非工作日。单击某个非工作日后，系统将不再标记该非工作日。请记住保存更改。