Loop (object/list)

Loop (Object/List) - це блок для ітерації по елементах об'єкта або масиву. Використовується для обробки списків, масивів та вкладених структур, отриманих з API або сформованих у флоу.

Навігація

1. Налаштування блоку
2. Робота з даними та область видимості
3. Приклади використання
   HTTP Request + Loop
   Loop + IF
   Loop + Object Builder
   Loop + Output
4. FAQ

Налаштування блоку

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

1 -> Поле Object to iterate: поле для вибору обʼєкта або масиву, який потрібно перебрати. 

2 -> Перемикач режиму поля TXT / EXP:

Простий варіант (TXT режим) - все обробляється як текст.

Просунутий варіант (EXP режим) - вміст обробляється як повноцінний вираз (Expression). Дозволяє застосувати логічні оператори та функції безпосередньо в полі вибору.

Наприклад, «/» у режимі TXT - це роздільник, а в режимі EXP - ділення.

Робота з даними та область видимості

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

1 -> Доступні системні змінні: У кожній ітерації Loop автоматично генерує набір даних, доступних для вкладених блоків:

• index — порядковий номер поточної ітерації (починаючи з 0).
• count — загальна кількість елементів у списку/об'єкті.
• key — назва ключа (актуально при ітерації об'єкта {key: value}).
• value — безпосередній вміст елемента.

2 -> Локальна область видимості:  всі ці змінні існують тільки всередині поточного блоку Loop.

3 -> Збереження результатів: дані з ітерацій не накопичуються автоматично. Для накопичення результатів використовуйте, наприклад, Object Builder з записом у Глобальну змінну.

4 -> Джерела даних:

- масиви з Response Body (HTTP Request).

- результати обробки Object Builder.

- вкладені властивості об'єктів (наприклад, data.orders).

Приклади використання

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

• HTTP Request + Loop

Використовується для обробки масивів, отриманих з API-відповіді (items, data, results).

У полі Object to iterate вибрано масив з відповіді HTTP Request

• Loop + IF

Фільтрація елементів масиву за умовою перед подальшою обробкою.

Блок IF вкладений всередину Loop та виконується для кожного елемента масиву.

• Loop + Object Builder

Трансформація вхідного масиву в новий формат

• Loop + Add Result to Output

Формування фінальної відповіді інтеграції з перебраних елементів.

Loop ітерується по масиву з відповіді API. Дані послідовно передаються у фінальний флоу Output через блок Add Result to Output.

FAQ

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

1. Чи виконається Loop, якщо масив порожній?
Ні. Якщо масив порожній або null - цикл буде проігнорований, а вкладені блоки не виконаються.

2. Чи підтримуються вкладені цикли?
Так, ви можете вкладати Loop у Loop для обробки багатовимірних масивів.

3. Де можна додати блок?
Доступний в таких Flow: Input, Main Action, Output, Account Validation, Request Error, Custom.