Шаг «Изменить переменную»
Шаг «Изменить переменную» может записать новое значение, очистить его или изменить с учётом текущего значения. Например, можно увеличить счётчик, добавить текст в конец строки или добавить элемент в массив.
Выберите переменную
Добавьте шаг через каталог, выберите его на схеме и откройте поле «Переменная». Откроется окно выбора переменной. Выберите вкладку:
- «Процесс» — значение используется только внутри одного запуска;
- «Проект» — общее значение проекта, которое видят все его процессы;
- «Лид» — значение сохраняется у текущего лида и доступно следующим процессам;
- «Диалог» — значение сохраняется в текущей переписке и доступно следующим процессам в ней.
Фоновая автоматизация не имеет текущего лида и диалога, поэтому вкладки «Лид» и «Диалог» в ней не показываются.
В окне можно найти переменную по имени или описанию либо нажать кнопку создания.
Нажмите «Выбрать» рядом с нужной переменной. Окно закроется, а поле шага покажет её область и имя.
Если переменной ещё нет, создайте её через это же окно. Для процесса достаточно имени; для проекта, лида и диалога нужно заполнить определение переменной. Порядок создания со скриншотами описан в статье о переменных автоматизации.
После выбора или создания переменной процесса укажите в настройках шага её тип: текст, число, «Да / Нет», дата, массив, объект или JSON. Тип переменной лида, диалога или проекта берётся из её определения.
Выберите, как изменить значение
Сначала выберите операцию. Для всех типов доступны:
- «Установить» — заменить текущее значение;
- «Очистить» — убрать значение;
- «Установить, если не задано» — записать значение, только если переменная пока пуста.
Дополнительные операции зависят от типа:
- текст: добавить в конец или в начало;
- число: увеличить или уменьшить;
- «Да / Нет»: переключить на противоположное значение;
- дата: установить текущую дату и время или сдвинуть дату вперёд/назад на минуты, часы или дни;
- массив: добавить элементы в конец или в начало, добавить только отсутствующие элементы либо удалить совпадающие элементы;
- объект: добавить или обновить поля, удалить поля;
- JSON: только три универсальные операции.
Операции «Очистить», «Переключить» и «Установить текущую дату» не требуют дополнительного значения. Для остальных заполните поле «Значение». Можно ввести его вручную или вставить совместимую переменную.
Операция «Добавить только отсутствующие элементы» сравнивает элементы целиком. Уже существующие строки, числа, логические значения, массивы или объекты повторно не добавляются; новые элементы помещаются в конец в указанном порядке.
Если операция допускает несколько представлений значения, над ним появится поле «Тип значения». Укажите, что именно передаёте: текст, число, «Да / Нет», дату, массив, объект или JSON. Когда операция принимает только один тип, кабинет выбирает его сам и это поле не показывает.
Для сдвига даты вперёд или назад выберите единицу изменения: минуты, часы или дни.
Измените поле внутри переменной
Если в объекте или массиве нужно изменить только одно поле, нажмите карандаш у выбора переменной и укажите путь, например run.customers.0.name. Правила записи вложенных значений описаны в статье о переменных.
Значение переменной процесса применяется внутри текущего запуска. Значение лида, диалога или проекта сохраняется и остаётся доступным после его завершения.
Изменение переменной проекта влияет не только на текущий процесс. Перед публикацией проверьте, какие агенты и другие автоматизации используют то же имя.
Что проверяется перед запуском
Область, имя, тип и операция обязательны. Значение обязательно только для операций, которым оно нужно. Для переменных проекта, лида и диалога публикация также проверяет, что определение существует в текущем проекте. Для переменной процесса отдельное определение не требуется.