Миграция на OpenBPM Engine

Перед началом миграции на OpenBPM Engine обязательно обновите ваш проект на Camunda 7 до последней доступной версии. Это позволит избежать проблем совместимости и сделать переход максимально бесшовным.

Подробнее об обновлении Camunda 7 см. в официальной документации: https://docs.camunda.org/manual/latest/update/

Этот документ описывает минимальные шаги для переноса приложения с Camunda 7 на OpenBPM Engine. Процесс включает замену зависимостей, обновление конфигурации, корректировку Java-импортов.

  1. Замена зависимостей

    Артефакты OpenBPM Engine публикуются в собственном Nexus-репозитории.

    Maven

    В pom.xml добавьте новый репозиторий:

    <repositories>
  <repository>
    <id>openbpm-releases</id>
    <url>https://nexus.openbpm.ru/repository/releases/</url>
  </repository>
</repositories>

    Gradle

    В build.gradle добавьте репозиторий:

    repositories {
    maven {
        url "https://nexus.openbpm.ru/repository/releases/"
    }
}

    Замените все зависимости с io.openbpm.bpm.* на io.openbpm.bpm.*.

    Пример (Maven)

    <dependency>
  <groupId>io.openbpm.bpm.springboot</groupId>
  <artifactId>openbpm-engine-bpm-spring-boot-starter</artifactId>
  <version>2025.0.0</version>
</dependency>

<dependency>
  <groupId>io.openbpm.bpm.springboot</groupId>
  <artifactId>openbpm-engine-bpm-spring-boot-starter-rest</artifactId>
  <version>2025.0.0</version>
</dependency>

<dependency>
  <groupId>io.openbpm.bpm.springboot</groupId>
  <artifactId>openbpm-engine-bpm-spring-boot-starter-webapp</artifactId>
  <version>2025.0.0</version>
</dependency>

    Пример (Gradle)

    implementation 'io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter:2025.0.0'
implementation 'io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter-rest:2025.0.0'
implementation 'io.openbpm.bpm.springboot:openbpm-engine-bpm-spring-boot-starter-webapp:2025.0.0'

    Перед запуском убедитесь, что старые camunda-зависимости удалены, иначе возможны конфликты класслоадера.

  2. Замена настроек в application.properties

    Вместо префикса openbpm.bpm.* теперь используется openbpm.bpm.*.

    Было (Camunda 7):

    openbpm.bpm.admin-user.id=demo
openbpm.bpm.admin-user.password=demo

openbpm.bpm.auto-deployment-enabled=true
openbpm.bpm.deployment-resource-pattern=classpath*:*.bpmn, classpath*:test/*.bpmn, classpath*:*.form, classpath*:*.groovy

    Стало (OpenBPM Engine):

    openbpm.bpm.admin-user.id=demo
openbpm.bpm.admin-user.password=demo

openbpm.bpm.auto-deployment-enabled=true
openbpm.bpm.deployment-resource-pattern=classpath*:*.bpmn, classpath*:test/*.bpmn, classpath*:*.form, classpath*:*.groovy

  3. Замена Java-импортов

    OpenBPM Engine использует новые пространства имён: io.openbpm.bpm.engine.* → io.openbpm.bpm.*

    Было (Camunda 7):

    import io.openbpm.bpm.engine.delegate.DelegateExecution;
import io.openbpm.bpm.engine.delegate.JavaDelegate;

    Стало (OpenBPM Engine):

    import io.openbpm.bpm.engine.delegate.DelegateExecution;
import io.openbpm.bpm.engine.delegate.JavaDelegate;