Jump to content

Создание и использование пользовательских действий

Пользовательские действия - это хлеб и масло правил. Когда вы создаете пользовательское действие в правилах, выполняются две вещи.

  • Пользовательские действия могут запускаться или планироваться как любое другое действие из вкладки "Действия" у существующих правил.
  • Могут быть созданы новые правила, которые используют пользовательское действие как событие, через которое они запускаются.

Поэтому пользовательские действия позволяют строить полностью новые "процедуры обработки" правил, которые могут быть вызваны как одно действие. Фактически, вы решаете КОГДА пользовательское действие должно быть выполнено с использование правила, а затем вы также можете выбрать ЧТО ПРОИСХОДИТ, когда пользовательское действие выполнено с помощью других правил.

Создание нового пользовательского действия

Для создания пользовательского действия, посетите раздел настроек Правил "Действия" в вашем админцентре Система -> Правила. Нажмите кнопку Создать. Далее вам предстоит указать название вашего нового действия и его описание (необязательно). Эти данные в дальнейшем вы сможете изменить.

custom_action.png

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

  • Название аргумента: это название аргумента, которое будет использоваться в формах конфигурации правил.
  • Описание: краткое описание предоставляемых данных.
  • Тип аргумента: тип данных, которые должны быть предоставлены для аргумента.
  • Тип значения: если вы выбрали "объект" или "массив" в качестве типа аргумента, вы можете выбрать тип объекта (ов), который должен быть предоставлен.
  • Обязательно: укажите, будет ли ваше действие требовать эти данные.

Использование пользовательского действия

После того, как вы настроили пользовательское действие и какие-либо аргументы, которые ему понадобятся, вы можете начать создавать правила, которые будут определять, что происходит, когда действие будет предпринято. Когда вы создадите новое правило, в вашем списке событий будет доступно новое событие; это то, что вы будете использовать для программирования функций для вашего пользовательского действия. Вы можете создать столько правил, групп правил и/или наборов правил, сколько необходимо для выполнения цели вашего пользовательского действия.

Для вызова своего действия, просто добавьте его на вкладку "Действия" любого существующего правила, для которого оно должно быть применено.