Встановлення типових розширень до бізнес-процесів (для локальної розробки)

🌐 Цей документ доступний українською та англійською мовами. Використовуйте перемикач у правому верхньому куті, щоб змінити версію.

Щоб спростити моделювання бізнес-процесів, Платформа підтримує типові розширення-конектори — Element Templates.

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

1. Передумови

1.1. Встановлення застосунку Camunda Modeler

  1. Завантажте архів із застосунком Camunda Modeler за посиланням.

    Рекомендовано використовувати версію 4.8.0 для стабільної роботи системи.

  2. Оберіть продукт Open Source Modeler та завантажте відповідну версію, сумісну із вашою операційною системою (наприклад, Windows 64bit);

  3. Після завантаження архіву з додатком, розпакуйте його на локальній машині.

    Папка із застосунком може мати, наприклад, таку назву:

    camunda-modeler-4.8.1-win-x64

1.2. Встановлення плагіну BPMN Linter

Встановіть плагін BPMN Linter для розширення функціональності Camunda та валідації ваших BPMN-діаграм.

  1. Перейдіть до офіційного репозиторію camunda-modeler-linter-plugin.

  2. Натисніть кнопку Code  Download ZIP та завантажте архів.

    element temp install bpmnlint

  3. Після завантаження, розпакуйте вміст архіву до папки застосунку Camunda:

    camunda-modeler-4.8.1-win-x64\resources\plugins

  4. Перезапустіть додаток Camunda Modeler.

  5. Увімкніть плагін. Для цього натисніть Plugins  BPMN Linter  Toggle Linting.

    • Альтернативно застосуйте комбінацію клавіш ctrl+L.

    • Плагін вмикається та вимикається однаково — ctrl+L.

    element temp turn on bpmnlint

2. Встановлення каталогу типових розширень

2.1. Встановлення каталогу типових розширень для Windows OS

Виконайте настанови, подані нижче, для встановлення каталогу Element Templates.

  1. Клонуйте каталог типових розширень із Github-репозиторію edp-ddm-registry-configuration. Наприклад, використайте наступну команду для HTTPS:

    https://github.com/epam/edp-ddm-registry-configuration.git

  2. Відкрийте клонований репозиторій на локальній машині та знайдіть теку /element-templates.

  3. Копіюйте каталог із JSON-файлами та вставте їх до вашого проєкту із застосунком, який ви будете використовувати для моделювання. Наприклад, для Camunda Modeler, шлях може бути наступним:

    ./camunda-modeler-4.8.1-win-x64/resources/element-templates

    • camunda-modeler-4.8.1-win-x64 — локальна директорія, в якій зберігається додаток.

    • resources — тека, що містить розширення (element-templates) та плагіни (plugins).

    • element-templates — тека, що містить JSON-файли з типовими розширеннями.

  4. Підсумкова структура директорії resources має виглядати наступним чином:

    bp element temp 02

  5. Підсумкова структура директорії element-templates має виглядати наступним чином:

    bp element temp 03

  6. Підсумкова структура директорії plugins має виглядати наступним чином:

    bp element temp 04

  7. Перезапустіть додаток Camunda Modeler та перевірте доступність розширень у каталозі при моделюванні бізнес-процесу:

    1. Створіть задачу — оберіть Create Task.

    2. Натисніть іконку ключа — оберіть Change Type.

    3. Вкажіть тип задачі — сервісна (Service Task), користувацька (User Task) або Call Activity.

    4. Натисніть кнопку Open Catalog.
      У результаті відкриється каталог розширень Element Templates, які можна застосувати в процесі моделювання.

      bp element temp 01

2.2. Встановлення каталогу типових розширень для macOS

Виконайте настанови, подані нижче, для інсталювання каталогу Element Templates.

  1. Завантажте каталог розширень до бізнес-процесів за аналогією до пункту Встановлення каталогу типових розширень для Windows OS.

  2. Відкрийте термінал.

  3. Перейдіть до локальної директорії розміщення ресурсів Camunda Modeler за допомогою команди:

    cd ~/Library/Application\ Support/camunda-modeler/resources

  4. Створіть нову директорію під розширення категорії element templates у випадку, якщо її там немає, за допомогою команди:

    mkdir element-templates

  5. Скопіюйте всі JSON-файли розширень із директорії business-process-modeler-extensions до директорії, що була створена, за допомогою команди:

    cp business-process-modeler-extensions/*.json ~/Library/Application\ Support/camunda-modeler/resources/element-templates

  6. Підсумкова структура директорії виглядатиме наступним чином:

    ~/Library/Application\ Support/camunda-modeler/resources/element-templates/

    bp element temp 05

  7. Перезапустіть додаток Camunda Modeler та перевірте доступність розширень у каталозі при моделюванні бізнес-процесу:

    1. Створіть задачу — оберіть Create Task.

    2. Натисніть іконку ключа — оберіть Change Type.

    3. Вкажіть тип задачі — сервісна (Service Task), користувацька (User Task) або Call Activity.

    4. Натисніть кнопку Open Catalog.
      У результаті відкриється каталог розширень Element Templates, які можна застосувати в процесі моделювання.

      bp element temp 01