How to Dump Workflows

To help you debug your workflows, you can generate a visual representation of them as SVG or PNG images. First, install any of these free and open source applications needed to generate the images:

ワークフローのデバッグを支援するために、ワークフローの視覚的表現を SVG または PNG 画像として生成できます。まず、イメージの生成に必要な次の無料のオープン ソース アプリケーションをインストールします。
  • Graphviz, provides the dot command;
    Graphviz は dot コマンドを提供します。
  • Mermaid CLI, provides the mmdc command;
    Mermaid CLI は、mmdc コマンドを提供します。
  • PlantUML, provides the plantuml.jar file (which requires Java).
    PlantUML は、plantuml.jar ファイル (Java が必要) を提供します。

If you are defining the workflow inside a Symfony application, run this command to dump it as an image:

Symfony アプリケーション内でワークフローを定義している場合は、次のコマンドを実行してイメージとしてダンプします。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
# using Graphviz's 'dot' and SVG images
$ php bin/console workflow:dump workflow-name | dot -Tsvg -o graph.svg

# using Graphviz's 'dot' and PNG images
$ php bin/console workflow:dump workflow-name | dot -Tpng -o graph.png

# using PlantUML's 'plantuml.jar'
$ php bin/console workflow:dump workflow_name --dump-format=puml | java -jar plantuml.jar -p  > graph.png

# highlight 'place1' and 'place2' in the dumped workflow
$ php bin/console workflow:dump workflow-name place1 place2 | dot -Tsvg -o graph.svg

# using Mermaid.js CLI
$ php bin/console workflow:dump workflow_name --dump-format=mermaid | mmdc -o graph.svg

The DOT image will look like this:

DOT 画像は次のようになります。

The Mermaid image will look like this:

人魚の画像は次のようになります。

The PlantUML image will look like this:

PlantUML イメージは次のようになります。

If you are creating workflows outside of a Symfony application, use the GraphvizDumper or StateMachineGraphvizDumper class to create the DOT files and PlantUmlDumper to create the PlantUML files:

Symfony アプリケーションの外部でワークフローを作成する場合は、GraphvizDumper または StateMachineGraphvizDumper クラスを使用して DOT ファイルを作成し、PlantUmlDumper を使用して PlantUML ファイルを作成します。
1
2
3
4
5
6
7
 
// Add this code to a PHP script; for example: dump-graph.php
$dumper = new GraphvizDumper();
echo $dumper->dump($definition);

# if you prefer PlantUML, use this code:
# $dumper = new PlantUmlDumper();
# echo $dumper->dump($definition);
 
1
2
3
 
# replace 'dump-graph.php' by the name of your PHP script
$ php dump-graph.php | dot -Tsvg -o graph.svg
$ php dump-graph.php | java -jar plantuml.jar -p  > graph.png

Styling

You can use metadata with the following keys to style the workflow:

次のキーでメタデータを使用して、ワークフローのスタイルを設定できます。

  • for places:

    場所:
    • bg_color: a color;
      bg_color: 色;
    • description: a string that describes the state.
      description: 状態を説明する文字列。

  • for transitions:

    トランジションの場合:
    • label: a string that replaces the name of the transition;
      label: トランジションの名前を置き換える文字列。
    • color: a color;
      color: 色;
    • arrow_color: a color.
      arrow_color: 色。

Strings can include \n characters to display the contents in multiple lines. Colors can be defined as:

文字列に \n 文字を含めると、コンテンツを複数行で表示できます。色は次のように定義できます。
  • a color name from PlantUML's color list;
    PlantUML のカラー リストからのカラー名。
  • an hexadecimal color (both #AABBCC and #ABC formats are supported).
    16 進数の色 (#AABBCC と #ABC の両方の形式がサポートされています)。

Note

ノート

The Mermaid dumper does not support coloring the arrow heads with arrow_color as there is no support in Mermaid for doing so.

Mermaid ダンパーは、arrow_color を使用した矢印の頭の色付けをサポートしていません。これは、Mermaid ではサポートされていないためです。

Below is the configuration for the pull request state machine with styling added.

以下は、スタイリングが追加されたプル リクエスト ステート マシンの構成です。
  • YAML
    YAML
  • XML
    XML
  • PHP
    PHP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# config/packages/workflow.yaml
framework:
    workflows:
        pull_request:
            type: 'state_machine'
            marking_store:
                type: 'method'
                property: 'currentPlace'
            supports:
                - App\Entity\PullRequest
            initial_marking: start
            places:
                start: ~
                coding: ~
                test: ~
                review:
                    metadata:
                        description: Human review
                merged: ~
                closed:
                    metadata:
                        bg_color: DeepSkyBlue
            transitions:
                submit:
                    from: start
                    to: test
                update:
                    from: [coding, test, review]
                    to: test
                    metadata:
                        arrow_color: Turquoise
                wait_for_review:
                    from: test
                    to: review
                    metadata:
                        color: Orange
                request_change:
                    from: review
                    to: coding
                accept:
                    from: review
                    to: merged
                    metadata:
                        label: Accept PR
                reject:
                    from: review
                    to: closed
                reopen:
                    from: closed
                    to: review

The PlantUML image will look like this:

PlantUML イメージは次のようになります。