Счетчик

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

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

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

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

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

На вкладке Параметры можно задать правила изменения переменной-счетчика:

Переменная

Целочисленная переменная, предназначенная для изменения значения (переменная-счетчик).

Шаг

Шаг изменения значения переменной-счетчика: целое число, которое может быть:

  • Положительным — при выполнении функции значение переменной-счетчика будет увеличиваться на значение шага.

  • Отрицательным — при выполнении функции значение переменной-счетчика будет уменьшаться на значение шага.

Группа из трех переключателей

Позволяет определить диапазон значений, которые может принимать переменная-счетчик:

  • Без границ — не накладывает каких-либо ограничений на диапазон значений переменной-счетчика.

  • Использовать заданные границы — позволяет определить границы диапазона, в которых может изменяться переменная-счетчик.

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

    • Конечное значение переменной-счетчика — может быть задано как с помощью целочисленной переменной бизнес-процесса, так и с помощью целого числа, указанного непосредственно в данном поле.

  • По индексам значений в переменной-коллекции — установленный переключатель означает, что значение переменной-счетчика будет изменяться столько раз, сколько элементов содержит указанная в следующем поле переменная-коллекция.
    При этом если указан положительный шаг (см. выше), то переменная-счетчик будет изменяться от единицы до числа элементов коллекции с заданным шагом.
    И наоборот, при отрицательном шаге изменение будет происходить от числа элементов в коллекции до 1 или ближайшего к 1 индекса, удовлетворяющего значению шага. Например, при 5 элементах в коллекции и шаге, равном 1, переменная-счетчик будет последовательно принимать значения 1, 2, 3, 4, 5. При шаге, равном –2: 5, 3, 1.

    • Переменная: указывает переменную-коллекцию бизнес-процесса, по индексам значений которой будет производиться изменение значений переменной-счетчика.
      Например, если переменная-коллекция типа карточка DV содержит пять элементов (карточек), то значение переменной-счетчика будет изменяться пять раз по числу элементов в коллекции.
      При этом порядок следования значений переменной-счетчика — прямой или обратный — зависит от шага см. пункт выше).

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