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

retain-x-job

<source>

Оставлять ли заголовок x-job в письме при доставке
в конфигурации это строкаretain-x-job falseвнутри блока <source>
Показывать ли получателю имя вашей рассылки

Умолчание — false: MTA снимает заголовок перед отправкой. С true он остаётся в письме и доезжает до получателя.

Условие применимости здесь названо прямо, и этим директива отличается от соседей по семье: она используется, только если чтение заголовка разрешено и заголовок в письме есть. У пар про подпись и про расписание руководство, наоборот, подчёркивает независимость половин.

Главная ловушка — метка задания говорит о вас больше, чем кажется. В ней обычно имя рассылки, номер потока, иногда идентификатор клиента. Оставленная в письме, она уезжает получателю и попадает в его почтовые журналы и в жалобы, которые он потом отправит.
Что делает Хаб. Не пишет — и не имеет к этому повода: метку задания Хаб не ставит вовсе, а чтение заголовка не включено ни в одном источнике. В источниках с логином стоит явное process-x-job false, остальные берут вендорское умолчание — тоже false. Снимать нечего, потому что нечего и читать.
Рекомендуемые значения

Что ставить. Умолчание верно почти всегда:

Значение Когда
no (умолчание) обычный случай: получателю незачем видеть имя вашей рассылки
yes письмо идёт в ваш же контрольный ящик, и метку нужно видеть глазами

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

Умолчание false и условие «только при включённом чтении и наличии заголовка» — из руководства, § 3.3.7.51. Разбивка случаев наша.
Пример в конфигурации
# заголовок остаётся в письме — только для собственных ящиков
<source 10.0.0.5>
    process-x-job true
    retain-x-job true</source>
Обе строки нужны вместе: без первой заголовок не читается, и вторая, по букве раздела, вообще не применяется. Пример имеет смысл на источнике, с которого письма уходят в свои же ящики.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Ставят сохранение без разрешения читать

§ 3.3.7.51

Чем чреватоРуководство называет условие прямо: директива используется, только если чтение разрешено и заголовок в письме есть. Строка без пары не делает ничего, а что станет с непрочитанным заголовком, раздел про чтение не говорит; у соседних заголовков такие разделы пишут, что он остаётся в письме.
Как заметитьЗаголовок задания виден в доставленных письмах, хотя сохранение выключено.
Как правильноСмотреть на пару целиком: сначала решить, читается ли заголовок, и только потом — сохраняется ли.

Оставляют включённым на общем источнике

наш опыт

Чем чреватоИмена рассылок уезжают всем получателям и попадают в их журналы и жалобы. Устройство ваших кампаний становится видно снаружи.
Как заметитьМетка задания встречается в письмах, полученных в чужих ящиках.
Как правильноДержать сохранение только на отдельном источнике для собственных ящиков, а на общем возвращать умолчание.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
retain-x-job <boolean>
Значения
yes | no | true | false
Умолчание
false § 3.3.7.51
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<source>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <source> и подчиняется слиянию источников: соединение попадает под все адресные блоки, которые его накрывают, и узкий перекрывает широкий. Для подачи под логином действует именованный блок, и строку в нём приходится повторять — наследования из адресных блоков в именованный мы на своей установке не увидели.
⇄

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

2 связи

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

process-x-job<source>Первая половина пары, и здесь она обязательна: без разрешения читать заголовок эта директива не применяется. § 3.3.7.51

Где применяется

Заголовки, которыми отправитель управляет доставкойПоловина «оставить или снять» у одного из шести служебных заголовков. § 3.3.7.51

Как проверить на узле
Настройка видна в конфигурации, следствие — в доставленном письме:
grep -n 'retain-x-job' /etc/pmta/config /etc/pmta/virtualhost.txt
Пустой вывод означает вендорское умолчание — заголовок снимается. Проверить окончательно можно только по письму в контрольном ящике: MTA показывает настройку, а не результат.
◇

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

3 статьи

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

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