#Переменная

This feature is provided by the commercial plugin «Рабочий процесс: Пользовательская переменная», please purchase to use

#Введение

Вы можете объявлять переменные в рабочем процессе или присваивать значения уже объявленным переменным. Обычно это используется для временного хранения данных внутри рабочего процесса.

#Создание узла

В интерфейсе настройки рабочего процесса нажмите кнопку «плюс» («+») в потоке, чтобы добавить узел «Переменная»:

#Настройка узла

#Режим

Узел переменной похож на переменные в программировании: её необходимо сначала объявить, прежде чем её можно будет использовать и присваивать ей значения. Поэтому при создании узла переменной вам нужно выбрать её режим. Доступны два режима:

• Объявить новую переменную: Создаёт новую переменную.
• Присвоить значение существующей переменной: Присваивает значение переменной, которая была объявлена ранее в рабочем процессе. Это эквивалентно изменению значения переменной.

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

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

#Значение

Значение переменной может быть любого типа. Это может быть константа, например, строка, число, логическое значение или дата, либо другая переменная из рабочего процесса.

В режиме объявления установка значения переменной эквивалентна присвоению ей начального значения.

В режиме присвоения установка значения переменной эквивалентна изменению значения объявленной целевой переменной на новое. Последующие использования будут получать это новое значение.

#Использование значения переменной

В последующих узлах после узла переменной вы можете использовать значение переменной, выбрав объявленную переменную из группы «Переменные узла». Например, в узле запроса используйте значение переменной в качестве условия запроса:

#Пример

Узел переменной особенно полезен в ветвлениях, где новые значения вычисляются или объединяются с предыдущими (подобно операциям reduce/concat в программировании), а затем используются после завершения ветвления. Ниже приведён пример использования циклического ветвления и узла переменной для объединения строки получателей.

Сначала создайте рабочий процесс, запускаемый по событию в коллекции. Он будет срабатывать при обновлении данных в коллекции «Статьи» и предварительно загружать связанные данные «Автор» (для получения получателей):

Затем создайте узел переменной для хранения строки получателей:

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

Внутри циклического ветвления сначала создайте узел вычисления, чтобы объединить текущего автора с уже сохранённой строкой авторов:

После узла вычисления создайте ещё один узел переменной. Выберите режим присвоения, в качестве цели присвоения укажите узел переменной получателя, а в качестве значения — результат узла вычисления:

Таким образом, после завершения циклического ветвления переменная получателя будет содержать строку получателей всех авторов статьи. Затем, после цикла, вы можете использовать узел HTTP-запроса для вызова API отправки почты, передав значение переменной получателя в качестве параметра получателя для API:

На этом простая функция массовой рассылки электронной почты реализована с использованием циклов и узлов переменных.