Перейти к содержанию

Действия

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


Действия являются частью Пользовательских команд.


Интерфейс настроек#

У каждого действия вне зависимости от её типа есть определенный набор общих настроек:

action

Интерфейс настроек действий
  • Название действия — название действия для отображения во вкладке и в списках выбора действия;

  • UUID действия (иконка "i") — уникальный идентификатор действия в рамках команды, используемый в шаблонах сообщений;

  • Тип действия — выбор типа действия, подробное описание которых вы найдете в подразделах;

  • Краткое описание — краткое описание действия, которое отображается в списках выбора действия;

  • Переопределить права доступа — включение этого параметра потребует проверки определённых прав доступа к этому действию в дополнение прав доступа самой команды.


Типы действий#

  1. Отправка сообщения — на запуск такого действия бот ответит указанным текстом или панелью (embed).

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

  3. Встроенная команда — запуск такого действия запустит встроенную команду, указанную в поле шаблона. Например, если вы создадите команду с именем я, а в шаблоне действия напишете юзер, вызов команды будет аналогичен вызову встроенной команды !юзер.

  4. Выполнение кода шаблона — запуск такого действия просто выполнит указанный в шаблоне код и ответит стандартным сообщением об успешном выполнении операции. Данный тип действия полезно использовать для запуска других действий в зависимости от каких-либо условий.


Запуск одного действия из другого#

Если вы продвинутый пользователь, способный справиться с расширенными возможностями шаблонов сообщений, Вы можете использовать тег run для запуска одного действия из другого. Как это делается подробно описано здесь.

Параметры#

Во все шаблоны действия передаётся переменная parameters, которая используется для получения переданных в действие параметров и для сохранения новых параметров для передачи их в Компоненты сообщения или другие запускаемые действия.

Компоненты сообщения хранят в себе все параметры, имеющиеся ранее и сохраненные в рамках отправки его собственного шаблона сообщения. Это значит, что действие, запускаемое компонентом, получит те же самые параметры, которые были в момент отправки сообщения с этим самым компонентом.

Внимание

Время жизни передаваемых из действия в компоненты параметров — 15 минут с момента последнего обращения к ним!


Вернуться наверх