BPMN Workflow

BPMN (Business Process Model and Notation) is a standard for drawing business processes. Viewflow lets you write BPMN diagrams as Python code and run them.

Unlike finite state machines, BPMN supports parallel task execution. This matters when multiple people need to work on different parts of a process at the same time.

Code-First Workflows

Most BPMN tools use graphical designers. You drag boxes and draw arrows. Viewflow takes a different approach: you write workflows in Python.

This means you can:

• Track changes in git
• Review workflows in pull requests
• Reuse code across different workflows
• Test workflows with standard Python tools

The viewflow.workflow module adds a thin layer on top of Django’s Model/View/Template pattern. It extracts workflow logic from your views, so you can reuse the same view code in different workflows.

Table of Contents

• Quick Start
• Writing Your Flow
• Data Management
• Permission Management
• Core Concepts
• Built-in Nodes
• Built-in Viewsets
• Writing Custom Views
• Templates
• API