Scheduler Module
Pause workflows on a timer, schedule reminders with custom data, and start workflows on a recurring or one-shot schedule.
Workflow Engine V 2.1.0Description
What this does
Five task types, each with a single purpose:
- WaitFor (intermediate) — pause the current execution for a friendly duration (Amount + Unit) then resume.
- WaitUntil (intermediate) — pause the current execution until a specific UTC datetime then resume. Supports
{variable}interpolation in the wake time. - ScheduleRecurring (start) — fire fresh executions on a recurring schedule. Pick a preset (every 5 min, hourly, daily, weekly, monthly) or supply a custom 5-field cron.
- ScheduleOnce (start) — fire a fresh execution exactly once at a specific UTC datetime, then disable.
- ScheduleReminder (intermediate) — at a future time, start a NEW execution of the current environment with optional payload. The new execution's
RootExecutionIdis set to the calling execution's id, so audit logs and traces group them together.
All five share one table (scheduled_trigger) and one ticker. The ticker uses an atomic per-row claim so multiple Engine instances cooperate without leader election or duplicate fires.
Lifecycle
- A re-deploy updates / removes Static cron + one-shot starts, but never touches in-flight Waits or pending Reminders — those belong to specific executions.
- Module uninstall (via
WorkflowEngine.ModuleSync uninstall) wipes everything for the environment.
See the setup guide for configuration and full task reference.
