Виклик глобального підпроцесу: Call Activity

1. Загальна інформація

Інтеграційне розширення Call Activity дозволяє налаштовувати завдання для виклику глобального підпроцесу у бізнес-процесі. Це розширення допомагає автоматизувати процеси виклику зовнішніх підпроцесів, забезпечуючи належне оброблення викликів та передачу даних між процесами. Розширення додає різні властивості до завдання типу Call Activity.

Таблиця 1. Короткі відомості про делегат
Назва Пояснення

Бізнес-назва інтеграційного розширення

Call Activity

Службова назва інтеграційного розширення

${callActivity}

Назва файлу у бібліотеці розширень

callActivity.json

Розширення Call Activity використовується, коли необхідно з одного бізнес-процесу викликати зовнішній підпроцес. Це дозволяє організувати складні бізнес-процеси з багаторівневими викликами та передачею даних.

Існують певні обмеження щодо кількості рівнів вкладеності бізнес-процесів при викликах зовнішніх підпроцесів за допомогою делегата Call Activity. Використовуйте не більше 3-х рівнів вкладеності бізнес-процесів: основний процес, глобальний підпроцес 1-го рівня та глобальний підпроцес 2-го рівня.
Більш детально про особливості використання делегата у бізнес-процесі див. на сторінці Глобальний підпроцес (Call Activity).

2. Перед початком

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

При моделюванні бізнес-процесів із використанням сторонніх застосунків, важливо інтегрувати каталог типових розширень з нашого репозиторію. Завітайте до business-process-modeler-extensions, щоб завантажити необхідні файли. Наприклад, для таких інструментів, як Camunda Modeler, у вашій теці /element-templates мають бути включені відповідні JSON-файли. Для детальних інструкцій, будь ласка, перегляньте Встановлення типових розширень.

3. Налаштування

Делегат Call Activity призначений для використання у завданнях типу Call Activity бізнес-процесу. Він дозволяє налаштувати виклик глобальних підпроцесів з передачею вхідних та вихідних даних.

3.1. Налаштування завдання

  1. Створіть завдання типу Call Activity у вашому бізнес-процесі.

  2. Назвіть завдання, наприклад, call-activity-task.

  3. Застосуйте шаблон делегата, обравши Call Activity зі списку в налаштуваннях завдання.

    call activity 1

3.2. Налаштування делегата

Виконайте наступні налаштування:

  1. У полі Called Element вкажіть ідентифікатор стороннього процесу або підпроцесу, що викликатиметься, наприклад, called-process.

  2. У полі Input data вкажіть вхідні дані, які необхідно передати бізнес-процесу, що викликається. Параметри можна передати кількома шляхами, зокрема:

    • Як ключ-значення у вигляді змінної. Наприклад, ${payload}. Змінну payload потрібно попередньо визначити у скрипт-завданні, до якої будуть записані дані.

    • Через функцію submission(), яка дозволяє отримати дані, внесені на формі користувачем. Наприклад:

      ${submission('Previous user task ID').formData}

      • submission() — назва JUEL-функції.

      • 'Previous user task ID' — ID будь-якої попередньої задачі користувача, змодельованої у бізнес-процесі, і яка містить подібний набір полів — ідентична або майже ідентична.

      • formData — метод, який дозволяє отримати дані на UI-формі у бізнес-процес й передати їх на іншу форму.

        Це забезпечує зв’язок між діями виконавця попередньої задачі та цією задачею.

  3. У полі Output variable name вкажіть назву змінної, до якої необхідно записати дані, отримані в результаті виконання підпроцесу, що викликається. Наприклад, вкажіть змінну callActivityOutput.

    Якщо підпроцес, що викликали, продукує якісь дані на виході, він запише ці дані до вказаної змінної. Далі, якщо є потреба використати отримані дані в основному процесі, необхідно звернутися до змінної, в якій ці дані зберігаються.

4. Приклад

Ось приклад, який показує, як відповідний делегат використовується у бізнес-процесі:

call activity 2
Зображення 1. Приклад. Налаштування делегата Call Activity
Де можна знайти приклад бізнес-процесу?

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

Детальну інструкцію щодо розгортання демо-реєстру та отримання референтних прикладів моделювання ви знайдете на сторінці Розгортання демо-реєстру із референтними прикладами.

Call Activity — делегат, який використовується у багатьох бізнес-процесах, що потребують виклику зовнішніх підпроцесів.

Ви можете використати один із прикладів процесів за пошуком по ключовим словам — feature-auto-process-create-order.

У Кабінеті користувача бізнес-процес буде доступний у розділі Доступні послуги.

5. Пов’язані сторінки