Skip to content

Workflow and tasks

A workflow in Dotflow is an ordered set of tasks built on a DotFlow instance. You register steps with workflow.task.add(...), then run them through start (one-shot execution) or schedule (recurring runs when a scheduler is configured).

Main pieces

Piece Role
DotFlow Entry point: holds config, workflow_id, and the task builder.
TaskBuilder Collects tasks in a queue before execution.
Manager Runs the queue (sequential, background, or parallel) and coordinates storage and callbacks.
Action A callable decorated with @action; Dotflow wraps it as a unit of work with context in/out.

Each task consumes previous context from the prior step and can emit a new context for the next one. See Concept of context and the Initial context / Previous context how-tos.

Execution vs scheduling

  • start runs the workflow now (see Process Mode for how tasks are ordered and parallelized).
  • schedule delegates to the configured scheduler (for example cron); overlap between runs is controlled by overlap strategies.

References