Быстрый старт

В этом руководстве вы пройдёте весь путь: от установки до моделирования процесса.

Начнём знакомство с OpenBPM на примере демонстрационный процесс «Заявка на командировку».

Предварительные требования

Перед началом убедитесь, что у вас установлены необходимые инструменты (подробные инструкции — в отдельных разделах):

OpenBPM Studio — среда для моделирования BPMN-диаграмм и форм.
OpenBPM Control — веб-интерфейс для мониторинга и администрирования процессов.

Демонстрационный процесс

Мы смоделируем процесс подачи командировочной заявки, состоящий из трёх элементов:

Start Event со стартовой формой (Camunda Form) — сотрудник вводит данные.
Service Task (JavaDelegate) — эмуляция уведомления бухгалтерии (логирование данных).
End Event — завершение процесса.

Демонстрационный процесс

Шаг 1. Создание диаграммы в OpenBPM Studio

Для начала создадим простое Spring Boot приложение с помощью плагина OpenBPM Studio.

Инструкцию по установке OpenBPM Studio можно найти по ссылке.

Запустите Studio и создайте новое приложение со встроенным BPM-движком.

Сейчас можно выбрать движок Camunda или Operaton. В будущих релизах появится и OpenBPM Engine.
В OpenBPM Explorer выберите: Processes → New → Blank diagram.
Укажите параметры:
- Process ID: business-trip-process
- Process name: Business trip process
На диаграмме разместите элементы: Start Event → Service Task → End Event и соедините их.
Настройте Service Task и сгенерируйте новый класс через иконку «+» в поле Class:
- Name: Notify the accounting department
- Task type: Java Class
  
  Введите имя NotifyJavaDelegate для нового класса:

Добавьте следующую реализацию в NotifyJavaDelegate:

package com.example.workflow.delegate;

import org.camunda.bpm.engine.delegate.DelegateExecution;
import org.camunda.bpm.engine.delegate.JavaDelegate;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class NotifyJavaDelegate implements JavaDelegate {

    private static final Logger log = LoggerFactory.getLogger(NotifyJavaDelegate.class);

    @Override
    public void execute(DelegateExecution execution) {
        String employee = (String) execution.getVariable("employeeName");
        String destination = (String) execution.getVariable("destination");
        String startDate = (String) execution.getVariable("startDate");
        String endDate = (String) execution.getVariable("endDate");
        String purpose = (String) execution.getVariable("purpose");

        log.info("Business trip request: {} → {} ({} — {}). Purpose: {}",
                 employee, destination, startDate, endDate, purpose);
    }
}

NotifyJavaDelegate эмулирует интеграцию с внешним сервисом бухгалтерского учёта.

Шаг 2. Создание стартовой формы

Теперь создадим пользовательскую форму для заявки на командировку.

В OpenBPM Explorer выберите: Forms → New → Blank form.
В диалоге создания формы заполните поле:
- Form ID: start-form.

С помощью визуального редактора добавьте поля:

Имя	Ключ	Тип	Обязательное?
Name	employeeName	TextField	Да
Destination	destination	TextField	Да
Start date	startDate	Date	Да
End date	endDate	Date	Да
Purpose	purpose	TextArea	Да

Имя

Ключ

Тип

Обязательное?

Name

employeeName

TextField

Да

Destination

destination

TextField

Да

Start date

startDate

Date

Да

End date

endDate

Date

Да

Purpose

purpose

TextArea

Да

Конструктор формы

Привяжите форму к Start Event:
- Form type: Camunda form
- Form reference: start-form.form [start-form]

Ваш процесс готов!

Шаг 3. Запуск и проверка

Запустите ваше Spring Boot приложение.
Откройте Camunda Tasklist по адресу: http://localhost:8080

Данные для входа указаны в application.properties. По умолчанию: admin/admin.

Введите логин и пароль.
Перейдите в Tasklist и запустите ваш процесс:

Нажмите кнопку Start.

После выполнения процесса в логах появится сообщение с введёнными данными.

Шаг 4. Мониторинг в OpenBPM Control

Выполнение процесса можно просмотреть через OpenBPM Control. Для этого запустите Control и подключите его к вашему приложению.

Инструкция по установке OpenBPM Control: ссылка.

Авторизуйтесь в приложении:
- Логин: admin
- Пароль: admin
На главном экране нажмите Add и заполните поля:
- Name: Camunda
- Base URL: http://localhost:8080/engine-rest
- Authentication: false
  
  Если OpenBPM Control запущен в контейнере Docker, укажите: http://host.docker.internal:8080/engine-rest
  
  Проверьте соединение кнопкой Test connection.
Перейдите в Process Instances → Completed, выберите свой процесс и нажмите View.
Убедитесь, что выполнение прошло через Service Task. В случае успеха диаграмма процесса подсветится зелёным.

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