Задача планировщика "Обработка входящей почты"

Добавление задачи планировщика "Обработка входящей почты"

Описание

Задача планировщика "Обработка входящей почты" предназначена для настройки фоновой автоматической обработки писем, поступающих на сервер входящей почты, по установленному расписанию. В задаче планировщика задаются параметры обработки входящих писем.

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

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

Место настройки в интерфейсе

Меню навигации "Настройка системы" → настройка "Планировщик задач".

Выполнение действия

На странице "Планировщик задач" нажмите Добавить задачу заполните поля на форме добавления и нажмите Сохранить.

Поля на форме добавления:

  • Тип задачи — "Обработка входящей почты".
  • Название — название задачи, используемое в системе. По умолчанию совпадает с типом, название можно изменить.
  • Код — уникальный код задачи планировщика. Значение заполняется автоматически (транслитерация названия задачи при переводе фокуса с поля "Название"), код можно изменить.
  • Описание — дополнительная информация о задаче и ее назначении.
  • Максимальное количество писем, получаемых за период — максимальное количество писем, получаемых за определенный период. Период указывается в расписании задачи планировщика, см. Планировщик задач. Если задано несколько периодов, то учитывается минимальный из них.
  • Максимальное количество писем, обрабатываемых за период — максимальное количество писем, обрабатываемых за период. Период указывается в расписании задачи планировщика. Если задано несколько периодов, то учитывается минимальный из них.

  • Сохранять в системе исходное письмо после обработки:

    • флажок снят — исходное письмо после обработки не сохраняется;
    • флажок установлен — исходное письмо после обработки сохраняется и присоединяется к письму в виде файла.

    Стандартный скрипт обработки почты работает только при условии, если установлен флажок "Сохранять в системе исходное письмо после обработки" .

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

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

    Описание работы с метками приведено в разделе Метки.

Результат настройки

Новая задача отобразится в списке задач планировщика.

Для выбранного подключения ссылка на задачу планировщика отображается на странице "Параметры подключения" → вкладка "Входящая почта" .

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

Карточка задачи планировщика "Обработка входящей почты"

Параметры задачи планировщика "Обработка входящей почты" хранятся в карточке задачи планировщика.

Переход на карточку

В меню навигации выберите "Настройка системы" → "Планировщик задач", затем на странице "Задачи планировщика" нажмите на строку с названием задачи.

Содержание карточки

Карточка задачи планировщика "Обработка входящей почты" содержит:

  • Блок "Свойства" — в блоке отображаются параметры задачи "Обработка входящей почты", указанные при настройке задачи.
  • Блок "Расписание", в котором отображается список правил выполнения задачи.
  • Блок "Параметры выполнения" — в блоке отображаются сведения о выполнении задачи планировщика:
    • "Дата последнего выполнения задачи" — дата последнего выполнения заполняется автоматически после каждого запуска задачи.
    • "Плановая дата выполнения" — дата и время ближайшего запуска задачи планировщика рассчитывается по совокупности правил, добавленных в расписание.
    • "Количество сообщений в очереди на обработку" — количество сообщений в очереди на обработку. Сообщения, обработанные со сбоем, не учитываются.
    • "Количество сообщений, обработанных со сбоем" — количество сообщений, обработанных со сбоем.

Чтобы вернуться к списку задач планировщика, перейдите по ссылке "назад".

Действия на карточке

  • Запуск задачи планировщика (кнопка Выполнить сейчас на панели действий карточки), подробнее в разделе Планировщик задач).
  • Редактирование задачи планировщика (кнопка Редактировать на панели действий карточки).
  • Удаление задачи планировщика (кнопка Удалить на панели действий карточки).
  • Настройка правил выполнения задачи (блок "Расписание", подробнее в разделе Планировщик задач.

Удаление задачи планировщика "Обработка входящей почты"

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

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

Для удаления задачи в таком случае необходимо использовать API-метод api.scheduler.deleteTask, который также удалит сообщения, мешающие удалению задачи. Описание метода приводится в разделе api.scheduler Работа с планировщиком.