Output Flow

Побудова структури результатів та декларація схеми даних.

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

Він не просто завершує процес, а створює архітектурний план («контракт»), за яким платформа підготує інтерфейс та очікуватиме дані від Main Action. Саме тут ви визначаєте, які типи полів, ключі та назви побачить кінцевий користувач у готовому звіті чи таблиці.

Навігація

1. Унікальна механіка Output: Зв'язок із Main Action
2. Основний блок Add Output та налаштування полів
3. Автоматизація за допомогою кнопки Import
4. Ключові принципи роботи
5. FAQ

Унікальна механіка Output: Зв'язок із Main Action

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

Унікальність архітектури DEV платформи полягає в тому, що Output ініціюється першим, ще до початку виконання основної логіки в Main Action.

Порядок виконання інтеграції:
1. Output ➔ 2. Main Action

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

Чому обрана саме така механіка?

• Створення «Контракту даних»: Запускаючи Output першим, система отримує чіткий опис (схему) того, які саме поля, типи даних та структури вона очікує отримати в результаті. Це створює свого роду «технічне завдання» для наступних кроків.
• Підготовка інтерфейсу: Платформа заздалегідь готує «контейнери» та візуальні елементи, які побачить кінцевий користувач.
• Мапінг результатів: Коли Main Action завершує свою роботу, він просто «заповнює» вже існуючу та прописану структуру Output. Якщо дані в Main Action відповідають ключам, описаним в Output, вони миттєво відображаються користувачу.

Дані передаються з Main Action в Output Flow через блок Add Result to Output.

Роль блоку Add Output

Цей блок є точкою зборки всієї інтеграції. Він не просто виводить дані, він реєструє змінні, які система буде шукати в результатах виконання Main Action.

В Лозі відображається послідовність виконання фловів, там також видно вище описане.

скрін

Основний блок Add Output та налаштування полів

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

У більшості випадків Output містить лише один блок — Add Output. Він визначає, як виглядатиме фінальний результат. Інші блоки (HTTP Request, Loop, Object Builder тощо) можуть використовуватись у Output лише за необхідності. 

1 ->  Type: Технічний формат даних (число, текст, дата тощо). Тип "struct" дозволяє створювати вкладену структуру.

2 ->  Multiple: Перемикач yes/no. Визначає, чи є це поле множинним.

3 ->  Key: Технічний ідентифікатор поля. Має збігатися з ключем, який ви вказали в блоці Add Result to Output (Main Action). Працює в режимах TXT(все обробляється як текст) / EXP(весь вміст обробляється як вираз).

4 ->  Label: Назва поля, яку бачить кінцевий користувач (наприклад, "Статус замовлення"). Працює в режимах TXT(все обробляється як текст) / EXP(весь вміст обробляється як вираз).

5 ->  кнопка Save: зберігає зміни всередині блоку

6 ->  кнопка Import: автоматично імпортує поля, які були передані з Main Action через Add Result to Output.

Автоматизація за допомогою кнопки Import

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

Щоб не прописувати десятки ключів вручну, вбудований автоматичний імпорт:

1. Переконайтеся, що ви виконали успішний Run Test у Flow Test щоб поля і дані підтягнулись.
2. У блоці Add Output натисніть кнопку Import.
3. Система автоматично зчитає структуру з тесту та створить відповідні поля. Вам залишиться лише перевірити типи, підправити Label для користувача.

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

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

Декларативність: Output описує результат, а не логіку.

Стабільність структури: Структура визначається до виконання основної логіки інтеграції.

Чистота даних: Передавайте в Output лише ті поля, які реально потрібні користувачу.

Прогнозованість: Користувач завжди бачить очікувану форму результату.

FAQ

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

1. Чому Output Flow запускається до Main Action?
Тому що Output Flow формує контракт результату, який Main Action наповнює даними.  

2. Чи обовʼязково використовувати Add Output?
Так, якщо ви хочете показати результат користувачу у структурованому вигляді.  

3. Що робити, якщо після запуску в Output пусто?
Перевірте, чи доданий блок Add Result to Output у Main Action і чи був натиснутий Run Test у Flow Test. Дані з'являться в Output лише після фізичного виконання дії в тесті або відправки запиту.

Що далі?

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

Ви налаштували Output Flow — визначили та структуризували дані, які користувач отримає після виконання інтеграції.
Ці поля формуються до запуску Main Action і використовуються для відображення результату.

Наступний крок налаштування:
Request Error Flow →
Тут ви налаштуєте обробку помилок запитів, щоб інтеграція повертала зрозумілі повідомлення у випадку збоїв або некоректних відповідей від сервісу.

Попередній крок:
← Main Action Flow