Перевірка статусу витягу: Check excerpt status

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

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

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

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

Check excerpt status

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

${checkExcerptStatusCallActivity}

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

checkExcerptStatusCallActivity.json

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

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

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

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

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

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

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

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

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

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

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

    check excerpt status 1

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

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

  1. У полі Input excerpt identifier вкажіть ID витягу, який необхідно передати бізнес-процесу, що викликається. Наприклад, ${excerptIdentifier}.

    Щоб отримати ID витягу, виконайте наступні кроки:

    1. Запит на отримання витягу: використовуйте делегат Генерування витягу: Generate Excerpt. Після виконання делегата, у відповіді повернеться ID витягу, який буде записано до визначеної змінної, наприклад, response.

    2. Збереження ID витягу: використовуйте скрипт-задачу для витягнення й збереження ID витягу наступним чином:

      response.responseBody.prop('excerptIdentifier').value()

      Змінна excerptIdentifier зберігатиме ідентифікатор витягу.

    3. Використайте отриманий ID витягу у полі Input excerpt identifier при налаштуванні перевірки статусу витягу.

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

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

4. Приклад

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

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

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

Еталонний регламент з прикладами для України зберігається в репозиторії ua-registry-demo-regulation.

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

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

Ви можете використати один із прикладів процесів за пошуком по ключовим словам — reference-generate-factor-names-excerpt.

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

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