Перейти к содержимому

Подключения, порядок и проверка правил ​

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

Подключите правило ​

  1. Создайте и сохраните правило в нужном личном или организационном контексте.
  2. Откройте его вкладку «Входящие каналы». Пока подключений нет, она называется «Входящие каналы (не настроены)».
  3. Выберите канал и нажмите «Подключить».
  4. Перейдите к правилам этого канала и проверьте порядок и статус подключения.

Другой путь: в карточке входящего канала откройте «Правила обработки» и используйте «Подключить правило из каталога».

Подключение использует сохранённую версию определения. Несохранённые изменения формы не начинают работать от нажатия «Подключить».

Расставьте порядок ​

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

Например, поставьте правило production + service_failed выше общего правила service_failed. Иначе общее правило первым заберёт событие production.

Задайте поведение без совпадения ​

Создайте в каталоге правило вида «Если другие правила не подошли» (правило по умолчанию), задайте действия без условий и подключите его к каналу. Оно появится в блоке «Если ни одно правило не подошло».

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

Если подходящего обычного правила и активного default нет, применяются базовые настройки канала. Default добавляет свои цели к базовым назначениям, а не заменяет их. Для полностью условного маршрута оставьте базовые назначения пустыми и подключите default для неизвестных событий, как в рецепте JSON. Без подходящего правила и активного default при пустой базе внешней отправки в личном контексте и назначений сотрудникам в организации не будет.

Проверьте сохранённую конфигурацию ​

На странице правил канала откройте «Проверить на примере». Выберите Content-Type и вставьте исходное тело запроса без изменения пробелов. Нажмите «Проверить».

Проверка выполняется сервером, но не сохраняет сообщение и не отправляет уведомления. Она показывает:

  • выбранную ветку: правило по условиям, default или настройки канала;
  • порядок проверок и причины пропуска;
  • рабочий текст после преобразований и итоговый текст после шаблона;
  • извлечённые переменные, важность и метки;
  • итоговое объединение базовых исходящих каналов и целей выбранного правила либо уникальных организационных получателей из обоих источников и основания назначения;
  • предупреждения, например отсутствующий JSON-путь, пустую команду или недоступного получателя.

Организационные получатели в результате — назначения сообщения. Это не подтверждение внешней доставки: она зависит от личных настроек сотрудника.

Список источников в настройках канала показывает все потенциальные назначения подключённых правил, включая отключённые. Результат проверки конкретного события включает базовые цели и дополнительные цели только выбранного правила. Это разные списки: видимый источник ещё не означает участие в обработке этого события.

Проверьте черновик ​

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

Если правило не подключено, для проверки доступно временное подключение и его положение в порядке. Для default временная замена показана отдельно. Эти изменения не сохраняются.

Проверка всё равно учитывает другие правила канала. Если раньше совпало другое, именно оно выиграет. Смотрите выбранную ветку, а не только итоговый текст.

Успешный тест черновика не означает, что реальная отправка уже использует его: сохраните определение, подключите к каналу и проверьте постоянный порядок.

Проверьте реальную отправку ​

Отправьте HTTP-запрос с тем же Content-Type и телом. Для защищённого канала добавьте Bearer-токен. HTTP 202 означает принятие, а не завершение внешней доставки.

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

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

Найдите правило в каталоге ​

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

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

Сохраните черновик перед уходом ​

Индикатор «Есть несохранённые изменения» относится к форме редактора. При переходе в другой раздел выберите «Отмена», чтобы остаться, «Не сохранять», чтобы отбросить черновик, или «Сохранить и продолжить», чтобы записать его перед переходом. Ошибка проверки или сохранения оставляет вас в редакторе.

Успешная проверка на примере не сохраняет определение. Новое правило после сохранения ещё нужно подключить к каналу. Перед перезагрузкой или закрытием вкладки сохраните форму явно: индикатор и окно перехода не означают хранения черновика между сеансами.

Изменение и обслуживание ​

ДействиеЧто меняется
Выключить правило в редактореНе работает ни в одном подключённом канале
«Отключить для этого канала»Не работает только в выбранном канале
«Убрать из канала»Удаляется подключение, определение остаётся в каталоге
«Создать копию»Создаётся независимое определение; его подключения нужно настроить отдельно
Изменить условия или действияНовые сообщения всех подключённых каналов используют сохранённую редакцию

Для удаления определения сначала уберите все его подключения. Старые сообщения при редактировании правил не пересчитываются; при разборе старого события смотрите сохранённые подробности обработки.

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

Для проверки текстовых операций используйте рецепт мониторинга и справочник действий. Результат реального приёма ищите в истории: личная карточка содержит полный снимок обработки, организационная — тексты и основания назначения.