Как сбрасывать рабочие процессы

Дата обновления перевода 2024-07-29

Как сбрасывать рабочие процессы

Чтобы помочь вам отладить рабочие процессы, вы можете создать их визуальное представление в виде изображений SVG или PNG. Сначала установите любое из этих бесплатных приложений с открытым исходным кодом, необходимых для создания изображений

Graphviz, предоставляет команду dot;
Mermaid CLI, предоставляет команду mmdc;
PlantUML, предоставляет файл plantuml.jar (для работы которого требуется Java).

Если вы определяете рабочий процесс внутри приложения Symfony, выполните эту команду, чтобы сбросить его в виде изображения:

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
        # используя изображения Graphviz 'dot' и SVG
$ php bin/console workflow:dump workflow-name | dot -Tsvg -o graph.svg

# используя изображения Graphviz 'dot' и PNG 
$ php bin/console workflow:dump workflow-name | dot -Tpng -o graph.png

# использця PlantUML 'plantuml.jar'
$ php bin/console workflow:dump workflow_name --dump-format=puml | java -jar plantuml.jar -p  > graph.png

# выделить 'place1' и 'place2' в сброшенном рабочем процессе
$ php bin/console workflow:dump workflow-name place1 place2 | dot -Tsvg -o graph.svg

# используя Mermaid.js CLI
$ php bin/console workflow:dump workflow_name --dump-format=mermaid | mmdc -o graph.svg
    

Изображение DOT будет выглядеть так:

Диаграмма состояний рабочего процесса Symfony, созданная DOT.

Изображение Mermaid будет выглядеть так:

Диаграмма состояний рабочего процесса Symfony, созданная Mermaid.

Изображение PlantUML будет выглядеть так:

Диаграмма состояний рабочего процесса Symfony, созданная PlantUML.

Если вы создаете рабочие процессы вне приложения Symfony, используйте класс GraphvizDumper` илиStateMachineGraphvizDumper для создания файлов DOT и PlantUmlDumper`` для создания файлов PlantUML:

        1
2
3
4
5
6
7
        // Добавить этот код к скрипту PHP; например: dump-graph.php
$dumper = new GraphvizDumper();
echo $dumper->dump($definition);

# если вы предпочитаете PlantUML, использовать этот код:
# $dumper = new PlantUmlDumper();
# echo $dumper->dump($definition);
    

        1
2
3
        # заменить 'dump-graph.php' именем вашего скрипта PHP
$ php dump-graph.php | dot -Tsvg -o graph.svg
$ php dump-graph.php | java -jar plantuml.jar -p  > graph.png
    

Стили

Вы можете использовать опцию --with-metadata в команде workflow:dump, чтобы включить места, переходы и
метаданные рабочего процесса.

Изображение DOT будет выглядеть следующим образом :

Note

Опция --with-metadata работает только для дампера DOT на данный момент.

Note

Метаданные label не включены в сброшенные метаданные, так как они используются в качестве заголовка места.

Вы можете использовать metadata со следующими ключами для стилизации рабочего процесса:

для мест:
- bg_color: цвет;
- description: строка, описывающая состояние.
для переходов:
- label: строка, заменяющая имя перехода;
- color: цвет;
- arrow_color: цвет.

Строки могут содержать символы \n для отображения содержания в нескольких строках.
Цвета могут быть определены как:

имя цвета из списка цветов PlantUML;
шестнадцатеричный цвет (поддерживаются форматы #AABBCC и #ABC).

Note

Дампер Mermaid не поддерживает раскраску головок стрелок
с помощью arrow_color, так как в Mermaid нет поддержки для этого.

Ниже приведена конфигурация для машины состояний запроса на включение с добавлением стилизации.

        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
    

        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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
        <!-- config/packages/workflow.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
>

    <framework:config>
        <framework:workflow name="pull_request" type="state_machine">
            <framework:marking-store>
                <framework:type>method</framework:type>
                <framework:property>currentPlace</framework:property>
            </framework:marking-store>

            <framework:support>App\Entity\PullRequest</framework:support>

            <framework:initial_marking>start</framework:initial_marking>

            <framework:place>start</framework:place>
            <framework:place>coding</framework:place>
            <framework:place>test</framework:place>
            <framework:place name="review">
                <framework:metadata>
                    <framework:description>Human review</framework:description>
                </framework:metadata>
            </framework:place>
            <framework:place>merged</framework:place>
            <framework:place name="closed">
                <framework:metadata>
                    <framework:bg_color>DeepSkyBlue</framework:bg_color>
                </framework:metadata>
            </framework:place>

            <framework:transition name="submit">
                <framework:from>start</framework:from>

                <framework:to>test</framework:to>
            </framework:transition>

            <framework:transition name="update">
                <framework:from>coding</framework:from>
                <framework:from>test</framework:from>
                <framework:from>review</framework:from>

                <framework:to>test</framework:to>

                <framework:metadata>
                    <framework:arrow_color>Turquoise</framework:arrow_color>
                </framework:metadata>
            </framework:transition>

            <framework:transition name="wait_for_review">
                <framework:from>test</framework:from>

                <framework:to>review</framework:to>

                <framework:metadata>
                    <framework:color>Orange</framework:color>
                </framework:metadata>
            </framework:transition>

            <framework:transition name="request_change">
                <framework:from>review</framework:from>

                <framework:to>coding</framework:to>
            </framework:transition>

            <framework:transition name="accept">
                <framework:from>review</framework:from>

                <framework:to>merged</framework:to>

                <framework:metadata>
                    <framework:label>Accept PR</framework:label>
                </framework:metadata>
            </framework:transition>

            <framework:transition name="reject">
                <framework:from>review</framework:from>

                <framework:to>closed</framework:to>
            </framework:transition>

            <framework:transition name="reopen">
                <framework:from>closed</framework:from>

                <framework:to>review</framework:to>
            </framework:transition>

        </framework:workflow>

    </framework:config>
</container>
    

        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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
        // config/packages/workflow.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework): void {
    // ...
    $pullRequest = $framework->workflows()->workflows('pull_request');

    $pullRequest
        ->type('state_machine')
        ->supports(['App\Entity\PullRequest'])
        ->initialMarking(['start']);

    $pullRequest->markingStore()
        ->type('method')
        ->property('currentPlace');

    $pullRequest->place()->name('start');
    $pullRequest->place()->name('coding');
    $pullRequest->place()->name('test');
    $pullRequest->place()
        ->name('review')
        ->metadata(['description' => 'Human review']);
    $pullRequest->place()->name('merged');
    $pullRequest->place()
        ->name('closed')
        ->metadata(['bg_color' => 'DeepSkyBlue',]);

    $pullRequest->transition()
        ->name('submit')
            ->from(['start'])
            ->to(['test']);

    $pullRequest->transition()
        ->name('update')
            ->from(['coding', 'test', 'review'])
            ->to(['test'])
            ->metadata(['arrow_color' => 'Turquoise']);

    $pullRequest->transition()
        ->name('wait_for_review')
            ->from(['test'])
            ->to(['review'])
            ->metadata(['color' => 'Orange']);

    $pullRequest->transition()
        ->name('request_change')
            ->from(['review'])
            ->to(['coding']);

    $pullRequest->transition()
        ->name('accept')
            ->from(['review'])
            ->to(['merged'])
            ->metadata(['label' => 'Accept PR']);

    $pullRequest->transition()
        ->name('reject')
            ->from(['review'])
            ->to(['closed']);

    $pullRequest->transition()
        ->name('accept')
            ->from(['closed'])
            ->to(['review']);
};
    

Изображение PlantUML будет выглядеть так:

Диаграмма состояний, созданная в PlantUML, с пользовательскими цветами и описаниями переходов.