Установка

У додатках, що використовують Symfony Flex , виконайте цю команду, щоб встановити функцію робочого процесу, перед її використанням:

1

$ composer require symfony/workflow

Конфігурація

Щоб побачити всі опції конфігурації, якщо ви використовуєте компонент всередині проекту Symfony, виконайте цю команду:

1

$ php bin/console config:dump-reference framework workflows

Створення Workflow

Workflow - це процес або життєвий цикл, який проходять ваші обʼєкти. Кожний крок або етап процесу називається місцем. Ви також визначаєте переходи, які описують дію, щоб переміститися з одного місця в інше.

Набір місць та переходів створює визначення. Робочому процесу необхідно Definition і спосіб записувати стани в обʼєкти (тобто, екземпляр MarkingStoreInterface.)

Розгляньте наступний приклад для посту блогу. Пост може мати такі місця: draft, reviewed, rejected, published. Ви можете визначити робочий процес таким чином:

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

# config/packages/workflow.yaml
framework:
    workflows:
        blog_publishing:
            type: 'workflow' # або 'state_machine'
            audit_trail:
                enabled: true
            marking_store:
                type: 'method'
                property: 'currentPlace'
            supports:
                - App\Entity\BlogPost
            initial_marking: draft
            places:
                - draft
                - reviewed
                - rejected
                - published
            transitions:
                to_review:
                    from: draft
                    to:   reviewed
                publish:
                    from: reviewed
                    to:   published
                reject:
                    from: reviewed
                    to:   rejected

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

<!-- 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>
        <!-- або type="state_machine" -->
        <framework:workflow name="blog_publishing" type="workflow">
            <framework:audit-trail enabled="true"/>
            <framework:marking-store type="single_state">
                <framework:argument>currentPlace</framework:argument>
            </framework:marking-store>
            <framework:support>App\Entity\BlogPost</framework:support>
            <framework:initial-marking>draft</framework:initial-marking>
            <framework:place>draft</framework:place>
            <framework:place>reviewed</framework:place>
            <framework:place>rejected</framework:place>
            <framework:place>published</framework:place>
            <framework:transition name="to_review">
                <framework:from>draft</framework:from>
                <framework:to>reviewed</framework:to>
            </framework:transition>
            <framework:transition name="publish">
                <framework:from>reviewed</framework:from>
                <framework:to>published</framework:to>
            </framework:transition>
            <framework:transition name="reject">
                <framework:from>reviewed</framework:from>
                <framework:to>rejected</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

// config/packages/workflow.php
use App\Entity\BlogPost;
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $blogPublishing = $framework->workflows()->workflows('blog_publishing');
    $blogPublishing
        ->type('workflow') // або 'state_machine'
        ->supports([BlogPost::class])
        ->initialMarking(['draft']);

    $blogPublishing->auditTrail()->enabled(true);
    $blogPublishing->markingStore()
        ->type('method')
        ->property('currentPlace');

    $blogPublishing->place()->name('draft');
    $blogPublishing->place()->name('reviewed');
    $blogPublishing->place()->name('rejected');
    $blogPublishing->place()->name('published');

    $blogPublishing->transition()
        ->name('to_review')
            ->from(['draft'])
            ->to(['reviewed']);

    $blogPublishing->transition()
        ->name('publish')
            ->from(['reviewed'])
            ->to(['published']);

    $blogPublishing->transition()
        ->name('reject')
            ->from(['reviewed'])
            ->to(['rejected']);
};

Сконфігурована властивість буде використана через її реалізовані методи гетера/сетера сховищем маркування:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

// src/Entity/BlogPost.php
namespace App\Entity;

class BlogPost
{
    // сконфігурована властивіть сховища маркування має бути оголошена
    private $currentPlace;
    private $title;
    private $content;

    // методи гетера/сетера повинні існувати для того, щоб властивість була доступна сховищу маркування
    public function getCurrentPlace()
    {
        return $this->currentPlace;
    }

    public function setCurrentPlace($currentPlace, $context = [])
    {
        $this->currentPlace = $currentPlace;
    }
}

З цим робочим процесом під назвою blog_publishing, ви можете отримати допомогу, щоб вирішити, які дії будуть дозволені у пості блогу:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

use App\Entity\BlogPost;
use Symfony\Component\Workflow\Exception\LogicException;

$post = new BlogPost();

$workflow = $this->container->get('workflow.blog_publishing');
$workflow->can($post, 'publish'); // False
$workflow->can($post, 'to_review'); // True

// Оновити currentState посту
try {
    $workflow->apply($post, 'to_review');
} catch (LogicException $exception) {
    // ...
}

// Побачити всі доступні переходи для посту у поточному стані
$transitions = $workflow->getEnabledTransitions($post);
// Побачити конкретний доступний перехід для посту у поточному стані
$transition = $workflow->getEnabledTransition($post, 'publish');

Доступ до Workflow у класі

Ви можете використовувати робочий процес всередині класу, використовуючи автомонтування сервісів і camelCased workflow name + Workflow в якості імені параметра. Якщо це тип машини станів, використовуйте camelCased workflow name + StateMachine:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

use App\Entity\BlogPost;
use Symfony\Component\Workflow\WorkflowInterface;

class MyClass
{
    private $blogPublishingWorkflow;

    // Symfony впровадить робочий процес 'blog_publishing', сконфігурований раніше
    public function __construct(WorkflowInterface $blogPublishingWorkflow)
    {
        $this->blogPublishingWorkflow = $blogPublishingWorkflow;
    }

    public function toReview(BlogPost $post)
    {
        // Оновити currentState посту
        try {
            $this->blogPublishingWorkflow->apply($post, 'to_review');
        } catch (LogicException $exception) {
            // ...
        }
        // ...
    }
}

Використання подій

Щоб зробити ваші робочі процеси гнучкішими, ви можете створити обʼєкт Workflow з EventDispatcher. Тепер ви можете створювати слухачів подій для блокування переходів (тобто, в залежності від даних у пості блогу) і робити додаткові дії, коли відбувається операція робочого процессу (наприклад, відправляти повідомлення).

Кожний крок має три події, які запукаються по порядку:

• Подія для всіх робочих процесів;
• Подія для задіяного робочого процесу;
• Подія для задіяного робочого процесу з конкретним переходом або іменем місця.

Коли ініціюється перехід стану, події запускаються в наступному порядку:

workflow.guard

Валідує, чи блокується перехід (див. події-охоронці і блокування переходів ).

Три події, що запускаються:

• workflow.guard
• workflow.[workflow name].guard
• workflow.[workflow name].guard.[transition name]

workflow.leave

Субʼєкт ось-ось покине місце.

Три події, що запускаються:

• workflow.leave
• workflow.[workflow name].leave
• workflow.[workflow name].leave.[place name]

workflow.transition

Субʼєкт проходить перехід.

Три події, що запускаються:

• workflow.transition
• workflow.[workflow name].transition
• workflow.[workflow name].transition.[transition name]

workflow.enter

Субʼєкт ось-ось зайде у нове місце. Ця подія запускається прямо перед тим як оновклюються місця субʼєкта, що означає, що маркування субʼєкта ще не оновлене відповідно до нових місць.

Три події, що запускаються:

• workflow.enter
• workflow.[workflow name].enter
• workflow.[workflow name].enter.[place name]

workflow.entered

Субʼєкт увійшов у місця та маркування оновилося.

Три події, що запускаються:

• workflow.entered
• workflow.[workflow name].entered
• workflow.[workflow name].entered.[place name]

workflow.completed

Обʼєкт виконав цей перехід.

Три події, що запускаються:

• workflow.completed
• workflow.[workflow name].completed
• workflow.[workflow name].completed.[transition name]

workflow.announce

Запускається для кожного переходу, який тепер доступний субʼєкту.

Три події, що запускаються:

• workflow.announce
• workflow.[workflow name].announce
• workflow.[workflow name].announce.[transition name]

Після застосування переходу, оголошення події тестує всі доступні переходи. Це ще раз викличе всі події-охоронці , що може вплинути на продуктивність, якщо вони містять інтенсивну CPU або навантаження бази даних.

Якщо вам не потрібно оголошувати подію, відключіть її, використовуючи контекст:

1

$workflow->apply($subject, $transitionName, [Workflow::DISABLE_ANNOUNCE_EVENT => true]);

Контекст доступний у всіх подіях, окрім подій workflow.guard:

1
2
3
4
5
6

// $context має бути масивом
$context = ['context_key' => 'context_value'];
$workflow->apply($subject, $transitionName, $context);

// у слухачі подій (події workflow.guard)
$context = $event->getContext(); // повертає ['context']

Ось приклад того, як включити логування для кожного разу, коли робочий процес "blog_publishing" йде з місця:

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

// src/App/EventSubscriber/WorkflowLoggerSubscriber.php
namespace App\EventSubscriber;

use Psr\Log\LoggerInterface;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\Workflow\Event\Event;

class WorkflowLoggerSubscriber implements EventSubscriberInterface
{
    private $logger;

    public function __construct(LoggerInterface $logger)
    {
        $this->logger = $logger;
    }

    public function onLeave(Event $event)
    {
        $this->logger->alert(sprintf(
            'Blog post (id: "%s") performed transition "%s" from "%s" to "%s"',
            $event->getSubject()->getId(),
            $event->getTransition()->getName(),
            implode(', ', array_keys($event->getMarking()->getPlaces())),
            implode(', ', $event->getTransition()->getTos())
        ));
    }

    public static function getSubscribedEvents()
    {
        return [
            'workflow.blog_publishing.leave' => 'onLeave',
        ];
    }
}

Якщо деякі слухачі оновлюють контекст під час переходу, ви можете вилучити його через маркування:

1
2
3
4

$marking = $workflow->apply($post, 'to_review');

// містить нове значення
$marking->getContext();

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

// src/App/EventSubscriber/BlogPostReviewSubscriber.php
namespace App\EventSubscriber;

use App\Entity\BlogPost;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\Workflow\Event\GuardEvent;

class BlogPostReviewSubscriber implements EventSubscriberInterface
{
    public function guardReview(GuardEvent $event)
    {
        /** @var BlogPost $post */
        $post = $event->getSubject();
        $title = $post->title;

        if (empty($title)) {
            $event->setBlocked(true, 'This blog post cannot be marked as reviewed because it has no title.');
        }
    }

    public static function getSubscribedEvents()
    {
        return [
            'workflow.blog_publishing.guard.to_review' => ['guardReview'],
        ];
    }
}

1
2
3
4
5
6
7
8
9
10
11

# config/packages/workflow.yaml
framework:
    workflows:
        blog_publishing:
            # ви можете передати одне або більше імен подій
            events_to_dispatch: ['workflow.leave', 'workflow.completed']

            # передати пустий масив, щоб не запускати ніяких подій
            events_to_dispatch: []

            # ...

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<!-- 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="blog_publishing">
            <!-- ви можете передати одне або більше імен подій -->
            <framework:event-to-dispatch>workflow.leave</framework:event-to-dispatch>
            <framework:event-to-dispatch>workflow.completed</framework:event-to-dispatch>

            <!-- передати пустий масив, щоб не запускати ніяких подій -->
            <framework:event-to-dispatch></framework:event-to-dispatch>

            <!-- ... -->
        </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

// config/packages/workflow.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    // ...

    $blogPublishing = $framework->workflows()->workflows('blog_publishing');

    // ...
    // ви можете передати одне або більше імен подій
    $blogPublishing->eventsToDispatch([
        'workflow.leave',
        'workflow.completed',
    ]);

    // передати пустий масив, щоб не запускати ніяких подій
    $blogPublishing->eventsToDispatch([]);

    // ...
};

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

use App\Entity\BlogPost;
use Symfony\Component\Workflow\Exception\LogicException;

$post = new BlogPost();

$workflow = $this->container->get('workflow.blog_publishing');

try {
    $workflow->apply($post, 'to_review', [
        Workflow::DISABLE_ANNOUNCE_EVENT => true,
        Workflow::DISABLE_LEAVE_EVENT => true,
    ]);
} catch (LogicException $exception) {
    // ...
}

Блокування переходів

Виконання робочого процесу можна контролювати, викликаючи користувацьку логіку щоб вирішити, чи блокувати поточний перехід перед його застосуванням. Ця функція надана "охоронцями", що може бути використана двома способами.

По-перше, ви можете слухати події-охоронці . Як варіант, ви можете визначити опцію конфігурації guard для переходу. Значення цієї опції - будь-який валідний вираз, створений за допомогою компонента ExpressionLanguage:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

# config/packages/workflow.yaml
framework:
    workflows:
        blog_publishing:
            # попередня конфігурація
            transitions:
                to_review:
                    # перехід дозволено лише якщо поточний користувач має роль ROLE_REVIEWER.
                    guard: "is_granted('ROLE_REVIEWER')"
                    from: draft
                    to:   reviewed
                publish:
                    # або "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted", "is_valid"
                    guard: "is_authenticated"
                    from: reviewed
                    to:   published
                reject:
                    # або будь-яку валідну мову виразу з "субʼєктом", що посилається на підтримуваний обʼєкт
                    guard: "is_granted('ROLE_ADMIN') and subject.isRejectable()"
                    from: reviewed
                    to:   rejected

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

<!-- 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="blog_publishing" type="workflow">

            <!-- ... попередня конфігурація -->

            <framework:transition name="to_review">
                <!-- перехід дозволено лише якщо поточний користувач має роль ROLE_REVIEWER. -->
                <framework:guard>is_granted("ROLE_REVIEWER")</framework:guard>
                <framework:from>draft</framework:from>
                <framework:to>reviewed</framework:to>
            </framework:transition>

            <framework:transition name="publish">
                <!-- або "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted" -->
                <framework:guard>is_authenticated</framework:guard>
                <framework:from>reviewed</framework:from>
                <framework:to>published</framework:to>
            </framework:transition>

            <framework:transition name="reject">
                <!-- або будь-яку валідну мову виразу з "субʼєктом", що посилається на підтримуваний обʼєкт -->
                <framework:guard>is_granted("ROLE_ADMIN") and subject.isStatusReviewed()</framework:guard>
                <framework:from>reviewed</framework:from>
                <framework:to>rejected</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

// config/packages/workflow.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $blogPublishing = $framework->workflows()->workflows('blog_publishing');
    // ... попередня конфігурація

    $blogPublishing->transition()
        ->name('to_review')
            // перехід дозволено лише якщо поточний користувач має роль ROLE_REVIEWER.
            ->guard('is_granted("ROLE_REVIEWER")')
            ->from(['draft'])
            ->to(['reviewed']);

    $blogPublishing->transition()
        ->name('publish')
            // або "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted"
            ->guard('is_authenticated')
            ->from(['reviewed'])
            ->to(['published']);

    $blogPublishing->transition()
        ->name('reject')
            // або будь-яку валідну мову виразу з "субʼєктом", що посилається на підтримуваний обʼєкт
            ->guard('is_granted("ROLE_ADMIN") and subject.isStatusReviewed()')
            ->from(['reviewed'])
            ->to(['rejected']);
};

Ви також можете використовувати блокувальники переходів для блокування та повернення дружнього повідомлення про помилку, коли ви запобігаєте переходу. У прикладі ми отримуємо це повідомлення з метаданих Event, який дає вам повний контроль управління текстом.

Цей приклад було спрощено; у виробництві вам краще використати компонент Translation, щоб управляти повідомленнями в одному місці:

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

// src/App/EventSubscriber/BlogPostPublishSubscriber.php
namespace App\EventSubscriber;

use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\Workflow\Event\GuardEvent;
use Symfony\Component\Workflow\TransitionBlocker;

class BlogPostPublishSubscriber implements EventSubscriberInterface
{
    public function guardPublish(GuardEvent $event)
    {
        $eventTransition = $event->getTransition();
        $hourLimit = $event->getMetadata('hour_limit', $eventTransition);

        if (date('H') <= $hourLimit) {
            return;
        }

        // Заблоувати перехід "publish", якщо вже пізніше 8ої вечора
        // з повідомленням для кінцевого користувача
        $explanation = $event->getMetadata('explanation', $eventTransition);
        $event->addTransitionBlocker(new TransitionBlocker($explanation , '0'));
    }

    public static function getSubscribedEvents()
    {
        return [
            'workflow.blog_publishing.guard.publish' => ['guardPublish'],
        ];
    }
}

Застосування в Twig

Symfony визначає декілька функцій Twig для управління робочими процесами та зменшення потреби у логіці домену у вашому шаблоні:

workflow_can()

Повертає true, якщо заданий обʼєкт може пройти заданий перехід.

workflow_transitions()

Повертає масив з усіма переходами, включеними для заданого обʼєкта.

workflow_transition()

Повертає конкретний перехід, включений для заданого обʼєкта, та імʼя переходу.

workflow_marked_places()

Повертає масив з іменами місць заданого маркування.

workflow_has_marked_place()

Повертає true, якщо маркування заданого обʼєкта має заданий стан.

workflow_transition_blockers()

Повертає TransitionBlockerList для заданого переходу.

Наступний приклад демонструє ці функції в дії:

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

<h3>Actions on Blog Post</h3>
{% if workflow_can(post, 'publish') %}
    <a href="...">Publish</a>
{% endif %}
{% if workflow_can(post, 'to_review') %}
    <a href="...">Submit to review</a>
{% endif %}
{% if workflow_can(post, 'reject') %}
    <a href="...">Reject</a>
{% endif %}

{# Або закільцювати включені переходи #}
{% for transition in workflow_transitions(post) %}
    <a href="...">{{ transition.name }}</a>
{% else %}
    Дії недоступні.
{% endfor %}

{# Перевірити, чи знаходиться обʼєкт в якомусь конкретному місці #}
{% if workflow_has_marked_place(post, 'reviewed') %}
    <p>This post is ready for review.</p>
{% endif %}

{# Перевірити, чи було якесь місце марковано в обʼєкті #}
{% if 'reviewed' in workflow_marked_places(post) %}
    <span class="label">Reviewed</span>
{% endif %}

{# Закільцювати блокувальники переходів #}
{% for blocker in workflow_transition_blockers(post, 'publish') %}
    <span class="error">{{ blocker.message }}</span>
{% endfor %}

Зберігання метаданих

Якщо вам потрібно, ви можете зберігати довільні метадані у робочих процесах їх місцях та переходах, використовуючи опцію metadata. Ці метадані можуть бути просто заголовком робочого процесу або дуже складними обʼєктами:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# config/packages/workflow.yaml
framework:
    workflows:
        blog_publishing:
            metadata:
                title: 'Робочий процес публікації блогу'
            # ...
            places:
                draft:
                    metadata:
                        max_num_of_words: 500
                # ...
            transitions:
                to_review:
                    from: draft
                    to:   review
                    metadata:
                        priority: 0.5
                publish:
                    from: reviewed
                    to:   published
                    metadata:
                        hour_limit: 20
                        explanation: 'Ви не можете публікувати після 8ої вечора.'

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

<!-- 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="blog_publishing">
            <framework:metadata>
                <framework:title>Робочий процес публікації блогу</framework:title>
            </framework:metadata>
            <!-- ... -->
            <framework:place name="draft">
                <framework:metadata>
                    <framework:max-num-of-words>500</framework:max-num-of-words>
                </framework:metadata>
            </framework:place>
            <!-- ... -->
            <framework:transition name="to_review">
                <framework:from>draft</framework:from>
                <framework:to>review</framework:to>
                <framework:metadata>
                    <framework:priority>0.5</framework:priority>
                </framework:metadata>
            </framework:transition>
            <framework:transition name="publish">
                <framework:from>reviewed</framework:from>
                <framework:to>published</framework:to>
                <framework:metadata>
                    <framework:hour_limit>20</framework:hour_limit>
                    <framework:explanation>Ви не можете публікувати після 8ої вечора.</framework:explanation>
                </framework:metadata>
            </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

// config/packages/workflow.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $blogPublishing = $framework->workflows()->workflows('blog_publishing');
    // ... предыдущая конфигурация

    $blogPublishing->metadata([
        'title' => 'Робочий процес публікації блогу'
    ]);

    // ...

    $blogPublishing->place()
        ->name('draft')
        ->metadata([
            'max_num_of_words' => 500,
        ]);

    // ...

    $blogPublishing->transition()
        ->name('to_review')
            ->from(['draft'])
            ->to(['reviewed'])
            ->metadata([
                'priority' => 0.5,
            ]);

    $blogPublishing->transition()
        ->name('publish')
            ->from(['reviewed'])
            ->to(['published'])
            ->metadata([
                'hour_limit' => 20,
                'explanation' => 'Ви не можете публікувати після 8ої вечора.',
            ]);
};

Потім ви можете отримати доступ до цих матадних у вашому контролері наступним чином:

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

// src/App/Controller/BlogPostController.php
use App\Entity\BlogPost;
use Symfony\Component\Workflow\WorkflowInterface;
// ...

public function myAction(WorkflowInterface $blogPublishingWorkflow, BlogPost $post)
{
    $title = $blogPublishingWorkflow
        ->getMetadataStore()
        ->getWorkflowMetadata()['title'] ?? 'Default title'
    ;

    $maxNumOfWords = $blogPublishingWorkflow
        ->getMetadataStore()
        ->getPlaceMetadata('draft')['max_num_of_words'] ?? 500
    ;

    $aTransition = $blogPublishingWorkflow->getDefinition()->getTransitions()[0];
    $priority = $blogPublishingWorkflow
        ->getMetadataStore()
        ->getTransitionMetadata($aTransition)['priority'] ?? 0
    ;

    // ...
}

Існує метод getMetadata(), який працює з усіма видами метаданих:

1
2
3
4
5
6
7
8

// отримати "workflow metadata", передаючи ключ з метаданих як аргумент
$title = $workflow->getMetadataStore()->getMetadata('title');

// отримати "place metadata", передаючи ключ метаданих як перший аргумент, а імʼя місця - як другий
$maxNumOfWords = $workflow->getMetadataStore()->getMetadata('max_num_of_words', 'draft');

// отримати "transition metadata", передаючи ключ метаданих як перший аргумент, а обʼєкт Переходу - як другий
$priority = $workflow->getMetadataStore()->getMetadata('priority', $aTransition);

У флеш-повідомленні у вашому контролері:

1
2
3
4
5

// $transition = ...; (an instance of Transition)

// $workflow - це екземпляр Робочого процесу, вилучений з Реєстру або впроваджений напряму (див. выще)
$title = $workflow->getMetadataStore()->getMetadata('title', $transition);
$this->addFlash('info', "Ви успішно застосувалли перехід з заголовком: '$title'");

Доступ до метаданих також можна отримати у слухачі з обʼєкта Event.

У шаблонах Twig метадані доступні через функцію workflow_metadata():

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

<h2>Metadata of Blog Post</h2>
<p>
    <strong>Workflow</strong>:<br>
    <code>{{ workflow_metadata(blog_post, 'title') }}</code>
</p>
<p>
    <strong>Current place(s)</strong>
    <ul>
        {% for place in workflow_marked_places(blog_post) %}
            <li>
                {{ place }}:
                <code>{{ workflow_metadata(blog_post, 'max_num_of_words', place) ?: 'Unlimited'}}</code>
            </li>
        {% endfor %}
    </ul>
</p>
<p>
    <strong>Enabled transition(s)</strong>
    <ul>
        {% for transition in workflow_transitions(blog_post) %}
            <li>
                {{ transition.name }}:
                <code>{{ workflow_metadata(blog_post, 'priority', transition) ?: 0 }}</code>
            </li>
        {% endfor %}
    </ul>
</p>
<p>
    <strong>to_review Priority</strong>
    <ul>
        <li>
            to_review:
            <code>{{ workflow_metadata(blog_post, 'priority', workflow_transition(blog_post, 'to_review')) }}</code>
        </li>
    </ul>
</p>

Дійзнайтеся більше