Итератор

Урок 107 из 463
Автор: Марина Павлова
Сложность урока:
1 уровень - интуитивно все понятно из интерфейса, но почитать стоит.
1 из 5
Дата изменения: 17.06.2022
Просмотров: 21803
Недоступно в лицензиях:
Текущую редакцию Вашего 1С-Битрикс можно просмотреть на странице Обновление платформы (Marketplace > Обновление платформы).
Старт, Стандарт, Малый бизнес

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

  Параметры и структура конструкции

При добавлении конструкции Итератор в шаблон, появляется область выделенная серым цветом. Все действия, расположенные в этой области будут участвовать в цикле.

Итератор имеет один параметр Источник, в котором требуется выбрать источник значений До версии модуля Бизнес-процессы 21.700.0 конструкция работала только с
переменными шаблона.
из списка. Источником значений может быть:

  • Параметр/переменная/константа шаблона БП;
  • Глобальная константа/переменная;
  • Поле документа.

  Дополнительные результаты

В результате использования конструкции в форме Вставка значения станут доступны Дополнительные результаты, которые потребуются нам для использования в цикле:

  • Ключ
  • Значение

Обратите внимание! Для того, чтобы каждый раз в цикле использовать очередное значение из источника, нужно использовать пункт Значение из Дополнительных результатов Итератора.

  Простой пример

Сначала подробно разберем работу итератора на очень простом примере:

  • Пусть у нас есть множественная переменная типа Целое число, в которой задано 6 разных чисел: 4, 8, 15, 16, 23, 42.

  • Создаём шаблон бизнес-процесса. Используем конструкцию Итератор и действие Сообщение соц. сети Действие, которое позволяет отправить уведомление указанному пользователю/группе пользователей через модуль социальной сети.

    Подробнее...
    в теле итератора:

  • В параметре Итератора укажем переменную со списком чисел, а в Сообщении соц. сети в качестве текста сообщения - дополнительный результат итератора Значение :

Сохраним шаблон и запустим его на выполнение. Результат - 6 уведомлений с числами из переменной:

Поясним как выполнялся процесс:

  • Итератор взял первое значение из переменной. Это число 4;
  • Действие Сообщение соц.сети отработало с числом 4. Первая итерация цикла завершилась;
  • Итератор взял следующее значение из переменной - число 8;
  • Действие Сообщение соц.сети отработало с числом 8. Вторая итерация цикла завершилась;
  • И т.д. Процесс повторялся пока не было использовано последнее значение из переменной (число 42).

Таким образом в бизнес-процессе совершено 6 итераций (т.к. в переменной 6 чисел) и в результате показано 6 уведомлений.

Дополнительный результата итератора Ключ

  Другие примеры

  Создание задач для списка пользователей

Например, у вас имеется переменная с типом Привязка к пользователю, представляющая собой список сотрудников . И вы хотите создать последовательно каждому из них задачу. Укажите в настройках Итератора переменную со списком, а в цикл добавьте действие Задача Действие позволяет создать задачу.

Подробнее...
:

В качестве Ответственного укажем Значение из дополнительных результатов формы Вставка значения:

В результате запуска БП будет создано три задачи - по одной задаче для каждого пользователя из множественной переменной:

Нажмите на рисунок, чтобы увеличить


  Чтение информации о всех товарных позициях сделки

Пример приведен в уроке Информация о товарной позиции.



Курсы разработаны в компании «1С-Битрикс»
Спасибо, мы рады что смогли помочь Вам. Ниже Вы можете оставить свой отзыв или пожелание :)
Нам жаль это слышать… Но мы постараемся быть лучше!

Мы благодарны Вам за помощь в улучшении документации.

Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас