CRM роботы 2.0 + AI (300+ роботов)

Отфильтровать массив по одному условию

Робот «Отфильтровать массив по одному условию» оставляет в списке значения, соответствующие одному выбранному условию.

Настройки робота «Отфильтровать массив по одному условию» в Битрикс24

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Автору автоматизации и специалисту, который готовит список сумм, дат или названий перед следующей обработкой.

Например, из перечня количеств нужно оставить объёмы не меньше порога. Без явного типа строка «100» может сравниваться с «20» как текст. Робот позволяет указать числовое, строковое или календарное сравнение и сохранить исходный порядок подходящих элементов.

Параметры и подготовка

Поле Как заполнить
Массив в JSON, например [1,2,3] (ARRAY) Обязательное поле
Тип сравнения (KIND) Обязательное поле. по умолчанию string. Строки (string); Числа (number); Даты ISO (date)
Условие (OPERATOR) Обязательное поле. по умолчанию eq. Равно (eq); Не равно (ne); Больше (gt); Не меньше (ge); Меньше (lt); Не больше (le); Содержит (contains)
Значение сравнения в JSON (VALUE) Обязательное поле

Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.

Как использовать

  1. Установите робота и передайте исходный массив JSON. Выберите тип сравнения согласно смыслу значений, а не внешнему виду поля.
  2. Выберите условие. Для числового порога используйте «Не меньше» (ge); «Содержит» допустимо только для строк.
  3. Заполните значение сравнения в формате JSON: число 10, строка "Кабель" либо ISO-дата в кавычках. Кавычки у строк обязательны.
  4. Передайте итоговый массив следующему шагу и проверьте количество. Пустой результат означает, что подходящие элементы не остались.

Как заполнить JSON-поля

Массив в JSON, например [1,2,3] (ARRAY)

[
  3,
  12,
  12,
  null,
  ""
]

Для учебного сравнения KIND=number и OPERATOR=ge. Подготовьте однородные сравнимые значения; null и пустые строки пропускаются. Пустой список допустим.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Значение сравнения в JSON (VALUE)

10

Это само значение сравнения, без оболочки {value:...}. Для строки нужны JSON-кавычки; для ISO-даты тоже. Выбранный KIND должен соответствовать смыслу значения.

Учебный пример и ожидаемый результат

Для массива [3,12,12,null,""] выберите тип number, условие ge и значение сравнения 10. Ожидается [12,12], количество 2. Повторы сохраняются; null и пустая строка не проходят условие. Чтобы убрать повторы, потребуется отдельное действие.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

  • «Итоговый массив в JSON» (result).
  • «Количество элементов» (count).

Результат содержит массив и его размер. Используйте размер для развилки «есть подходящие значения». Не считайте результат набором уникальных записей: фильтрация сохраняет повторные вхождения.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Значение сравнения задаётся в JSON: 10, "текст" или "2026-09-27". Сохраняет порядок и повторы. Null и пустая строка не проходят фильтр. Условие «содержит» доступно для строк, регистр учитывается. Даты задаются в ISO, время: с часовым поясом. Размер входного JSON: до 1 МБ, массива: до 10000 элементов, вложенность: до 64 уровней.

Проверьте корректность каждого сравниваемого значения. Дата-время должна содержать часовой пояс, а слово без JSON-кавычек не считается строкой. Робот применяет одно условие к элементам списка и не ищет поле внутри каждого объекта.