AddVarLocal

AddVarLocal — изменяет значение локальной переменной, не заменяя его полностью.

📝 Назначение

Используется для накопления данных внутри одного триггера: счётчиков, списков, конкатенации строк. В отличие от SetVarLocal, эта реакция изменяет существующее значение, а не перезаписывает.

🟢 Важно: Если переменная не существует, AddVarLocal создаст её — но не просто запишет значение, а добавит его к нулевому значению выбранного типа. Подробнее — в разделе «Добавление в несуществующую переменную» ниже.

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

• Подсчёт количества итераций в цикле
• Накопление суммы в процессе обработки
• Добавление элементов в массив
• Конкатенация строк (добавление текста в конец)

🔄 Поведение в зависимости от типа

Что произойдёт, зависит от типа текущего значения переменной:

⚠️ Особенность логического типа: Добавление к логическому значению — это переключение. Само добавляемое значение при этом не учитывается: и true, и false дадут один и тот же результат — противоположный текущему.

Когда типы не совпадают:

⚙️ Параметры

🔗 Слияние списков

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

💡 Совет: Для истории, лога или накопления записей нужен включённый переключатель. Выключенный удобен, когда каждая запись сама по себе список — например, пара «дата, сумма».

⚠️ Важно: На объекты переключатель не влияет: объекты всегда объединяются по ключам. Если нужна полная замена объекта — это уже SetVarLocal.

🆕 Добавление в несуществующую переменную

Если переменной ещё нет (или её значение пустое — например, пришло null из JSON), добавление выполняется к нулевому значению выбранного типа. Результат:

💡 Совет: Если нужно, чтобы первое добавление списка дало обычный плоский список, включите переключатель «Слияние списков» — тогда и первое, и последующие добавления будут работать одинаково.

📍 Доступ к значению

После выполнения реакции значение доступно по пути:

${var.local.название}

Примеры:

${var.local.counter}      # число (счётчик)
${var.local.items}        # массив
${var.local.log}          # строка (накопленный лог)

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

Пример 1: Счётчик в цикле (через TriggerFolder)

Задача: При каждом нажатии кнопки увеличивать счётчик.

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

1. AddVarLocal → название: clicks, значение: 1, тип: number (если переменной нет, она будет создана)
2. SendMessage → текст: Количество нажатий: ${var.local.clicks}

Результат:

• Первое нажатие → переменная создана, значение 1
• Второе нажатие → было 1, стало 2
• Третье нажатие → было 2, стало 3

Пример 2: Накопление суммы

Задача: В процессе обработки товаров в корзине накапливать итоговую сумму.

Реакции в триггере (для каждого товара):

1. AddVarLocal → название: total, значение: ${item_price}, тип: float
2. (После обработки всех товаров) SendMessage → Итого: ${var.local.total} ₽

Результат: Было 0 (переменная создана), добавить 150 → 150, добавить 200 → 350

Пример 3: Добавление элементов в массив

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

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

1. AddVarLocal → название: selected_ids, значение: ${product_id}, тип: number
2. (После завершения выбора) SendMessage → Выбраны товары: !{json|value: ${var.local.selected_ids}}

Результат:

• Первый товар (123) → переменной не было, создана со значением 123 (число, а не список!)
• Второй товар (456) → было 123, стало 579 — числа просто сложились

⚠️ Так делать нельзя. Тип значения описывает то, что добавляют, а не то, что должно получиться. Чтобы собрать именно список, нужен список и включённое слияние:

Правильный вариант:

1. SetVarLocal → название: selected_ids, значение: пусто (кнопка «Пропустить»), тип: array json
2. AddVarLocal → название: selected_ids, значение: [${product_id}], тип: array json, слияние списков: включено
3. (После завершения выбора) SendMessage → Выбраны товары: !{json|value: ${var.local.selected_ids}}

Результат:

• Первый товар (123) → было [], стало [123]
• Второй товар (456) → стало [123, 456]
• Третий товар (789) → стало [123, 456, 789]

💡 Совет: Начальный SetVarLocal с пустым значением здесь не обязателен — при включённом слиянии первое добавление и так создаст список [123]. Но с ним понятнее, и переменная существует с самого начала.

Пример 4: Конкатенация строк (лог действий)

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

Реакции в триггере (при каждом действии):

1. AddVarLocal → название: action_log, значение: \n!{time|output_format: HH:mm:ss} - Выполнено действие, тип: string
2. (При завершении) SendMessage → текст: История действий:${var.local.action_log}

Результат:

• Первое действие → \n14:30:25 - Выполнено действие
• Второе действие → \n14:30:25 - Выполнено действие\n14:35:10 - Выполнено действие

Пример 5: Объединение JSON-объектов

Задача: Постепенно собирать объект с данными пользователя.

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

1. AddVarLocal → название: profile, значение: {"name": "Иван"}, тип: json
2. AddVarLocal → название: profile, значение: {"age": 30}, тип: json
3. AddVarLocal → название: profile, значение: {"city": "Москва"}, тип: json
4. SendMessage → текст: Данные: !{json|value: ${var.local.profile}}

Результат:

{
  "name": "Иван",
  "age": 30,
  "city": "Москва"
}

⚠️ Важно: Объединение выполняется поверхностно. Вложенные объекты заменяются, а не объединяются.

🔄 Разница между AddVarLocal и SetVarLocal

💡 Совет: Используйте AddVarLocal для накопления (счётчики, списки, лог). Используйте SetVarLocal для установки начального значения или полной замены.

🔗 Связанные реакции

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