Описание процесса по схеме BPMN: текст для постановки

Как получить текстовое описание процесса из BPMN: нумерованные шаги, исполнители по дорожкам, ветвления с условиями, подпроцессы и обмен сообщениями — в Markdown.

Схема процесса хороша для обсуждения, но в постановке, регламенте или тест-кейсах нужен текст. Его можно получить из схемы BPMN автоматически и доработать.

Как получить описание

Откройте процесс в редакторе BPMN.
Выберите Файл → Преобразовать в → Markdown — описание процесса.
Сохраните результат в проект рядом со схемой или откройте в редакторе Markdown.

Описание процесса в Markdown, полученное из BPMN — Шаги процесса с исполнителями и ветвлениями

Что попадает в описание

Участники — пулы collaboration; внешние участники помечены.
Исполнители — дорожки (вложенные — «Отдел / Роль»).
Шаги — нумерованный список в порядке обхода от начального события: название, тип (задача пользователя, сервисная задача, ожидание события…), исполнитель.
Ветвления: у шлюза перечислены пути с условиями (подпись потока или выражение условия) и ссылками на шаги; путь по умолчанию отмечен.
Граничные события — сразу после задачи, к которой прикреплены.
Подпроцессы — вложенным списком шагов.
Документация элементов — текстом под шагом.
Обмен сообщениями между пулами — отдельным разделом.

Как сделать описание лучше

Подписывайте потоки из шлюзов («Да», «Сумма больше 100 000») — без подписей условия в тексте будут пустыми.
Заполняйте документацию задач — она станет готовым текстом шага.
Элементы, до которых нельзя дойти от начального события, окно перечислит в замечаниях — это частый признак ошибки в схеме.

Описание из Markdown можно сразу отдать в Word — «Markdown в Word».

Пример результата

# Обработка заказа

## Шаги процесса

1. **Заказ получен** — начало
2. **Проверить оплату** — задача пользователя
3. **Оплачен?** — выбор одного пути
   - Да → шаг 4 («Собрать и отправить заказ»)
   - Нет → шаг 5 («Уведомить клиента»)
4. **Собрать и отправить заказ** — сервисная задача
   - далее шаг 6 («Заказ отправлен»)
5. **Уведомить клиента** — отправка сообщения
   - далее шаг 7 («Заказ отменён»)
6. **Заказ отправлен** — завершение
7. **Заказ отменён** — завершение

Вопросы и ответы

Описание связано со схемой — обновится ли оно само? Нет, это отдельный документ. После изменения схемы преобразуйте её заново — новый результат можно сохранить поверх с новой версией.

Можно ли получить тест-кейсы? Нумерованные шаги с ветвлениями — хорошая основа: каждый путь от начала до конечного события — отдельный сценарий проверки.