触发器节点

触发器节点管理用户的自动化定时任务，可创建或更新触发器、查询触发器列表，以及删除不再需要的触发器。

触发器分类只在 应用模式 或 对话流 中显示。普通独立工作流根画布不会显示该分类，这是当前编辑器的上下文控制。

设置定时触发器节点

设置定时触发器节点创建新的用户触发器，或使用已有触发器 ID 更新配置。

输入	必填	说明
triggerId	否	留空表示创建；传入已有 ID 表示更新
userId	是	触发器所属用户，必须来自可信的用户上下文
triggerName	是	便于用户识别用途的名称
时区	否	当前默认 Asia/Shanghai，应按用户所在地设置
触发时间	是	可使用界面预设或 Cron 表达式
绑定工作流	是	触发时实际执行的工作流
工作流参数	按目标契约	映射目标工作流开始节点的必填输入

输出 triggerId。创建后应保存该值，供查询、修改或删除使用。

绑定工作流必须处于可执行状态；发布后修改其开始节点参数时，要同步检查已有触发器保存的参数。

查询定时触发器节点

查询节点根据用户和可选触发器 ID 获取定时任务。

输入	必填	说明
triggerId	否	指定时查询某一个触发器，留空时按用户查询
userId	是	只查询该用户的触发器

输出 outputList，列表项包含：

• triggerId：触发器 ID。
• triggerName：触发器名称。
• createTime：创建时间。
• triggerTime：触发时间配置。
• userId：所属用户。

后续处理前先判断列表是否为空，不要直接访问第一项。

删除定时触发器节点

删除节点移除指定用户的定时触发任务。

输入为 triggerId 和 userId；当前配置中 userId 必填，业务上删除具体触发器时也应提供准确的 triggerId，避免扩大删除范围。

输出：

字段	类型	说明
success	Boolean	删除操作是否成功
numberOfDeletions	Number	实际删除数量

删除后检查 numberOfDeletions，为 0 时应提示目标不存在、已删除或不属于当前用户。

示例：每日任务提醒

1. 应用取得当前用户 ID、提醒时间和任务内容。
2. 设置定时触发器，绑定“发送任务提醒”工作流，并把任务内容映射为工作流参数。
3. 使用查询节点展示该用户的提醒列表。
4. 用户取消提醒时，传入列表中的 triggerId 和当前 userId 执行删除。

不要把另一个用户提供的 triggerId 直接用于查询或删除；服务端权限和工作流参数都应同时校验用户归属。