Локальные переменные

Локальные переменные — это временные переменные, которые существуют только в рамках выполнения текущего триггера. После завершения триггера (включая Глобальный Триггер После) они автоматически удаляются.

Что такое локальные переменные

Локальные переменные — это переменные, которые создаются, изменяются и удаляются в процессе работы триггера.

Ключевые особенности:

💡 Совет: Используйте локальные переменные для промежуточных вычислений, временного хранения данных из API, формирования сложных структур перед сохранением.

Когда использовать

⚠️ Важно: Если данные нужно сохранить между разными вызовами бота (через 5 минут, при следующем сообщении) — используйте облачные переменные.

Доступные реакции

Типы значений

В реакциях SetVarLocal и AddVarLocal тип значения выбирается вручную — ровно один из восьми. Автоопределения нет, без выбранного типа реакцию сохранить нельзя.

⚠️ Важно: Значение должно соответствовать выбранному типу. Текст abc с типом number или число 3 с типом array json — ошибка, реакция не выполнится.

Пустое значение

Значение можно не указывать: при создании реакции есть кнопка «Пропустить», при редактировании — «Сбросить». Пустое значение превращается в нулевое значение выбранного типа.

⚠️ Частая ошибка: Пустым считается и результат подстановки. Если в значении написано ${var.local.чего-нет}, подстановка даст пустоту, и переменная получит нулевое значение, а не ошибку. Проверяйте имена переменных внутри значения, а для подстраховки указывайте запасное значение: ${var.local.count|default: 0}.

Пути и индексы

⚠️ Важно: Запись по номеру работает только для уже существующей позиции — новый элемент так не появится. Чтобы пополнить список, применяйте AddVarLocal к самому списку, а не к номеру внутри него. По этой же причине список нельзя создать через путь: items.0 его не создаст, список нужно сначала установить целиком.

Путь из переменной

Вычисляемый путь работает не только при чтении, но и в поле «Название» у SetVarLocal, AddVarLocal и DelVarLocal. Значит, можно записать или удалить элемент, номер которого известен только во время выполнения.

Пример: внутри цикла For заменить текущий элемент списка.

1. SetVarLocal → название: items[${loop.i}], значение: обработано, тип: string

Номер может вычислять и макрос — например, следующий элемент списка:

items[!{math|${loop.i} + 1}]

⚠️ Важно: В поле «Название» обёртка ${...} вокруг всего значения означает «взять название из переменной». Запись ${var.local.field} создаст переменную с названием, которое лежит в field, а не переменную var.local.field.

⚠️ Важно: Если путь после подстановки получился неправильным — например, ${loop.i} пуст или переменной из пути не существует — реакция завершится ошибкой, и её будет видно в логах бота.

Максимальная длина пути — 256 символов, вместе с подстановками.

Сравнение с облачными переменными

💡 Совет: Правило большого пальца — если данные нужны только внутри одного обработчика команды, используйте локальные переменные. Если данные нужны позже (при следующем сообщении или через час) — используйте облачные.

Примеры использования

Пример 1: Промежуточное вычисление скидки

Задача: Рассчитать итоговую сумму с учётом скидки 15% и отправить пользователю.

Реакции в триггере:

1. GetVarCloud → загружаем cart_total (облачная переменная)
2. SetVarLocal → название: discount, значение: !{math|${var.person.cart_total} * 0.15}
3. SetVarLocal → название: final, значение: !{math|${var.person.cart_total} - ${var.local.discount}}
4. SendMessage → текст: Итого к оплате: ${var.local.final} ₽ (скидка ${var.local.discount} ₽)

Пример 2: Сборка JSON перед отправкой в API

Задача: Собрать данные пользователя в JSON и отправить через HTTP-запрос.

Реакции в триггере (подготовка к SendRequest):

1. GetVarCloud → загружаем name, email, phone
2. SetVarLocal → название: payload, значение: {"name": "${var.person.name}", "email": "${var.person.email}", "phone": "${var.person.phone}"}
3. SendRequest → тело запроса: ${var.local.payload}

Пример 3: Формирование сложного сообщения

Задача: Собрать отчёт из нескольких переменных.

Реакции в триггере:

1. GetVarCloud → загружаем balance, orders_count, last_order_date
2. SetVarLocal → название: report, значение: Ваш баланс: ${var.person.balance} ₽\nКоличество заказов: ${var.person.orders_count}\nПоследний заказ: ${var.person.last_order_date}
3. SendMessage → текст: ${var.local.report}

Пример 4: Кэширование результата макроса

Задача: Случайное приветствие — сгенерировать один раз и использовать в нескольких местах триггера.

Реакции в триггере:

1. SetVarLocal → название: greeting, значение: !{random.select|list: Привет!, Здравствуй!, Добрый день!}
2. SendMessage → текст: ${var.local.greeting} ${user.name}
3. SendMessage → текст: ${var.local.greeting} Рады тебя видеть!

💡 Совет: Без локальной переменной макрос !{random.select} выполнялся бы дважды, и приветствия могли бы быть разными.

Связанные разделы