Исполняемые модули

Исполняемые модули qnext - это такие разделы, которые выполняют какое-либо действие и возвращают результат своей работы. Существует несколько видов исполняемых модулей:

Реакции

⚡ Реакция — базовый исполняемый модуль. Выполняет различные действия при заданных условиях.

Примеры:

• Отправить сообщение(⚡️sendMessage)
• Удалить сообщение (⚡️deleteMessage)
• Запустить форму (⚡️formStart)

Сервис EnotPro предлагает широкий спектр реакций, полный список вы сможете найти на странице Реакции.

Ограничения

Ограничения позволяют задать условия, при которых ⚡ реакции будут выполняться (или не выполняться). Подробнее в документации Ограничения.

Макросы и Переменные

Макросы и Переменные - это такие исполняемые модули, которые выполняются внутри реакций прямо в реакции, и заменяют собой результат своей работы.

Переменные

Переменная - это путь к параметру, который нужно отобразить или получить.

Переменные имеют строгий вид отображения и должны выглядеть следующим образом: ${путь}.

Примеры переменных:

• ${user.name} - имя пользователя
• ${user.id} - ID пользователя
• ${update.message.text} - введенный текст
• ${update.message.message_id} - ID сообщения

Пример использования в реакции ⚡ SendMessage

Привет, ${user.name}, добро пожаловать!

Полный список переменных можно найти в логах. Подробнее в статье о реакции log.

Параметр: default

Параметр |default: text} отображает указанный текст, если переменная не существует (но не если она пуста). Параметр указывается через разделительную черту |

Пример применения:

• ${user.id|default: произвольный текст}
• ${update.message.text|default: произвольный текст}

Важно

Параметр срабатывает только при отсутствии переменной. Если переменная существует, но пуста (""), default не применяется.

Макросы

Макросы - мини-программы, похожие на переменные, но выполняющие преобразования и возвращающие результат. Например, чтобы показать текущую дату, вы можете воспользоваться макросом:

!{date}

Подробнее про макросы вы можете прочитать в документации Макросы.

Правила составления макросов:

• Начинается с !{ и заканчивается }
• Каждый параметр — одно значение
• Параметры разделяются точкой с запятой ;
• Рекомендация: разделять параметры новой строкой для удобства

  параметр: значение;
  параметр: значение;
  параметр: значение;

Параметр: default

Параметр default выводит текст по умолчанию, если результат макроса отсутствует (например, профиль пуст или параметр не найден).

Пример многострочного макроса

> !{var|
   type: value;
   name: Баллы;
   path: targetUser;
   default: текст по умолчанию
 }