定时触发
1. 简介
1.1 功能简介
定时触发是指，从设定的时间点或表单中的指定时间开始，按照一定频率周期性地触发「智能助手Pro」，使其向下执行所配置的节点动作。
1.2 应用场景
定时触发适用于需要在特定时间点、或按照预定计划执行的任务，可保障工作的准确性和时效性。如：
- 在 任务管理 中，对于已达截止时间但仍未完成的任务，将其状态自动修改为已逾期；
- 在门店管理中，每天定时发送通知，提醒各门店店长填写销售日报；
- 在 设备巡检 中，每天定时发起巡检流程，为负责人新增相应待办。
1.3 预期效果
以任务管理为例，在到达「任务管理表」中的截止时间时触发「智能助手Pro」，自动将超期未完成的任务状态标记为 “ 已逾期 ”。效果如下：
2. 操作步骤
2.1 新建「智能助手Pro」
进入「应用后台 >> 智能助手」，在右上角点击「新建智能助手」，并选择触发方式为「定时触发」。点击「确定」后，将自动进入设计页面。
2.2 设置触发时间类型
选中触发节点，进入节点配置页面，支持配置以下两种触发时间类型：
类型 | 说明 | 设置内容 | 适用场景 |
自定义时间 | 从设定的时间开始进行首次触发，随后按照指定频率重复触发。 |
| 定时发起任务 |
根据表单日期时间字段 | 以表单数据中的日期时间为基准，并根据需求设置时间偏移。则： 在到达了表单中某条数据的「日期时间+偏移时间」时，便会进行首次触发，随后按照指定频率重复触发。 |
| 根据表单数据动态发起任务 |
注：当触发时间类型为「根据表单日期时间字段」，且所选表单中的某条数据满足定时触发设置时：
1）若设置了触发条件，则会对触发条件进行校验，仅当通过校验时，才可触发「智能助手Pro」；
2）触发了「智能助手Pro」后，该数据即为触发数据，会被存储在触发数据节点中，供后续执行节点调用。
2.2.1 自定义时间触发
自定义「智能助手Pro」的首次触发时间，时间类型为「年-月-日 时:分」，如「2023-12-13 19:59」：
2.2.2 根据表单日期时间字段
选择表单中的相关 日期时间 字段，如「截止日期」字段：
注：选取表单内的日期时间字段时，仅支持选取当前应用内的表单。
在日期时间字段的基础上设置时间偏移。日期时间类型不同，可设置的时间偏移也不同。具体如下：
1） 若在表单设计中，该日期时间字段的类型为日期类型，即：
- 年-月
- 年-月-日
则指定时间可选当天/之前 N 天/之后 N 天的某个时刻（时刻类型为时:分）。
2）若在表单设计中，该日期时间字段的类型为日期时间类型，即：
- 年-月-日 时:分
- 年-月-日 时:分:秒
则指定时间可选当天/之前/之后的几分钟/小时/天。
3） 数据示例
字段类型 | 时间偏移 | 该日期字段的值举例 | 说明 |
日期 | 当天 9 点 | 2023 年 12 月 8 日 | 2023 年 12 月 8 日 9 点时，触发「智能助手Pro」 |
之前 7 天 9 点 | 2023 年 12 月 8 日 | 2023 年 12 月 1 日 9 点时，触发「智能助手Pro」 | |
之后 7 天 9 点 | 2023 年 12 月 8 日 | 2023 年 12 月 15 日 9 点时，触发「智能助手Pro」 | |
日期时间 | 当时 | 2023 年 12 月 8 日 15:10:10 | 2023 年 12 月 8 日 15:11，触发「智能助手Pro」 |
之前 30 分钟 | 2023 年 12 月 8 日 15:10:10 | 2023 年 12 月 8 日 14:41，触发「智能助手Pro」 | |
之后 30 分钟 | 2023 年 12 月 8 日 15:10:10 | 2023 年 12 月 8 日 15:41，触发「智能助手Pro」 |
注：若设置了触发条件，则在到达触发时间时，会先开始校验触发条件，在校验通过后方可触发「智能助手Pro」。
2.3 设置重复触发
设置重复触发的频率以及结束时间：
- 重复触发类型：支持只触发一次、固定周期触发、自定义触发；
- 结束触发时间：按周期重复触发，直到结束时间为止。若只触发一次，则无需设置结束时间。
2.3.1 不重复触发
只会定时触发一次「智能助手Pro」。
2.3.2 固定重复周期
固定重复周期包括每天触发一次、每周触发一次、每两周触发一次、每月触发一次、每年触发一次。
数据示例如下表所示：
首次触发时间 | 重复周期 | 结束时间 | 含义 |
2023-12-08 15:10 | 只触发一次 | — | 仅在 2023-12-08 15:11 触发一次「智能助手Pro」 |
2023-12-08 15:10 | 每天触发一次 | 2024-12-31 23:59 | 在 2023-12-08 15:11 触发一次「智能助手Pro」，且从此之后每过一天触发一次（下一次为 2023-12-09 15:11 ，以此类推），到 2024-12-31 23:59 为止 |
2023-12-08 15:10 | 每周触发一次 | 2024-12-31 23:59 | 在 2023-12-08 15:11 触发一次「智能助手Pro」，且从此之后每隔一周触发一次（下一次为 2023-12-15 15:11 ，以此类推），到 2024-12-31 23:59为止 |
2023-12-08 15:10 | 每两周触发一次 | 2024-12-31 23:59 | 在 2023-12-08 15:11:00 点触发一次「智能助手Pro」，且从此之后每过两周触发一次（下一次为 2023-12-22 15:11 ，以此类推），到 2024-12-31 23:59 为止 |
2023-12-08 15:10 | 每月触发一次 | 2024-12-31 23:59 | 在 2023-12-08 15:11 点触发一次「智能助手Pro」，且从此之后每隔一月触发一次（下一次为 2024-01-08 15:11 ，以此类推），到 2024-12-31 23:59 为止 |
2023-12-08 15:10 | 每年触发一次 | 2024-12-31 23:59 | 在 2023-12-08 15:11 点触发一次「智能助手Pro」，且从此之后每年触发一次（下一次为 2024-12-08 15:11 ，以此类推），到 2024-12-31 23:59 为止 |
注：若设置了触发条件，则在到达触发时间时，会先开始校验触发条件，在校验通过后方可触发「智能助手Pro」。
2.3.3 自定义重复周期
仅当触发时间类型为「自定义时间触发」时，可自定义重复周期。自定义重复周期又可设置为「按周重复」和「按月重复」。
1）按周重复
允许设置每 N 周触发一次，并具体指定周内的哪一天或哪几天触发「智能助手Pro」。例如，对于日报收集，可以配置为仅在工作日的「周一～周五」触发收集通知，而周末则不触发。
2）按月重复
允许设置每 N 个月触发一次，并具体指定月内的哪一天或哪几天触发「智能助手Pro」。举例来说，如果需要进行季度复盘，可以配置为每 3 个月，在月内的最后一个自然日触发通知。
选择按月重复的日期时，又支持选择「指定日期」和「相对日期」。
- 指定日期：固定选取一个月中指定的某一天或者某几天进行触发。若选择每月 31 号触发，则当某月没有 31 号时将不触发。
- 相对日期：支持设置最后一个自然日进行触发，也就是当一个月最后一个自然日是 30 号，那么就是 30 号触发；如果是 31 号，那么就是 31 号触发。
2.4 设置触发条件
当且仅当触发时间类型为「根据表单日期时间字段」时，可以设置触发条件。若设置了触发条件，则到达触发时间时会先校验「触发条件」，校验通过后才会触发「智能助手Pro」。
点击「添加触发条件」，触发条件需要设置的内容及说明如下所示：
序号 | 设置项 | 说明 |
1 | 多个条件间的关系 | 当存在多个触发条件时，可以选择满足「所有」或「任一」条件；
|
2 | 触发字段 | 选择触发表单中的字段，字段支持情况如下：
|
3 | 过滤关系 | 根据触发字段类型，设置不同的过滤关系，如等于、不等于、等于任意一个、不等于任意一个、包含、不包含、为空、不为空 |
4 | 过滤值 | 由触发字段和过滤关系决定，可能是单值、多值、选项或文本，也可能不需要填写 |
至此，触发节点已设置完成，接下来可以进行后续执行节点的设置，详情参见：执行节点详解。
3. 注意事项
1）定时触发时间支持精确到分钟；
2）若触发方式为「自定义时间」，则智能助手Pro 在首次执行时，会根据设定的开始触发时间与重复周期，生成虚拟的上次运行时间（执行后便会记录实际的上次运行时间），供后续插件节点调用，如 考勤数据同步类插件。
3）当触发时间类型为「根据表单日期时间字段」时，通常情况下，每小时最多触发 500 条数据。
Q：为什么表单中有 500 条满足触发规则的数据，但实际触发了不到 500 条？
「根据表单日期时间字段」的触发逻辑为，系统会每小时扫描出 1h 内会触发的（最多）500 条数据。如，在 8:00 时进行扫描，扫描出 8:00-9:00 符合条件的数据并分别生成定时任务，使数据能够按时触发。
但是，若在该 1h 时间段内发布了新的智能助手版本/进行了批量数据操作，则会作废原剩余未执行的定时任务，并在当前时间点重新扫描。如，在 8:30 进行了批量修改，则原 8:30-9:00 间的定时任务将被作废，并重新生成一批 8:30-9:30 的定时任务。
由于每次定时任务的生成是随机的，可能原 8:00-8:30、8:30-9:00（被作废）内生成的任务各有 250 个，新 8:30-9:00 有 200 个，新 9:00-9:30 有 300 个。因此实际上，8:00-9:00 仅执行了 450 个定时任务，仅触发了 450 条数据。
400-111-0890
在线咨询