Main Action Flow

Ядро інтеграції: реалізація бізнес-логіки та взаємодія з API.

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

Цей Flow є «серцем» інтеграції — від простих одноразових запитів до складних сценаріїв із циклами, умовами та обробкою помилок.

Навігація

1. Як працює Main Action Flow
2. Основні блоки та їх призначення
3. Робота з даними (Pipeline)
4. Передача результату (Add Result to Output)
5. Тестування та ініціалізація
6. Ключові принципи роботи
7. FAQ

Як працює Main Action Flow 

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

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

Основні задачі флоу:

• Виконання основних API-операцій, одного або кілька (створення сутностей, пошук, оновлення даних, отримання даних);
• Формування структури запиту на основі вхідних Input-даних.
• Трансформація даних: фільтрація, зміна форматів, математичні операції.
• Перевірка умов та контроль сценаріїв виконання
• Підготовка фінального результату для Output Flow

Main Action не має обмежень по логіці — ви будуєте сценарій повністю під задачу конкретної інтеграції.

Основні блоки та їх призначення

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

Приклад структури Main Action Flow з основними логічними блоками.

У Main Action можна використовувати будь-який блок платформи. Комбінація блоків залежить виключно від логіки інтеграції, але найчастіше «серце» системи будується на таких елементах:

HTTP Request: Виконання основного запиту до API. Використовує змінні з Authentication та Input.

Loop (Object/List): Циклічна обробка масивів даних (наприклад, завантаження списку товарів по черзі).

IF (Condition): Логічне розгалуження: перевірка заповненості полів або статусів відповіді API.

Evaluate: «Мозок» для розрахунків. Використовується для математичних формул або складних виразів.

Object Builder: Збирання розрізнених даних у єдину структуру для фінального запиту або виводу.

Add Result to Output: Фінальний блок, який передає оброблені дані в наступний потік (Output).  

Error: Обробка помилкових сценаріїв (або можна зробити це глобально на рівні Request Error)

Робота з даними (Pipeline)

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

Логіка передачі даних у Main Action виглядає наступним чином:

1 ->  Вхідні дані: Ви берете змінні з Globals -> INPUT.

2 ->  Підготовка: Використовуєте Loop, Evaluate або Object Builder, щоб підготувати Body для запиту.

3 ->  Дія: Виконуєте HTTP Request.

4 ->  Обробка: Для трансформації результату в необхідний формат використовуєте Loop, Object Builder або IF для перевірки або розгалуження логіки.

5 ->  Результат: Отриману відповідь (Response) ви передаєте в блок Add Result to Output.

Передача результату (Add Result to Output)

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

Add Result to Output — це фінальна точка вашого Main Action Flow.

• Ви можете передавати дані напряму з результату HTTP Request.
• Ви можете передати складну структуру, сформовану в Object Builder.
• У самому Output Flow ці дані можна буде додатково доопрацювати, але рекомендується формувати максимально чисту структуру саме тут, у Main Action.
• Використовувати різні Add Result to Output у різних гілках IF.

Тестування та ініціалізація

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

Після налаштування логіки необхідно провести тестування та ініціалізацію.

Порядок дій у Flow Test:

1 ->  кнопка Flow Test: Перехід до налаштування тесту. Тут проводиться підключення акаунту, запуск інтеграції, заповнення вхідних тестових даних.

2 ->  розділ Input Settings: Ви побачите сформовану форму з вашими полями. Заповніть їх валідними тестовими даними.

3 ->  кнопка Save в Flow Test: Зберігає введені вхідні дані та підключені акаунти. 

4 ->  кнопка Run Test: ініціалізує запуск всієї інтеграції, всіх флоу. 

5 -> кнопка Лог: Журнал даних результату виконання кожного блоку. Можна побачити як дані проходять через IF-умови, чи обробився кожен елемент в циклі коректно, та чи дані доходять до Output у правильному форматі.

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

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

• Цілісність: Main Action має обробляти всі можливі сценарії (наприклад, що робити, якщо API повернуло 404). Використовуйте локально блок Error для таких випадків або обробіть це глобально в окремому флоу Request Error.
• Чистота даних: Намагайтеся не перевантажувати Output Flow зайвою технічною інформацією, передавайте лише те, що потрібно користувачу.
• Гнучкість: Використовуйте змінні замість статичних значень, щоб інтеграція була універсальною.

FAQ

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

1. Чи можна додати кілька блоків Add Result to Output? 
Так, ви можете використовувати їх у різних гілках IF-блоку, щоб видавати різні результати залежно від умов.  

2. Що робити, якщо API повертає дуже вкладену структуру (більше 2 рівнів)? 
У такому разі скористайтеся блоком Object Builder у Main Action, щоб «витягнути» глибокі поля на верхні рівні перед передачею в Output.

3. Чи обовʼязково використовувати Add Result to Output?
Ні, але він рекомендований для явного формування результату, якщо користувачам необхідно відобразити результат.  

4. Як перевірити, чи працює цикл (Loop) у Main Action? 
Під час Run Test у вікні Логів ви зможете побачити кожну ітерацію циклу та дані, які оброблялися на кожному кроці.

Що далі?

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

Ви реалізували головну дію інтеграції — саме тут відбувається основний запит або операція.

Наступний крок налаштування:
Output Flow →
На цьому етапі ви опишете та підготуєте дані, які будуть повернуті користувачу.

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