Удалить элемент из массива
Робот «Удалить элемент из массива» убирает элементы из массива значений по значению или по номеру позиции в бизнес-процессах и роботах Битрикс24. В режиме по значению удаляются все совпадения (по умолчанию без учёта регистра), в режиме по индексу — один элемент, отрицательные индексы отсчитываются с конца. Возвращает массив после удаления, число удалённых и итоговое количество элементов.
Робот вырезает элементы из массива и возвращает новый список — в отличие от робота «Удалить значение из множественного поля», он работает с переданным массивом, а не с полем CRM-сущности. На вход подаётся множественное поле или результат другого робота, режим удаления и цель: в режиме value удаляются все элементы, равные заданному значению (флаг «Учитывать регистр» управляет сравнением), в режиме index — один элемент по позиции, 0 — первый, -1 — последний. Пустая цель в режиме value убирает пустые элементы массива. Типовые случаи применения: исключить конкретный e-mail из списка рассылки; убрать первый элемент после его обработки; очистить массив от пустых значений перед циклом. Возвращает массив после удаления, число удалённых элементов и итоговое количество — используйте их на следующих шагах бизнес-процесса.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Массив значений | string | да | |
| Режим: value — по значению, index — по индексу (по умолчанию value) | string | — | |
| Что удалить: значение или индекс (0 = первый, -1 = последний) | string | — | |
| Учитывать регистр при сравнении (Y/N, по умолчанию N) | string | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Массив после удаления | string |
| Сколько элементов удалено | int |
| Итоговое количество элементов | int |
Сценарий: исключение адреса из рассылки
- В процессе собран массив e-mail получателей
- Робот удаляет из массива адрес отказавшегося клиента
- Цикл рассылки идёт по массиву после удаления — отказавшийся письмо не получает