Demo
Demo
База знаний PMTA›Блок <source>›Директива§ 3.3.7.2

date-header-time

<source>

Какое время попадает в дописанный заголовок Date
в конфигурации это строкаdate-header-time receptionвнутри блока <source>
Время приёма или время доставки

Умолчание — reception: в заголовок идёт время, когда письмо принято и поставлено в очередь. Со значением delivery — время, когда его фактически отправили получателю.

Директива работает только в паре: руководство требует, чтобы add-date-header стоял в yes или override. Без этого дописывать нечего, и выбирать время не для чего.

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

Для получателя это выглядит как свежее письмо, которого он ждал позавчера, — и разбираться, почему рассылка «пришла не тогда», будет уже он.

Что делает Хаб. Не пишет — и не пишет парную строку тоже: дату ставит библиотека отправки, а MTA в неё не вмешивается.

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

Рекомендуемые значения

Что ставить. Вопрос в том, что для вас значит дата письма:

Значение Когда
reception (умолчание) дата = когда отправили; так её понимает и получатель, и ваш отчёт
delivery дата = когда получатель её увидел; годится для писем, у которых важен момент прочтения

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

Умолчание reception, оба значения и требование add-date-header — из руководства, § 3.3.7.2. Разбор про очередь и разбивка случаев наши.
Пример в конфигурации
# выбор времени имеет смысл только вместе с дописыванием даты
<source 0/0>
    add-date-header yes
    date-header-time delivery</source>
С этой парой письмо, пролежавшее в очереди из-за режима повторов, уйдёт с датой того момента, когда очередь наконец пошла, — а не когда его подали.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

Типичные ошибки и проблемы

что делают не так и чем это кончается2 ошибки▶

Ставят выбор времени без дописывания даты

§ 3.3.7.2

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

Выбирают время доставки для рассылки

наш опыт

Чем чреватоПисьма, задержанные режимом повторов, приходят с датой выхода из него. Получатель видит письмо, датированное сегодняшним числом, хотя рассылка была позавчера, — и в отчётах ваша рассылка расползается по дням.
Как заметитьДаты писем в контрольных ящиках расходятся с датой запуска рассылки.
Как правильноОставить время приёма: оно совпадает с тем, что вы считаете временем рассылки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
date-header-time <enumeration>
Значения
reception | delivery
Умолчание
reception § 3.3.7.2
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<source>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <source> и подчиняется слиянию источников: соединение попадает под все адресные блоки, которые его накрывают, и узкий перекрывает широкий. Осмысленной строка становится только там, где в том же слитом наборе стоит и дописывание даты.
⇄

Связанные директивы

1 связь

Без чего не работает

add-date-header<source>Условие применимости: без дописывания даты выбирать время не для чего. § 3.3.7.2

Как проверить на узле
Обе строки проверяются вместе — порознь ни одна не работает:
grep -n 'add-date-header\|date-header-time' /etc/pmta/config /etc/pmta/virtualhost.txt
Если дописывание даты выключено, эта строка не делает ничего. Разницу между двумя значениями видно только на письме, пролежавшем в очереди: у свежей доставки оба времени почти совпадают.
◇

Что ещё почитать

3 статьи

◇Как письмо попадает в MTAШесть описанных способов подачи: расширенный SMTP, четыре языковые обвязки и каталог, за которым узел следит на диске.◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Заголовки, которыми отправитель управляет доставкойШесть служебных заголовков позволяют подающей стороне выбрать поток, пометить письмо заданием, задать настройки и ключ подписи, идентификатор конверта и расписание; каждый разрешается отдельно и по источникам.

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Подключить платформу отправки
Соседние настройки блока <source>:process-x-jobjobid-prefixallow-mailmergeadd-message-id-headeradd-received-headerВсе 74 директив блока →