Переменные
Переменные — раздел для длительного хранения различных типов данных длительное время. Это возможность создавать пользовательские переменные, и заполнять их значениями. С помощью функции эти данные вы сможете присвоить к каждому отдельному пользователю.
Типы
| Тип | Описание |
|---|---|
| Пользователь | переменная пользователя бота, доступен везде. |
| Участник/подписчик | переменная участника чата, доступен в конкретном чате. У каждого пользователя свой параметр в конкретном чате |
| Группа/канал | переменная чата, доступен всем в конкретном чате, един для всех в конкретном чате. |
| Динамические | временная переменная, которая живет непродолжительный промежуток времени и автоматически обновляется при выполнении условий |
| Глобальные | единая переменная для всех пользователей в боте. |
Параметры
Интерфейс
| Тип | Описание |
|---|---|
| Логический | хранение параметр профиля: ✅ or 🚫 |
| Целое число | хранение данные в числовом формате (прим: 123, 777, 315) |
| Дробное число | хранение числовых данных в дробном формате (прим: 11.3, 25.24, 111,57) |
| Строка | хранение данные в текстовом формате (прим: абс, 123, text) |
| json | хранение сразу целых разделов данных (прим: сохранить весь раздел ${update} |
| yaml | хранение объектов языка программирования yaml |
| Список json | хранение списков объектов json |
| Список yaml | хранение списков объектов yaml |
Загрузить или отобразить содержимое переменной можно 2 способами:
- С помощью реакции ⚡getVarCloud и переменной
${var.тип переменной.название переменной}- Не рекомендуется использовать, если нужно загрузить значение только одной переменной
- С помощью макроса varcloud
Пример:
${var.person.number}${var.member.name}${var.chat.id}
Пользователь
Интерфейс
| Функция | Описание |
|---|---|
| Переименовать | Изменение название переменной по которой будет доступно значение переменной |
| Описание | Описание переменной |
| Время хранения | Длительность жизни значения переменной, через которое, значение станет автоматически недоступно. Максимально сейчас можно установить 7 суток. Дату можно ввести текстом в формате: 1д1ч1м1с |
| Удалить | Безвозвратное удаление переменной |
Переменная пользователя - переменная привязанная к пользователям бота. значение переменной всегда одинаковой, независимо от того, где пользователь будет обращаться к боту, будь то личный чат с ботом или чат.
После использования реакции ⚡getVarCloud, значение переменной будет
доступно по адресу: ${var.person.названиеПеременной}
Участник-подписчик
Интерфейс
| Функция | Описание |
|---|---|
| Переименовать | Изменение название переменной по которой будет доступно значение переменной |
| Описание | Описание переменной |
| Время хранения | Длительность жизни значения переменной, через которое, значение станет автоматически недоступно. Максимально сейчас можно установить 7 суток. Дату можно ввести текстом в формате: 1д1ч1м1с |
| Удалить | Безвозвратное удаление переменной |
Переменная участник/подписчик - переменная привязывается к пользователю и к чату. Значение переменной будет меняться в зависимости от места, где она будет вызываться.
После использования реакции ⚡getVarCloud, значение переменной будет
доступно по адресу: ${var.member.названиеПеременной}
Группа-канал
Интерфейс
| Функция | Описание |
|---|---|
| Переименовать | Изменение название переменной по которой будет доступно значение переменной |
| Описание | Описание переменной |
| Время хранения | Длительность жизни значения переменной, через которое, значение станет автоматически недоступно. Максимально сейчас можно установить 7 суток. Дату можно ввести текстом в формате: 1д1ч1м1с |
| Удалить | Безвозвратное удаление переменной |
Переменная группа/канал - переменная привязывается к группе или каналу. Значение переменной будет меняться в зависимости от места, где она будет вызываться.
После использования реакции ⚡getVarCloud, значение переменной будет
доступно по адресу: ${var.chat.названиеПеременной}
Динамические
Интерфейс
В процессе написания
| Функция | Описание |
|---|---|
| Переименовать | Изменение название переменной по которой будет доступно значение переменной |
| Описание | Описание переменной |
| Время хранения | Длительность жизни значения переменной, через которое, значение станет автоматически недоступно. Максимально сейчас можно установить 7 суток. Дату можно ввести текстом в формате: 1д1ч1м1с |
| Удалить | Безвозвратное удаление переменной |
Глобальные
Интерфейс
В процессе написания
| Функция | Описание |
|---|---|
| Переименовать | Изменение название переменной по которой будет доступно значение переменной |
| Описание | Описание переменной |
| Время хранения | Длительность жизни значения переменной, через которое, значение станет автоматически недоступно. Максимально сейчас можно установить 7 суток. Дату можно ввести текстом в формате: 1д1ч1м1с |
| Удалить | Безвозвратное удаление переменной |
Рекомендации при работе с переменными
Рекомендуется
Использовать в названии параметров переменной только строчные и заглавные буквы: sum, text, SumText, ProfileText.
Не рекомендуется
- Использовать в названиях параметров переменной: символы, цифры, эмодзи, пробелы.
- Использовать одинаковые названия параметров переменной.
- Использовать параметры переменной для хранения временных значений. Для хранения таких значений необходимо использовать локальные переменные.
- Использовать параметры переменной для хранения значений, одинаковых для всех пользователей бота. Для хранения таких значений необходимо использовать глобальные переменные.
Реакции
| Реакция | Описание |
|---|---|
| SetVarCloud | Задать значение переменной |
| AddVarCloud | Изменить значение переменной |
| DelVarCloud | Удалить значение переменной |
| GetVarCloud | загрузить значение переменной |