БИТ.ФИНАНС

Диагностика механизма отправки оповещений на электронную почту

Информация, приведенная в статье, актуальна начиная с релиза 3.1.50. На более ранних релизах могут быть различия.
В процессе эксплуатации механизма отправки оповещений на электронную почту, либо его настройки могут возникнуть ситуации, когда оповещения не отправляются пользователю. В данной статье будет рассмотрен процесс диагностики и исправления основных проблем, которые могут возникнуть.

Глобально ошибка при отправке оповещений может произойти в трех случаях:

1. Не регистрируется событие оповещения
2. Некорректно обрабатывается событие оповещения
3. Проблема с отправкой оповещения

1. Не регистрируется событие оповещения
Для проверки регистрируется ли событие, необходимо в разделе "Настройки (БИТ)" -> "Управление оповещениями" открыть регистр "Регистрация событий для оповещений".
После чего вручную вызвать наступление события, то есть, если, например, проверяем оповещение с видом события "Записан документ", то необходимо записать документ. Исключением являются оповещения с видами событий:

1. Документы для визирования;
2. Напоминания по графику начислений;
3. Напоминания по графику платежей;
4. Окончание срока действия договора.

Для данных оповещений событие регистрируется при помощи регламентных заданий: "Регистрация оповещений о визировании" (для первого пункта) и "Регистрация напоминаний по договорам" (для остальных). Вручную регламентные задания можно запустить в разделе "Администрирование" -> "Обслуживание" -> "Регламентные и фоновые задания".
Если после наступления события в регистре "Регистрация событий для оповещений" не появилось новых записей, значит проблема локализована.
Проблемы с регистрацией могут возникать в следующих случаях:

1. В настройке установлен невыполнимый отбор;
2. Пользователь не указан в качестве получателя в настройке оповещения;
3. Пользователь указан в качестве получателя с логическим оператором "Кроме" ;
4. Настройка оповещения не назначена для объекта системы или назначена не для того объекта;
5. Установлен флаг "Не регистрировать повторно"
6. Некорректно отрабатывает регламентное задание.

Первые пять пунктов проверяются непосредственно в настройке оповещения.

1. Отборы устанавливаются на вкладке "Условия";
2-3. Пользователи на вкладке "Получатели";
4. Назначение объекту системы на вкладке "Назначение оповещения";
5. Флаг в шапке настройки оповещения.


Пятый пункт применяется не для всех оповещений, так как флаг "Не регистрировать повторно" есть только для отдельных видов событий. Он применяется для того, чтобы не регистрировать повторное наступление события. Иными словами, если ранее событие по объекту регистрировалось, то система не создаст в регистре новой записи при его повторном наступлении.
    Что касается регламентных заданий, то проблему можно разделить на два уровня: неправильная настройка или задание завершается с ошибкой.

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

    Для того, чтобы проверить возникает ли ошибка при выполнении задания, необходимо в разделе "Администрирование" -> "Обслуживание" -> "Регламентные и фоновые задания" запустить регламентное задание вручную и дождаться его окончания. Если есть ошибка при выполнении задания, она будет записана в поле "Сообщение".

    Некорректно обрабатывается событие оповещения
    После того, как событие было зарегистрировано, необходимо, чтобы оно было обработано при помощи регламентного задания "Обработка событий оповещений". При корректной обработке в регистре "Регистрация событий для оповещений" статус записи изменится с "Зарегистрировано" на "Обработано". Это корректное поведение программы.
    Если статус записи сменился на "Ошибка", то необходимо двойным щелчком раскрыть запись и посмотреть, из-за чего она произошла. Ошибка будет прописана в поле комментарий:
    Если же запись вовсе не обработалась (статус "Зарегистрировано"), то необходимо проверить выполнилось ли регламентное задание "Обработка событий регистрации оповещений". Это можно сделать в разделе "Администрирование" -> "Обслуживание" -> "Регламентные и фоновые задания".

    Ошибка при обработке записей может возникать в следующих случаях:

    1. У пользователя не заполнена электронная почта
    2. В качестве контактной информации в настройке оповещения указан неверный тип. Например, отправка идет пользователю, а указано "ФизЛицо.Email" вместо "Пользователь.Email".
    Если регламентное задание отработало корректно, но в регистре сведений "Оповещения" не появилось новой записи, то скорее всего в настройке оповещения указано невыполняющееся пользовательское условие на вкладке "Получатели".

    3. Проблема с отправкой оповещения
    Для того, чтобы проверить есть ли проблема непосредственно с отправкой, необходимо в первую очередь проверить включено ли выполнение регламентного задания "Отправка оповещений", а затем открыть раздел "Настройки (БИТ)" -> "Управление оповещениями" -> регистр "Оповещения".
    Записи обрабатываются при помощи регламентного задания "Отправка оповещений". Если обработка прошла корректно, то статус записи будет "Отправлено". Если отправки не произошло, то статус "Ошибка отправки".
    В последнем случае необходимо двойным нажатием открыть запись и посмотреть "протокол отправки".
    Проблемы могут возникнуть, если некорректно настроена доставка оповещений (например, учетная запись электронной почты/почтовый сервер) или, если есть оповещения для пользователей с флагом "Недействителен".
    Автор статьи
    Михаил Еремин
    И это все мы сделали для вас!
    Подписывайтесь на нашу рассылку и узнавайте об изменениях в релизах первыми
    Подписывайтесь на нашу рассылку и узнавайте обо всем первые!