Когда использовать итератор
Понимание итератора
Итератор ожидает на входе массив. Затем он:- Берёт первый элемент массива
- Выполняет все действия внутри итератора с этим элементом
- Переходит к следующему элементу
- Повторяет, пока все элементы не будут обработаны
Выбор массива для перебора
Большинство источников массивов (Search Records, поле массива вебхука, ручной триггер Bulk) можно выбрать непосредственно в селекторе переменных. Когда шаг Code или Logic Function возвращает массив верхнего уровня, его вывод отображается в селекторе переменных как индексированные элементы (0, 1, 2, …). Чтобы перебирать массив целиком, выберите для этого шага параметр Whole list — тогда Iterator автоматически определит структуру каждого элемента списка.
Базовая настройка
Пример: отправка письма всем из результатов поиска
Цель: найти всех контактов в определённой компании и отправить каждому персонализированное письмо.Шаг 1: Поиск записей
- Добавьте действие Search Records
- Объект: Люди
- Фильтр: Company равно “Acme Inc”
- Это возвращает массив людей
Шаг 2: Проверка наличия результатов
- Добавьте действие Фильтр
- Условие:
{{searchRecords.length}}больше 0 - Это предотвращает ошибки итератора при пустых результатах
Шаг 3: Добавьте итератор
- Добавьте действие Iterator
- Входной массив: выберите
{{searchRecords}} - Это создаёт цикл
Шаг 4: Добавьте действия внутри итератора
Действия, добавленные после итератора, выполняются для каждого элемента:- Добавьте действие Send Email (внутри итератора)
- Кому:
{{iterator.currentItem.email}} - Тема: Привет,
{{iterator.currentItem.firstName}}! - Текст письма: персонализированное сообщение с использованием полей текущего элемента
Результат
Если Search Records возвращает 5 человек, то итератор:- Отправляет письмо первому человеку
- Отправляет письмо второму человеку
- … и так для всех 5
Доступ к данным текущего элемента
Внутри итератора используйте{{iterator.currentItem}}, чтобы обратиться к текущей записи:
В селекторе переменных вы можете либо перейти к конкретному полю текущего элемента, либо выбрать Use the whole item, чтобы сослаться на весь текущий элемент (
{{iterator.currentItem}}). Выбор всего элемента удобен, когда вы хотите передать полную запись непосредственно в следующий шаг по цепочке, вместо того чтобы заново собирать ее по полям.
Типовые шаблоны
Обновление нескольких записей
Цель: пометить все просроченные задачи как “Late”Создание записей из массива
Цель: вебхук получает заказ с несколькими позициями; создайте запись для каждойУсловная обработка внутри цикла
Цель: отправлять письма только контактам с действительными адресами электронной почтыУстранение неполадок
”Iterator expects an array”
Причина: вы передали одну запись вместо массива. Решение: убедитесь, что вы передаёте результат действия Search Records или поле-массив, а не одну запись.Итератор не запускается
Причина: массив пуст. Решение: добавьте фильтр перед итератором, чтобы проверить длину массива:Действия выполняются слишком много раз
Причина: действие Search Records вернуло больше записей, чем ожидалось. Решение:- Добавьте более точные фильтры в Search Records
- Установите ограничение в Search Records (макс. 200)
- Добавьте фильтр внутри итератора для дополнительных условий
Особенности производительности
- Расход кредитов: каждая итерация потребляет кредиты на свои действия
- Время: обработка больших массивов занимает больше времени
- Ограничения: рассмотрите пакетную обработку очень больших операций
- Лимиты скорости: при большом числе итераций внешние вызовы API могут упираться в лимиты скорости
Лучшие практики
- Всегда проверяйте длину массива перед итератором, чтобы избежать ошибок
- Добавляйте фильтры внутри циклов, если обрабатывать нужно не все элементы
- Переименуйте шаг Iterator, чтобы он описывал, что именно перебирается
- Тестируйте на небольших массивах перед обработкой больших наборов данных
- Отслеживайте выполнения рабочих процессов, чтобы убедиться, что итерации завершаются как ожидается