Обработка коллекции
Функция предназначена для обработки переменных-коллекций, причем действие может производиться как одновременно над всеми членами коллекции, так и над любым из ее элементов.
Индексация (нумерация) элементов коллекции производится по мере их добавления и начинается с единицы; последний индекс соответствует количеству элементов.
Чтобы последовательно обработать все элементы коллекции, можно включить функцию обработки коллекции в цикл со счетчиком, ограниченным количеством ее элементов.
Над коллекцией и ее элементами можно производить следующие действия (каждому из которых соответствует один из пунктов списка, доступного для выбора в поле Действие окна свойств функции):
- пункт Получить число элементов в коллекции возвращает в целочисленную переменную число элементов в переменной-коллекции;
- пункт Добавить элемент позволяет добавить в коллекцию элемент (тип данных которого должен соответствовать типу коллекции), значение которого указано явно или соответствует значению переменной бизнес-процесса; количество элементов в коллекции при этом увеличится на единицу, а новый элемент получит соответствующий ему номер (последний);
- Удалить элемент позволяет удалить из коллекции элемент с указанным индексом;
- Получить элемент позволяет присвоить значение любого элемента коллекции переменной бизнес-процесса, тип которой соответствует типу элементов коллекции;
- пункт Очистить коллекцию удаляет из коллекции все элементы;
- Изменить элемент позволяет присвоить элементу коллекции с соответствующим индексом значение какой-либо переменной бизнес-процесса, тип которой соответствует типу коллекции;
- Вставить элемент;
- пункт Добавить несколько элементов позволяет добавить в исходную коллекцию все переменные какой-либо коллекции, если их типы данных совпадают; значение добавляемой коллекции должно соответствовать значению переменной бизнес-процесса, а количество элементов в исходной коллекции при выполнении действия увеличится на число элементов добавляемой коллекции;
- пункт Содержит элемент позволяет проверить, содержит ли коллекция некоторый элемент, значение которого указано явно или соответствует значению переменной бизнес-процесса; результатом выполненного действия является переменная бизнес-процесса типа Да/Нет.
Окно стандартных свойств функции помимо вкладки Общие, аналогичной этой же вкладке всех остальных функций, содержит вкладку Параметры (рис. 3.11), на которой указываются параметры обработки переменных-коллекций (переменная, действие над ней, вспомогательные параметры обработки). Для полного определения функции необходимо указать на этой вкладке следующие параметры (в некоторых случаях не все они обязательны для описания):
- Переменная-коллекция — объявленная в бизнес-процессе переменная-коллекция для обработки;
- Действие — одно из перечисленных выше действий, которые можно выполнять с переменной-коллекцией;
- Переменная: предназначено для указания переменной, в которую будет возвращаться число элементов в коллекции (целочисленная переменная), или переменной, значение которой будет добавлено в коллекцию, присвоено одному из элементов коллекции или которой будет присвоено значение одного из элементов коллекции (тип переменной должен соответствовать типу элементов коллекции);
- Индекс: содержит порядковый номер (индекс) элемента коллекции, предназначенного для удаления, для присвоения его значения другой переменной или для изменения его значения (см. выше).
Рис. 3.11. Функция обработки коллекций, вкладка Параметры
См. также |