Уведомления перейти к списку

Очередь e-mail-оповещений. Письма не отправляются мгновенно: события складывают их сюда (outbox), а фактическую отправку делает по расписанию консольная команда yii notify/send. Эта страница — админский контроль очереди: видно, что ждёт отправки, что уже ушло и что застряло с ошибкой.

Письма в очередь ставят:

  • смена статуса документа — оповещаются привязанные к документу сотрудники;
  • сторожевые правила (notifyRules + yii notify/watch) — например «документ завис в статусе “Новый” больше суток»;
  • администратор вручную (кнопка «Добавить»).

Весь механизм — опциональный и по умолчанию выключен; включение и все параметры описаны в настройке. Раздел доступен из меню настроек (шестерёнка).

Список

Очередь и отправленные письма, свежие сверху. Тема — ссылка на просмотр уведомления. Пустая колонка Отправлено означает «ещё в очереди»; ненулевые Попытки с текстом в Последняя ошибка — отправка не удаётся (чаще всего проблемы SMTP). Письмо, исчерпавшее лимит попыток, остаётся в списке для разбора и больше не отправляется само — см. «Редактирование».

Просмотр

Реквизиты очереди (получатель, ключ события, времена, попытки, ошибка) и само письмо — в том виде, в каком его увидит получатель.

Добавление

Обычно не требуется — письма ставит система. Но можно составить письмо вручную: выбрать получателя, тему и текст. Такое письмо уйдёт ближайшим прогоном notify/send независимо от выключателей механизма (ручное действие администратора).

Редактирование

Способ вмешаться в очередь:

  • сбросить счётчик попыток застрявшего письма (например, после починки SMTP) — оно снова начнёт отправляться;
  • поправить тему/текст/получателя, пока письмо не ушло.

Удаление

Удаление неотправленной записи отменяет письмо. Учтите: отправленные записи — это память механизма повторных напоминаний (по ним notify/watch понимает, что письмо по правилу уже уходило, и не спамит чаще интервала repeat); их чистит по возрасту команда notify/cleanup, вручную удалять их стоит только если хотите, чтобы напоминание пришло снова.

Атрибуты

Атрибут Описание
Идентификатор
id
Получатель
user_id
Сотрудник, которому адресовано письмо (адрес берётся из его поля E-Mail на момент отправки)
Ключ события
event_key
Ключ дедупликации: пока письмо не отправлено, повторное событие с тем же ключом обновляет его, а не создаёт новое. По отправленным записям с этим ключом notify/watch отсчитывает интервал повторного напоминания (repeat)
Тема
subject
Тема письма
Письмо
body
Готовый HTML-текст письма (формируется при постановке в очередь)
Поставлено в очередь
created_at
Когда письмо попало в очередь (или было обновлено повторным событием)
Дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ; можно выбрать в календаре.
Отправлено
sent_at
Время фактической отправки; пусто — письмо ещё в очереди
Дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ; можно выбрать в календаре.
Попытки
attempts
Число неудачных попыток отправки. Исчерпавшее лимит письмо остаётся в таблице для разбора; чтобы отправить его повторно (например, после починки SMTP) — обнулите счётчик
Последняя ошибка
last_error
Текст последней ошибки отправки (SMTP и т.п.)