Перевірка статусу витягу: Get Excerpt Status

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

Інтеграційне розширення Get Excerpt Status дозволяє налаштовувати перевірку статусу генерації витягу у бізнес-процесі. Це розширення допомагає автоматизувати процеси перевірки статусу витягів, забезпечуючи належне оброблення запитів та передачу їх до наступних етапів бізнес-процесу. Розширення додає різні властивості до сервісного завдання (Service Task).

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

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

Get Excerpt Status

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

${excerptConnectorStatusDelegate}

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

excerptConnectorStatusDelegate.json

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

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

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

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

Делегат Get Excerpt Status призначений для використання у сервісних завданнях (Service Task) бізнес-процесу. Він дозволяє налаштувати автоматичну перевірку статусу витягу, приймаючи різні параметри для гнучкого налаштування. У нашому прикладі, делегат використовується в рамках завдання, що є частиною підпроцесу, ініційованого делегатом Перевірка статусу витягу: Check excerpt status.

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

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

  2. Назвіть завдання, наприклад, Перевірка статусу витягу.

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

    get excerpt status 1

Завдання приймає вхідні дані з попереднього завдання та передає результат до наступного етапу процесу.

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

У розділі Custom properties виконайте наступні налаштування:

  1. Excerpt Identifier: вкажіть ідентифікатор витягу, який буде перевірятися. Наприклад, ${excerptIdentifier}.

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

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

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

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

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

    3. Використайте отриманий ID витягу у полі Excerpt id, щоб зберегти ID витягу до БД.

  2. X-Access-Token: зазначте токен доступу користувача, під яким виконується операція. Наприклад, ${system_user().accessToken}.

    Функція system_user() необхідна для отримання системного користувача з Keycloak.

    Метод accessToken повертає токен користувача, що можна використовувати в інтеграційних конекторах для авторизації від імені системного користувача.

  3. Result variable: вкажіть назву змінної, до якої буде записано результат перевірки статусу витягу. Наприклад, response.

4. Приклад

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

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

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

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

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

Get Excerpt Status — делегат, який використовується у бізнес-процесах для перевірки статусу витягів.

Ви можете використати приклад процесу за пошуком по ключовим словам — feature-check-excerpt-status.

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

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