Обработка коллекции

Рисунок 1. Пиктограмма функции

Общее описание функции

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

Сценарии использования

Индексация (нумерация) элементов коллекции производится по мере их добавления и начинается с единицы. Последний индекс соответствует количеству элементов.

Чтобы последовательно обработать все элементы коллекции, можно включить функцию обработки коллекции в цикл со счетчиком, ограниченным количеством её элементов.

Над коллекцией и её элементами можно производить указанные ниже действия. Каждому из действий соответствует один из пунктов списка, доступного для выбора в поле Действие окна свойств функции.

Получить число элементов в коллекции: Возвращает в целочисленную переменную число элементов в переменной-коллекции.
Добавить элемент: Позволяет добавить в коллекцию элемент, значение которого указано явно или соответствует значению переменной бизнес-процесса. Тип данных элемента должен соответствовать типу коллекции. Количество элементов в коллекции при этом увеличится на единицу, а новый элемент получит соответствующий ему номер (последний).
Удалить элемент: Позволяет удалить из коллекции элемент с указанным индексом.
Получить элемент: Позволяет присвоить значение любого элемента коллекции переменной бизнес-процесса, тип которой соответствует типу элементов коллекции.
Очистить коллекцию: Удаляет из коллекции все элементы.
Изменить элемент: Позволяет присвоить элементу коллекции с соответствующим индексом значение какой-либо переменной бизнес-процесса, тип которой соответствует типу коллекции.
Добавить несколько элементов: Позволяет добавить в исходную коллекцию все переменные какой-либо коллекции, если их типы данных совпадают.
Значение добавляемой коллекции должно соответствовать значению переменной бизнес-процесса, а количество элементов в исходной коллекции при выполнении действия увеличится на число элементов добавляемой коллекции.
Вставить элемент: Позволяет вставить в коллекцию элемент с указанным индексом.
Содержит элемент: Позволяет проверить, содержит ли коллекция некоторый элемент, значение которого указано явно или соответствует значению переменной бизнес-процесса.
Результатом выполненного действия является переменная бизнес-процесса типа Да/Нет.

Настройка параметров

Рисунок 2. Окно "Обработка коллекции". Вкладка "Параметры"

На вкладке Параметры окна свойств функции указываются параметры обработки переменных-коллекций — переменная, действие над ней, вспомогательные параметры обработки. Для полного определения функции необходимо указать на этой вкладке следующие параметры, в некоторых случаях не все параметры обязательны для описания:

Переменная-коллекция

Объявленная в бизнес-процессе переменная-коллекция для обработки.

Действие

Одно из перечисленных выше действий, которые можно выполнять с переменной-коллекцией.

Переменная

Поле предназначено для указания переменной, в которую будет возвращаться:

Число элементов в коллекции — целочисленная переменная.
Переменная, значение которой будет добавлено в коллекцию, присвоено одному из элементов коллекции.
Переменной, которой будет присвоено значение одного из элементов коллекции. Тип переменной должен соответствовать типу элементов коллекции.

Индекс

Порядковый номер (индекс) элемента коллекции, предназначенного для удаления, для присвоения его значения другой переменной или для изменения его значения (см. выше).