Article ID: 116331, created on Jun 24, 2013, last review on Aug 12, 2014

  • Applies to:
  • Business Automation


The article describes how to generate graph which will provide visual view of PBA Order Flow transitions.
Order Flow (OF) in PBA consists of list of transitions between order statuses. Each transition defines current status (displayed as 'From' in PBA Control Panel) of an order and two target statuses - Success and Fail depending on result of Order Flow handler defined for the transition.
All OF transitions for different types of order may be seen in PBA Provider Control Pane at Configuration Director > Order Processing > Order Flow, however it is hard to read such order flow since it is just a flat list of transitions.


The attached files demonstrate example of files generated based on the default Sales Order (SO) Order Flow in PBA 5.4.

  1. OrderFlow-SO.xls - Excel sheet with Sales Order transitions
  2. OrderFlow-SO.tsv - TSV (Tab-Separated Values) file with Sales Order transitions
  3. OrderFlow-SO.gv - Graphviz file with Sales Order transitions
  4. OrderFlow-SO.gv.pdf - PDF file with graphical view of Sales Order transitions


The attached PDF file with graphical view of an Order Flow transitions is generated by Graphviz tool.
The Perl script attached to the article may be used to translate OF definitions exported from PBA to file Graphviz can process.


1. Install Graphviz tool.

    Download Graphviz from the official website and install to your machine.

2. Export Order Flow transitions.

    2.1. Open Order Flow in PBA Provider Control Panel at Configuration Director > Order Processing > Order Flow > click on order type.
    2.2. Switch to the Order Flow Transitions tab and make sure that fields are ordered this way:
    From | Success | Fail | Transition Type | Action | From Status | Success Status | Fail Status
    In case fields are not in the order above, you can drag corresponding columns to change their order.
    2.3. Export Order Flow transitions to Excel file using the 'Export To Excel' button.

3. Translate transitions.

    3.1. Open generated .xls file in Excel and save it as TSV (Tab Separated Value) file.
    3.2. Run the attached Perl script to translate file from TSV to GV format: perl <file.tsv> <label> > <output-file.gv>
    <label> is any name you want to use as title of the graph.

4. Generate graph using Graphviz tool (dot.exe).

    4.1. Run the following command to generate PDF file: dot -T pdf -O <output-file.gv.pdf>


1. Graphviz (dot.exe) is capable of generating graph in different file formats like BMP, PNG, SVG, etc. Refer to the Graphviz official website for more information about supported file formats:
2. To make graph easier to view, the Perl script skips transitions which will loop directly to the current state, i.e. scripts skips transitions where 'From' state is equal to 'Success' or 'Fail' state.
3. The Graphviz tool allows to change format of the graph like color, font, lines, node shapes etc. Refer to the official documentation for more information about Graphviz -


e507bdb98979e3376dd8b109cbbb2ec3 6311ae17c1ee52b36e68aaf4ad066387 198398b282069eaf2d94a6af87dcb3ff caea8340e2d186a540518d08602aa065 e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF