Автоматический импорт E-mail

Задача планировщика Check Inbound Mailboxes отвечает за автоматический импорт электронных писем в систему из групповых почтовых ящиков. Задача запускается через регулярные интервалы времени, настроенные в Планировщике, и проверяет все активные не персональные почтовые ящики для входящей почты на наличие новых писем.

Обзор

Задача импорта регулярно запускается Планировщиком. Для каждого не персонального активного входящего почтового ящика планировщик:

  • Проходит по каждой из отслеживаемых папок текущей учётной записи пользователя

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

    • При необходимости можно настроить извлечение только непрочитанных сообщений.

  • Импортирует каждое выбранное сообщение в таблицу emails.

  • Создаёт Обращение из каждого импортированного сообщения (если включён соответствующий параметр в настройках групповой учётной записи входящей почты).

  • Отправляет автоматические ответы, например, сообщения об отсутствии сотрудника на рабочем месте (если включён соответствующий параметр в настройках групповой учётной записи входящей почты).

  • Удаляет сообщения с почтового сервера после успешного импорта (если включён соответствующий параметр).

  • Обновляет метку времени последнего запуска импорта для учётной записи входящей почты и фиксирует дату (курсор) последнего импортированного дня у отслеживаемых папок почтовых ящиков входящей почты (при следующем выполнении задания Планировщика импорт начнётся с зафиксированной даты).

Как выбираются сообщения для импорта

  • Для каждого почтового ящика курсор mailbox_last_imported_days хранит дату последнего импорта (в формате Y-m-d).

  • При выполнении импорта курсор перемещается день за днем, начиная с сохраненной даты и до сегодняшнего дня ИЛИ пока не будет достигнуто пороговое значение количества импортированных писем за один запуск задания Планировщика.

  • Для каждой даты:

    • У почтового сервера запрашиваются сообщения за эту дату, после чего извлекаются все сообщения за этот день.

    • Проверяется UID сообщений во избежание создания дубликатов, если подобные сообщения уже присутствуют в локальной таблице emails.

  • По завершении задания Планировщика курсор обновляется.

Настройка параметров

Глобальные параметры импорта

Для настройки глобальных параметров импорта откройте Администрирование › Настройка основных параметров E-mail и перейдите к подразделу Параметры импорта электронной почты.

Глобальные параметры импорта электронной почты

Максимальное количество импортируемых писем при выполнении задания планировщика (на каждый почтовый ящик)

Пороговое количество писем, импортируемых за один запуск задания Планировщика для каждого почтового ящика входящей почты.

  • Параметр в файле конфигурации: email_import_per_run_threshold (целое число)

  • Параметр должен быть положительным целым числом.

  • По умолчанию: 25.

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

Период прошедшего времени, с которого начнется импорт электронных писем, когда для нового почтового ящика ещё не зафиксирован курсор (дата последнего импортированного дня).

  • Параметр в файле конфигурации: email_import_timeframe_start (строка)

  • Допустимый формат: отрицательное число и единица измерения — например, -30 дней, -3 месяца, -1 год.

  • Если значение не соответствует формату или отсутствует, система использует -30 дней.

Импортировать только непрочитанные письма

Извлечение с почтового сервера только непрочитанных сообщений.

  • Параметр в файле конфигурации: email_import_fetch_unread_only (логическое значение)

  • Если значение равно true, при импорте будут извлекаться только непрочитанные сообщения.

  • По умолчанию: false.

Параметры импорта учётных записей входящей электронной почты

Параметры импорта учётной записи входящей почты переопределяют описанные выше глобальные параметры импорта. Для настройки импорта откройте Администрирование › Входящие E-mail › Создать групповую учётную запись входящей почты (либо откройте уже существующую групповую учётную запись) и перейдите к подразделу групповых настроек.

Групповые настройки импорта электронной почты

Импортировать автоматически

Автоматический импорт писем для текущей учётной записи.

Перемещать письма в Корзину после импорта

Удаление сообщений с почтового сервера после успешного импорта.

Количество импортируемых писем за один запуск задания планировщика

Максимальное количество писем, импортируемых за один запуск задания Планировщика для каждого почтового ящика входящей электронной почты.

  • Переопределяет аналогичный глобальный параметр.

  • Поле: email_import_per_run_threshold (целое число)

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

  • По умолчанию: используется текущее значение глобальной настройки email_import_per_run_threshold в качестве значения по умолчанию.

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

Период прошедшего времени, с которого начнется импорт электронных писем, когда для нового почтового ящика ещё не зафиксирован курсор (дата последнего импортированного дня).

  • Переопределяет аналогичный глобальный параметр.

  • Поле: email_import_timeframe_start (строка)

  • Допустимый формат: отрицательное число и единица измерения — например, -30 дней, -3 месяца, -1 год.

  • По умолчанию: используется текущее значение глобальной настройки email_import_timeframe_start.

Импортировать только непрочитанные письма

Извлечение с почтового сервера только непрочитанных сообщений.

  • Переопределяет аналогичный глобальный параметр.

  • Поле: email_import_unread_only (логическое значение)

  • Если значение равно true, при импорте будут извлекаться только непрочитанные сообщения.

  • По умолчанию: Используется текущее значение глобальной настройки email_import_fetch_unread_only.

Автоматическое создание Обращений

В этом же разделе при необходимости можно настроить автоматическое создание Обращений из импортированных писем для каждой учётной записи входящей почты.

Проверка статуса

В Форме просмотра групповой учетной записи входящей почты можно просмотреть информацию о последнем запуске импорта:

Проверка статуса импорта электронной почты

Дата/время последнего запуска импорта

Время последнего запуска импорта для текущей учётной записи входящей почты.

Дата последнего импортированного дня

Зафиксированная дата (курсор) последнего импортированного дня у отслеживаемой папки почтового ящика.

Устранение возможных неполадок

  • Убедитесь, что задача Планировщика Проверять почтовые ящики для входящей почты активна и выполняется.

  • Убедитесь, что cron настроен правильно.

  • Проверьте, что учётная запись входящей почты активна, не является персональной и настроена правильно.

  • Настройте параметр Максимальное количество импортируемых писем при выполнении задания планировщика в соответствии с ресурсами, доступными на вашем сервере.

  • Проверьте журналы SuiteCRM на наличие ошибок в процессе импорта.

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

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

  • Если вам необходимо повторно импортировать электронные письма, вы можете сбросить даты последнего импорта (курсоры) для каждого почтового ящика, напрямую изменив значения в БД. Перед этим убедитесь, что у вас есть резервная копия изменяемых данных.

  • Чтобы избежать появления дубликатов при импортировании писем, убедитесь, что UID электронных писем уникальны и не используются повторно почтовым сервером.

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.