BPMN Workflows

The basic idea of SpiffWorkflow is that you can use it to write an interpreter in Python that creates business applications from BPMN models. In this section, we’ll develop a model of a reasonably complex process and show how to run it.

We expect that readers will fall into two general categories:

  • People with a background in BPMN who might not be very familiar Python
  • Python developers who might not know much about BPMN

This section of the documentation provides an example that (hopefully) serves the needs of both groups. We will introduce some of the more common BPMN elements and show how to build a simple workflow runner around them.

SpiffWorkflow does heavy-lifting such as keeping track of task dependencies and states and providing the ability to serialize or deserialize a workflow that has not been completed. The developer will write code for displaying workflow state and presenting tasks to users of their application.

All the Python code and BPMN models used here are available in an example project called spiff-example-cli.


Check out the code in spiff-example-cli and follow the instructions to set up an environment to run it in.

Run the sample workflow we built up using our example application with the following command:

./spiff-bpmn-runner.py -c order_collaboration \
     -d bpmn/tutorial/{product_prices,shipping_costs}.dmn \
     -b bpmn/tutorial/{top_level_multi,call_activity_multi}.bpmn

The code in the workflow runner and the models in the bpmn directory of the repository will be discussed in the remainder of this tutorial.