工作流触发器
触发器决定任务何时运行。在 GeniSpace 中，触发方式由任务的类型决定，您在创建任务时选择该类型。共有三种任务类型：
| 任务类型 | 触发方式 | 运行时机 |
|---|---|---|
| 手动任务 | 手动触发 | 仅在您从控制台启动时运行 |
| 事件任务 | Webhook | 当外部系统调用该任务的 Webhook 时运行 |
| 定时任务 | Cron 计划 | 按您定义的计划自动运行 |
您在创建任务对话框中选择类型（完整的创建流程请参阅任务管理）。每个任务有且仅有一种类型。
手动触发
手动任务仅在您亲自启动时运行。这是最简单的触发方式，适用于按需作业、测试，以及需要人工启动的工作流。
运行手动任务
您可以在两个位置启动手动任务：
- 从任务列表：使用任务行上的立即运行操作。
- 从任务编辑器：点击顶部工具栏的立即运行（如有提示，请先保存改动）。
运行任务时，会弹出参数表单，供您填写工作流所需的输入参数。提交后即开始执行，您可以在底部调试面板中跟踪运行情况。
提示
在构建工作流的过程中，手动运行是最便捷的测试方式。运行、查看实时日志、调整设计，然后再次运行。
事件触发（Webhook）
事件任务用于由外部系统通过 Webhook 启动。创建事件任务时，任务会携带两个与 Webhook 相关的字段：
| 字段 | 说明 |
|---|---|
| Webhook URL | 与任务关联的 URL，由系统生成（只读） |
| 密钥令牌 | 可选的密钥，用于校验请求 |
您在任务上配置这些字段，并在对接需要通知 GeniSpace 的第三方系统时使用它们。
备注
事件任务通过上述 Webhook URL 和密钥令牌字段进行配置。关于在您的部署中调用任务 Webhook 时所需的具体请求格式，请咨询平台管理员或参阅 API 文档。
定时触发（Cron）
定时任务按您用 Cron 表达式定义的计划自动运行。调度由 croner 引擎处理。
Cron 表达式格式
GeniSpace 的 Cron 表达式采用包含秒字段的 6 字段格式：
┌──────────── 秒 (0 - 59)
│ ┌────────── 分 (0 - 59)
│ │ ┌──────── 时 (0 - 23)
│ │ │ ┌────── 日 (1 - 31)
│ │ │ │ ┌──── 月 (1 - 12)
│ │ │ │ │ ┌── 星期 (0 - 7，0 和 7 均表示周日)
│ │ │ │ │ │
* * * * * *
示例：
| 表达式 | 含义 |
|---|---|
0 0 9 * * * | 每天 09:00:00 |
0 0 9 * * 1-5 | 周一至周五 09:00:00 |
0 */15 * * * * | 每 15 分钟一次 |
0 0 0 1 * * | 每月 1 号零点 |
计划按任务所有者的时区进行评估。
提示
创建任务对话框提供可视化构建器，帮助您组装 Cron 表达式，无需手动书写。
生效起止日期范围
除了周期性计划外，定时任务还支持可选的生效时间窗口：
- 开始日期（定时任务必填）：任务不会早于该日期运行。
- 结束日期（可选）：任务不会晚于该日期运行。
平台在判断是否运行任务时会强制执行该窗口：定时任务仅在以下条件全部满足时运行——状态为激活、具有有效的计划、当前时间不早于开始日期，且（若已设置）不晚于结束日期。一旦结束日期已过，任务将不再被调度。
如何选择触发类型
- 对于按需作业、临时报告，以及任何应由人工启动的场景，使用手动任务。
- 当应由外部系统通过 Webhook 启动工作流时，使用事件任务。
- 对于周期性工作（如定期报告、数据同步、清理作业），使用定时任务。