Main page •Help
12.01.2026
•
13

Loop (From - To)

Loop (From - To)

Loop (From - To) — це блок для циклічного повторення дій за заданим числовим діапазоном, він працює як класичний лічильник. Він ідеально підходить для випадків, коли потрібно виконати дію певну кількість разів або реалізувати пагінацію (посторінковий запит) в API.  

Навігація

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


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

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

Loop (From - To) | Налаштування блоку


Блок працює на основі двох параметрів, що визначають межі циклу:

1 -> Поле Start: Числове значення, з якого починається цикл (наприклад, 1 або 0).

2 -> Поле Limit: Визначає кількість ітерацій (повторів), які має виконати цикл.  

3 -> Перемикач режиму полів TXT / EXP:

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

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


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

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

Loop (From - To) | Дані для використання


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

  • index — порядковий номер поточної ітерації, починаючи з 0. Ви можете використовувати {{index}} у вкладених блоках циклу для обчислень(наприклад, для пагінації: offset = {{index}} * 20).
  • start — значення, вказане як початкова точка циклу.
  • limit — встановлений ліміт повторень.

2 -> Локальна область видимості:  всі ці системні змінні (index, start, limit) доступні лише всередині вкладених блоків цього циклу.

3 -> Збереження результатів: цикл не накопичує дані самостійно. Якщо ви, наприклад, робите 5 запитів до API всередині циклу і хочете отримати один спільний масив із цими даними «на виході», використовуйте блок Object Builder з записом у Глобальну змінну.


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

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

***

Цей кейс дозволяє автоматично завантажити всі списки лідів, розбиваючи запит на окремі «сторінки», щоб обійти ліміти API.

1. Loop (From - To): Виступає «двигуном» процесу. Він задає кількість ітерацій (сторінок), які потрібно завантажити, передаючи номер поточної ітерації {{index}} у наступні блоки.

2. Evaluate: Обчислює зміщення (offset). За допомогою формули блок визначає, з якого саме запису починати завантаження на кожному кроці (наприклад: 0, 10, 20...), щоб не дублювати дані.

3. HTTP Request: Виконує фінальний запит до API. В URL динамічно підставляються значення limit (скільки записів взяти) та offset (результат обчислення Evaluate), що забезпечує послідовний збір усіх даних.

Loop (From - To) | Приклад Loop + Evaluate + HTTP Request
Loop (From - To) | Приклад Loop + Evaluate + HTTP Request
Loop (From - To) | Приклад Loop + Evaluate + HTTP Request
***
  • Умовне виконання всередині лічильника: Loop + IF + HTTP Request

Коли вам потрібно виконати дію певну кількість разів, але з додатковою перевіркою на кожному кроці.

1. Loop (From - To): створює задану кількість повторів (наприклад, 10).

2. IF: виступає логічним фільтром за формулою (наприклад, виконувати тільки для парних ітерацій {{index}} % 2 == 0).

3. HTTP Request: спрацьовує лише тоді, коли IF повернув 1 (True).  

Loop (From - To) | Приклад Loop + IF + HTTP Request
Loop (From - To) | Приклад Loop + IF + HTTP Request
***

Дозволяє створити масив об'єктів "з нуля" на основі лічильника або зібрати результати розрізнених дій у єдиний список.

1. Loop (From - To): Визначає кількість елементів, які потрібно створити. На кожній ітерації він надає унікальний номер {{index}}.

2. Object Builder: Використовує дію Add Object at end для запису даних кожної ітерації у Глобальну змінну. Це дозволяє накопичувати результати, формуючи цілісний масив.

3. Output (опціонально): Він передає фінальний накопичений масив як результат роботи інтеграції, що дозволяє іншим системам отримати готові дані у зручному форматі.

Loop (From - To) | Приклад Loop + Object Builder + Add Result to Output
Loop (From - To) | Приклад Loop + Object Builder + Add Result to Output


FAQ

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

1. Чим Loop (From - To) відрізняється від Loop (Object/List)?
Object/List перебирає вміст масиву (елементи). From - To просто рахує кількість повторів. Використовуйте From - To, коли у вас немає масиву, але ви знаєте, скільки разів треба виконати дію.

2. Чи можна використовувати змінні або вирази в Start та Limit?
Так. Обидва поля підтримують режим EXP, що дозволяє задавати динамічні межі циклу.  

3. Що буде, якщо Limit дорівнює 0 або якщо Start більше за Limit?
Цикл виконається один раз, лише під час збереження блоку або відправки запиту, відповідно результат буде лише по одній ітерації. Для стабільної роботи завжди перевіряйте, щоб Limit був більшим за Start.

4. Чи підтримуються вкладені Loop (From – To)?
Так. Ви можете вкладати цикли для реалізації багаторівневої логіки або складних сценаріїв повторів.

5. Де доступний цей блок?
Блок доступний у всіх основних флоу: Input, Main Action, Output, Account Validation, Request Error, Custom.