Все ноды/Logic & Flow/Iteration

Фильтр

Обходит массив со входа «Массив». Для каждого элемента запускает тело; значение, пришедшее на вход «Оставить элемент?», должно быть строго да/нет. Да — элемент попадает в результат, нет — отбрасывается. Порядок сохраняется.

Как попробовать

Как применять

Берите эту ноду, когда из массива надо оставить часть элементов, ничего в них не меняя: отобрать заказы дороже порога, оставить только письма с вложением, отсеять строки, которые модель признала нерелевантными. Если элементы надо преобразовать — это map; если результат не нужен вовсе — for_each. Отбор по простому признаку, который считается прямо из данных, короче выразить фильтрами шаблоном template или одной нодой code_javascript; цикл нужен, когда решение принимает модель или внешний сервис.

Как это работает

На input («Массив») приходит массив и команда запуска. Порт item («Элемент») начинает тело, end («Оставить элемент?») его замыкает. Для каждого элемента выполняется тело, и значение на end трактуется как ответ «оставить или нет». В выходной массив попадает исходный элемент, а не то, что вернуло тело; порядок сохраняется. Результат ноды — отфильтрованный массив: {{ nodes.<id>.output }}.

Значение на end должно быть настоящим логическим. Шаблон вида {{ inputs.input.score > 5 }} подходит: он отдаёт True или False, и нода их понимает. Строки "true", "да", 1 и пустая строка не подходят — итерация упадёт с сообщением, в котором указан номер элемента и что именно пришло.

Флаги «Включить индекс» и «Параллельное выполнение» работают так же, как у map: с индексом на item уходит объект {<ключ элемента>: значение, index: N}, а параллельный режим планирует итерации одновременно, но тела выполняются под общей блокировкой.

Частые ошибки

• Тело возвращает не логическое значение. Самый частый случай — шаблон, который отдаёт текст или "true" строкой. Пишите сравнение целиком внутри {{ }}.
• Попытка изменить элемент. Значение с end используется только как признак; чтобы получить преобразованные элементы, нужен map (можно сначала отфильтровать, потом преобразовать).
• На вход подан объект, а не массив. Поставьте перед циклом template с {{ inputs.input.items | tojson }}; валидатор предупреждает об этой связи заранее.
• Тело не замкнуто. Ребро из item и ребро в end обязательны, иначе сценарий не задеплоится.
• Цикл внутри цикла. Вложенные циклы отвергаются валидатором: ставьте их последовательно или переносите внутренний обход в code_javascript.
• Ребро из тела «наружу». Продолжение от нод тела выполняется на каждой итерации; дальнейший граф стройте от порта completed («Готово»).
• Ошибка одной итерации останавливает весь цикл — отфильтрованный массив не вернётся вовсе.

Входы

Выходы

Настройки