Custom Flow

Організація модульної логіки та допоміжні сценарії.

Custom Flows — це допоміжні, ізольовані потоки, які дозволяють виносити складну логіку в окремі блоки та використовувати її в різних частинах інтеграції . Замість дублювання однакових ланцюжків блоків, ви створюєте один Custom Flow і викликаєте його там, де це необхідно.

По суті, Custom Flow можна уявити як внутрішню функцію інтеграції — з чітким призначенням, можливістю повторного виклику та централізованого оновлення логіки.

Навігація

1. Призначення та переваги Custom Flows
2. Як створити та активувати 
3. Механіка виклику: блок Run Custom Flow
4. Ключові принципи роботи
5. FAQ

Призначення та переваги Custom Flows

─────────────────────────────────────────────────────────────-

Уявіть, що вам потрібно виконувати одну й ту саму логіку в декількох місцях інтеграції — наприклад, нормалізацію даних, складні обчислення або перевірку умов. Custom Flow дозволяє винести цю логіку в окремий потік і використовувати її повторно.

Основні переваги:

• Єдине представлення даних — ви уникаєте дублювання блоків у різних флоу.
• Масштабованість — зміни в Custom Flow автоматично застосовуються у всіх місцях його виклику.
• Читабельність — основні флоу (Main Action, Input, Output) стають простішими та зрозумілішими.
• Підтримуваність — логіка розділена на ізольовані, легко підтримувані модулі.

Як створити та активувати Custom Flow

─────────────────────────────────────────────────────────────-

Custom Flow не є частиною основної лінійної схеми, він знаходиться у бічній панелі керування:

1 -> Відкриває бічну панель: основна навігація по всім доступним потокам інтеграції.

2 -> Кнопка Add Flow: дозволяє додати новий потік. Ви можете створити декілька таких потоків, і викликати їх за потреби в інших флоу.

3 -> Custom: назва потоку, що з’являється після додавання. Натисніть на нього, щоб перейти до налаштування блоків. Можна перейменувати за допомогою олівця навпроти.

4 -> Перемикач увімкнення/вимкнення: активує або деактивує цей конкретний потік. Якщо увімкнено, то в інших флоу в блоці Run Custom Flow в полі "Flow to execute" він буде доступний в списку. Якщо вимкнено, в полі "Flow to execute" ви його не побачите у списку і не зможете запустити.

Механіка виклику: блок Run Custom Flow

─────────────────────────────────────────────────────────────-

Custom Flow не запускається самостійно.  Він виконується лише тоді, коли ви явно викликаєте його через спеціальний блок Run Custom Flow.  

Як налаштувати виклик:

1 ->  Додайте блок Run Custom Flow у будь-якому місці сценарію (Main Action, Input, Output або навіть іншого Custom Flow)  

2 ->  У налаштуваннях блоку відкрийте поле "Flow to execute" та оберіть потрібний Custom Flow зі списку активних потоків.

3 ->  Натисніть Save для збереження.

Ключові принципи роботи

─────────────────────────────────────────────────────────────-

• Універсальність виклику: Custom Flow можна викликати з будь-якого іншого потоку.

• Глобальний контекст: Custom Flow має повний доступ до всіх змінних (VARS - GLOBALS), сформованих на попередніх етапах інтеграції.

• Ієрархія: Ви можете створювати вкладені виклики (Flow A викликає Flow B), проте варто уникати надто складних або циклічних залежностей.

• Модульність: ви розділяєте велику задачу на менші, зрозуміліші частини.  

FAQ

─────────────────────────────────────────────────────────────-

1. Чи може Custom Flow викликати сам себе (рекурсія)?
Так, блок Run Custom Flow дозволяє обрати поточний флоу. Використовуйте це обережно, щоб уникнути нескінченних циклів.

2. Що станеться, якщо видалити Custom Flow, який десь використовується?
Блок Run Custom Flow у місці виклику поверне помилку, оскільки потік для запуску більше не існує.

3. Чому я не бачу свій Custom Flow у списку "Flow to execute"?
Перевірте статус перемикача в бічній панелі. Потік має бути увімкнений, щоб система дозволила його обрати для запуску.  

4. Чи передаються дані назад з Custom Flow?
Так. Усі зміни, зроблені всередині (через Evaluate чи Object Builder), зберігаються в глобальному контексті та доступні для наступних блоків після завершення виконання Custom Flow.  

Що далі?

─────────────────────────────────────────────────────────────-

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

Попередній крок:
← Request Error Flow