Правило

Правило — одна автоматизация: событие, с которого она начинается, и всё, что Gigonom делает после него. Страница для владельца и администраторов организации: как создать правило, собрать его на холсте, включить и удалить.

Как устроено правило

Правило рисуется на холсте как схема из узлов, соединённых связями. Узел — один шаг правила. Над именем узла написан его вид.

• Триггер. Событие, с которого правило начинается, например «Сделка создана». Триггер в правиле один, связи в него не входят.
• Действие. Шаг, который что-то меняет: назначает ответственного, создаёт задачу, выставляет счёт.
• Чтение. Шаг, который ничего не меняет, а достаёт данные: сделку, задачу, контакты компании.
• Узлы управления. «Если», «Развилка», «Слияние», «Для каждого», «Ждать» и «Остановить» решают, по какой ветке и когда правило идёт дальше.

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

Создать правило

1. Откройте «Автоматизации» и нажмите «Новая автоматизация».
2. В поле «Когда» выберите событие. События сгруппированы по сервисам.
3. В поле «Название» напишите, что делает правило. Поле можно оставить пустым, тогда правило получит название события.
4. Нажмите «Создать».

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

Собрать правило на холсте

Слева на странице правила расположен холст, справа — панель. Пока ни один узел не выбран, в панели видны свойства правила: название, переключатель «Включено», «Разделы», «Автор» и «Изменил».

• Добавить следующий шаг. Нажмите «+» рядом со свободным выходом узла. Откроется окно «Добавить узел» с поиском. Выберите узел, и он встанет справа, уже связанный с предыдущим.
• Добавить узел отдельно. Кнопка «Добавить узел» в левом нижнем углу холста ставит узел без связи. В окне узлы разложены по группам: «Управление» и сервисы. У узлов чтения стоит пометка «чтение».
• Связать узлы. Потяните связь от точки выхода одного узла к точке входа другого. Из одного выхода можно провести несколько связей, тогда ветки выполняются по очереди.
• Удалить узел или связь. Выберите узел или связь и нажмите Delete или Backspace. Узел удаляется вместе со своими связями.
• Навести порядок. Кнопка «Расставить» раскладывает узлы слева направо от триггера. Узлы можно двигать и вручную.

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

Если удалить узел события, кнопка «Добавить узел» сменится кнопкой «Выбрать событие». Пока события нет, правило не сохранится.

Настроить узел

Нажмите на узел, и в панели справа откроются его параметры.

• Имя узла. Верхнее поле. Имя видно на холсте, в журнале запусков и в подстановках данных. Имена в правиле не повторяются: к совпавшему имени Gigonom допишет номер.
• Параметры. У каждого узла свои. Обязательные отмечены звёздочкой. Участника, воронку, этап и ключ приёма выбирают из списка.
• «Если узел упал». Есть у действий и чтения. «Остановить запуск» заканчивает запуск ошибкой. «Продолжить с пустыми данными» пропускает неудачный шаг, и правило идёт дальше.
• «Выключить узел — данные идут насквозь». Выключенный узел остаётся на холсте, но не выполняется: правило проходит его без изменений. Так удобно временно отключить один шаг.
• «Удалить узел». Кнопка внизу панели.

Параметры узла коротко повторяются на самом узле, поэтому правило читается прямо с холста.

Подставить данные из события и других узлов

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

1. Рядом с полем параметра нажмите кнопку с фигурными скобками. Подсказка на ней: «Вставить данные из узлов выше».
2. В списке выберите узел и его поле. Узлы стоят под своими именами, первым идёт событие. Поиск находит поле по названию.

Если в поле появилась плашка вида «Сделка создана · название», данные подставлены. Крестик на плашке убирает подстановку.

В списке есть только узлы, от которых к текущему ведёт связь, напрямую или через другие узлы. Пункт «сколько раз узел уже выполнялся» в группе «Запуск» пригодится внутри цикла.

В текстовом поле подстановку можно совместить со словами. Сначала впишите текст, например Перезвонить: , и только потом вставьте подстановку. Она допишется в конец текста и будет выглядеть как {{ event.title }}. Под полем Gigonom показывает, как он понял запись. Если вставить подстановку в пустое текстовое поле, она займёт его целиком и станет плашкой. При переименовании узла подстановки на него исправляются сами.

Сохранить и включить

После первой правки внизу появляется полоса «Есть изменения» с кнопкой «Сохранить». Нажмите её. Если появилось сообщение «Сохранено», правило записано.

Включите правило переключателем «Включено» в свойствах правила или переключателем «Вкл.» в списке правил. Переключатель срабатывает сразу, без кнопки «Сохранить». Включайте правило после сохранения: несохранённые правки холста при этом сбрасываются.

Выключенное правило на события не срабатывает. Запуски, которые ждали продолжения, при выключении отменяются, подробности на странице «Запуски».

Что проверяется при сохранении

Gigonom проверяет правило при каждой правке. Узел с ошибкой обведён красным, текст ошибки написан на узле и в панели. Пока ошибки есть, правило не сохраняется: при нажатии «Сохранить» Gigonom показывает первую из них.

Сломанное правило

Правило ломается, когда пропадает то, на что оно ссылается: участник ушёл из организации, удалена воронка или удалён этап, отозван ключ приёма.

В списке правил у такого правила стоит значок предупреждения, а под названием написана причина, например «Узел „Назначить ответственного“: Иван больше не в организации». На холсте значок предупреждения стоит на самом узле, а в его параметре вместо значения написано «Удалено или недоступно».

Сломанное правило не выключается само. Запуск доходит до действия с пропавшим значением и заканчивается статусом «Пропущено» с той же причиной; шаги до него выполняются. Условие, в котором стоит удалённый этап или воронка, перестаёт совпадать. Выберите в параметре новое значение и сохраните правило.

Удалить правило

1. Откройте правило и в меню действий в правом верхнем углу выберите «Удалить».
2. В окне «Удалить „<название>“?» нажмите «Удалить». В угловых скобках то, что на экране заменено названием вашего правила.

Если открылся список правил и правила в нём нет, оно удалено.

Что видит участник

Участник открывает любое правило и его журнал, двигает холст и нажимает «Расставить», но раскладка у него не сохраняется. Параметры узлов и переключатель «Включено» у него неактивны, а в свойствах правила написано «Только просмотр — меняют владелец и администраторы». Кто может менять правила, сказано на странице «Участники и роли», раздел «Роли».