Итератор: как работать с множественными переменными в бизнес-процессах

Я долго ждала, и он появился!

Итератор: для чего он нужен, как настраивать и пример использования - всё по ссылке "Подробнее" :-)

Для чего нужен итератор

В Битрикс24 можно создавать множественные поля и переменные.

Всё хорошо, но в бизнес-процессе это поле/переменная представляется как список значений через запятую. Не было простой возможности обработать каждое значение отдельно.

Новое действие в редакторе бизнес-процессов "Итератор" эту проблему решает: он делает последовательный обход элементов множественного поля/переменной.

Как настраивать итератор и пример использования

Пример:

Сделка оплачивается частями в произвольное количество этапов. Платежи фиксируются в множественном поле "Платежи". Нужно автоматом рассчитывать оставшуюся к оплате сумму, как разницу между суммой сделки и суммой платежей, и записывать ее в поле "Осталось оплатить".

Как настроить:

Для того, чтобы рассчитать уже оплаченную сумму, нужно последовательно сложить все значения из поля "Платежи".

В настройках итератора можно указать только переменную, поэтому сначала нужно значение поля "Платежи" скопировать в служебную множественную переменную "Платежи":

Добавляем из категории "Конструкции" новый блок "Итератор" в бизнес-процесс и настраиваем его на работу с переменной "Платежи":

Итератор сам последовательно пройдет каждое значение переменной и в дополнительные результаты вернет ключ и значение.

Для вычисления и хранения суммы платежей добавляем ещё одну переменную "Сумма платежей" (payment_sum) с типом "Число" и в итераторе к текущему значению суммы платежей прибавляем значение итератора:

Теперь осталось только из суммы сделки вычесть сумму платежей и записать значение в поле "Осталось оплатить":

В итоге схема бизнес-процесса должна выглядеть так:

Бизнес-процесс настраиваем на автозапуск при создании и изменении сделки.

Тестируем:

45 000 - (5 000 + 6 000 + 10 000) = 24 000

Идеально! :-)