Проверка массива
Как проверить массив в шаге «Условие»: пустой или непустой, содержит значение и сравнение количества элементов.
Шаг «Условие» умеет проверять пользовательские и глобальные массивы напрямую. Для обычной развилки не нужно сначала сохранять количество элементов в отдельное поле.
Например, чтобы отправить подписчика к оформлению заказа, можно проверить: «Товары в корзине» → «Не пустой».
Как добавить проверку¶
Добавьте в сценарий шаг «Условие».
Нажмите «Добавить условие».
Откройте «Проверка поля».
Выберите «Пользовательские поля» или «Глобальные переменные».
Выберите массив.
Выберите оператор, укажите значение, если оно требуется, и сохраните шаг.
Настройте переходы для веток «Да» и «Нет».
Добавление проверки поля в шаге «Условие»
Доступные проверки¶
Оператор | Что проверяет | Пример |
|---|---|---|
Пустой | У массива нет значения или в нём нет элементов | Корзина пуста |
Не пустой | В массиве есть хотя бы один элемент | В корзине есть товар |
Содержит значение | В массиве есть заданное значение | Города содержат «Казань» |
Не содержит значение | В массиве нет заданного значения | Избранное не содержит товар |
Количество элементов равно | Размер массива равен числу | Выбрано ровно 3 варианта |
Количество элементов больше | Размер массива больше числа | В корзине больше 2 товаров |
Количество элементов меньше | Размер массива меньше числа | Осталось меньше 5 дат |
Проверить, пустой ли массив¶
Выберите оператор «Пустой». Условие сработает в двух случаях:
поле ещё не получило значение;
значение массива равно
[].
Для противоположной проверки выберите «Не пустой».
Если нужна только развилка «есть элементы / нет элементов», это проще, чем сравнивать количество с нулём.
Проверить наличие значения¶
Для текстового массива укажите текст, для числового — число, для массива дат — дату соответствующего формата.
Пример:
Доступные города → Содержит значение → Казань
Сравнение точное. Для массива объектов проверка срабатывает, если указанное значение совпадает со значением хотя бы одного поля объекта. Например, массив
[{"name": "Онлайн-курс", "price": 2990}]
содержит значения Онлайн-курс и 2990.
Сравнить количество элементов¶
Выберите один из операторов количества и укажите целое число.
Примеры:
Товары в корзине → Количество элементов равно → 3
Товары в корзине → Количество элементов больше → 2
Доступные города → Количество элементов меньше → 10
Сравнение выполняется с текущим размером массива в момент прохождения подписчиком шага.
Когда нужна функция array_length¶
Для простой проверки используйте оператор количества прямо в шаге «Условие».
Функция «Количество элементов массива» нужна, если результат требуется:
сохранить в числовое поле;
вывести в сообщении;
использовать несколько раз в разных шагах;
включить в математическую формулу.
Функция «Количество элементов массива»
Для пустого массива или массива без значения функция возвращает 0.
Пример с промежуточным числовым полем¶
Допустим, количество товаров нужно сначала сохранить, затем показать подписчику и использовать в условии.
Создайте числовое пользовательское поле «Количество товаров».
Добавьте шаг «Действия».
Выберите поле «Количество товаров».
Выберите «Математические операции со значением».
В меню переменных и функций выберите «Количество элементов массива».
Выберите массив «Товары в корзине» и сохраните действие.
В следующем сообщении вставьте поле «Количество товаров».
В шаге «Условие» проверьте числовое поле, например «Больше чем 2».
Если количество не нужно сохранять или показывать, пропустите числовое поле и проверьте массив напрямую.
Несколько условий в одном шаге¶
В верхней части шага выберите режим:
«Соответствует каждому из условий» — должны выполниться все проверки;
«Соответствует любому из условий» — достаточно одной проверки.
Например, можно проверить, что корзина не пуста и содержит конкретный товар.