为 App 和工作流配置定时运行
定时任务可在指定时间启动 App 或工作流,无需每次手动运行。任务保存在本地;下次打开 Workrun 后会继续调度。
定时任务仅在 Workrun 桌面应用保持打开时运行,并不是云端后台服务。对时间要求严格的自动化请保持 Workrun 运行。
创建和管理定时任务
Section titled “创建和管理定时任务”App 定时任务
Section titled “App 定时任务”- 进入 Apps,选择要自动运行的 App。
- 在 Schedules 中点击 New schedule。
- 填写易识别的名称,选择预设频率或 Custom Cron,然后选择时区。
- 检查预览,点击 Save schedule。
该演示展示了创建 App 定时任务、确认配置,以及等待任务触发的完整过程。
工作流定时任务
Section titled “工作流定时任务”- 打开工作流编辑器,在设置中找到 Automation。
- 点击 New schedule。
- 填写工作流输入。保存前必须填写所有必填输入。
- 选择频率、时间(或自定义 Cron)与时区,检查后续触发时间,然后保存。
任务列表会在所选时区显示每条任务是否启用以及下一次运行时间。使用开关暂停或恢复,点击铅笔编辑,点击删除按钮移除。删除后无法恢复。
该演示展示了创建工作流定时任务、填写计划运行的输入,以及任务触发后的运行过程。
选择频率或编写 Cron
Section titled “选择频率或编写 Cron”Every day、Every weekday 和 Every week 会自动生成表达式。需要其他规则时选择 Custom Cron。
Workrun 仅接受由五个、以空格分隔的字段组成的 Cron:
| 位置 | 字段 | 示例 |
|---|---|---|
| 1 | 分钟 | 0、*/15、5,35 |
| 2 | 小时 | 9、8-18、*/2 |
| 3 | 日期 | 1、1-7、*/2 |
| 4 | 月份 | 1、1,4,7,10、* |
| 5 | 星期 | 1-5、1、* |
* 表示任意值,, 表示列表,- 表示范围,/ 表示步长。星期 1 是周一,因此 1-5 表示周一至周五。不支持秒字段。
| 目的 | Cron 表达式 |
|---|---|
| 每天 09:00 | 0 9 * * * |
| 工作日 09:30 | 30 9 * * 1-5 |
| 每 15 分钟 | */15 * * * * |
| 每月 1 日 18:00 | 0 18 1 * * |
表达式按任务设置的 IANA 时区(如 Asia/Shanghai、America/New_York)解释,而不是查看运行记录时设备所在的时区。编辑器会校验表达式与时区,并预览接下来的三次触发;夏令时切换前后尤其应检查预览。
App 与工作流的差异
Section titled “App 与工作流的差异”App 定时任务会运行已保存的 App,适合独立的代码任务,例如周期性采集数据或清理数据。
工作流定时任务会保存配置好的输入,并在每次运行时使用它们。本地工作流任务在触发时解析该工作流最新保存的版本。团队模式下需选择已发布版本;任务会固定该版本,之后的编辑不会改变已调度的行为。
定时工作流必须能在无人参与时完成。包含 Human Review 或 Ask User Question 节点的工作流无法保存为定时任务;创建任务前必须移除这些节点,仅让定时路径避开它们并不足够。若原本有效的本地工作流之后被删除或变得无效,Workrun 会暂停其任务并记录错误,避免持续尝试运行。
- 保存、编辑、暂停、恢复或删除任务后,调度器会立即唤醒并应用变更。
- 到期的运行会写入正常的运行历史;可在运行面板和追踪中检查输出或错误。
- Workrun 会阻止同一 App 或工作流重叠执行。目标已排队、运行中或等待输入时,本次会标为跳过,并推进到下一个匹配时间。
- Workrun 启动时,关闭期间错过的触发会推进到下一次未来触发,不会集中补跑积压任务。
对于会写入、发送或产生其他外部副作用的任务,请让 App 或工作流可以安全地重复执行,并把频率设得长于常见执行时长。启用前请先手动测试,并检查目标的权限。