Настройка использования макросов в шаблонах почтовых уведомлений
04 июля 2024
ID 56706
Макрос – это элемент подстановки, используемый в шаблонах уведомлений о событиях. В формируемом на основе шаблона тексте уведомления макрос заменяется на некоторое значение.
Синтаксис макроса: %ИМЯ_МАКРОСА%
В текстах уведомлений о событиях можно использовать следующие макросы (см. таблицу ниже).
Макросы для шаблонов уведомлений о событиях
Макрос | Описание | Событие, для которого используется макрос |
---|---|---|
%SERVER_NAME% | Имя почтового сервера. | antiVirusBasesOutOfDate, antiVirusBasesObsolete, antiSpamBasesOutOfDate, antiSpamBasesObsolete, messageBackupFailed, severalMessagesBackupFailed, severalBackupCleanupAttemptsFailed, backupAlmostFull, licenseExpiresSoon, licenseExpired, licenseBlacklisted |
%PRODUCT_NAME% | Название программы. | antiVirusBasesOutOfDate, antiVirusBasesObsolete, antiSpamBasesOutOfDate, antiSpamBasesObsolete, messageBackupFailed, severalMessagesBackupFailed, severalBackupCleanupAttemptsFailed, backupAlmostFull, licenseExpiresSoon, licenseExpired, licenseBlacklisted |
%BASES_ISSUE_DATE% | Дата выпуска антивирусных баз или баз Анти-Спама. | antiVirusBasesOutOfDate, antiVirusBasesObsolete, antiSpamBasesOutOfDate, antiSpamBasesObsolete |
%OUTDATED_DAYS% | Количество дней с момента последнего обновления антивирусных баз или баз Анти-Спама. | antiVirusBasesOutOfDate, antiVirusBasesObsolete, antiSpamBasesObsolete |
%OUTDATED_HOURS% | Количество часов с момента последнего обновления баз Анти-Спама. | antiSpamBasesOutOfDate |
%SMTP_MESSAGE_ID% | Заголовок сообщения. | messageBackupFailed, scanStatusAlertForAdmin, scanStatusAlertForOthers |
%MESSAGES_COUNT% | Количество сообщений, которые не удалось поместить в хранилище или общее количество сообщений в хранилище. | severalMessagesBackupFailed, backupAlmostFull |
%MINUTES% | Время, в течение которого произошли попытки помещения сообщений в хранилище или автоматического удаления сообщений из него. | severalMessagesBackupFailed, severalBackupCleanupAttemptsFailed |
%ATTEMPTS% | Количество попыток автоматического удаления сообщений из хранилища. | severalBackupCleanupAttemptsFailed |
%MESSAGES_SIZE% | Общий размер сообщений в хранилище в мегабайтах. | backupAlmostFull |
%MAX_BACKUP_SIZE% | Максимальный размер хранилища. | backupAlmostFull |
%LICENSE_NUMBER% | Ключ, связанный с лицензией. | licenseExpiresSoon, licenseExpired, licenseBlacklisted |
%EXPIRATION_DAYS% | Количество дней до окончания срока действия лицензии. | licenseExpiresSoon |
%EXPIRATION_DATE% | Дата окончания срока действия лицензии. | licenseExpired |
%SENDER% | Адрес отправителя сообщения. | scanStatusAlertForAdmin, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%ALL_RECIPIENTS% | Адреса всех получателей исходного сообщения. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForOthers |
%AFFECTED_RECIPIENTS% | Адреса получателей исходного сообщения, имеющие отношение к событию, описанному в уведомлении. | scanStatusAlertForAdmin, scanStatusAlertForOthers, messageBounce |
%AFFECTED_RULES% | Правила обработки исходного сообщения, имеющие отношение к событию, описанному в уведомлении. | scanStatusAlertForAdmin, scanStatusAlertForOthers |
%MESSAGE_ID% | Идентификационный номер сообщения в программе. | scanStatusAlertForAdmin, scanStatusAlertForOthers |
%SUBJECT% | Тема исходного сообщения. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%DATE% | Дата обработки сообщения. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%MESSAGE_ACTION% | Действие программы над сообщением. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%DATA_BEGIN% | Служебный макрос для обозначения начала списка макросов для вложения. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%DATA_END% | Служебный макрос для обозначения конца списка макросов для вложения. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%OBJECT_NAME% | Имя обнаруженного объекта. В теле уведомления макрос заполняется информацией о результатах проверки вложений сообщения или значением Message при наличии фишинговой / вредоносной ссылки в тексте сообщения. В теме уведомления на место макроса всегда подставляется значение Message. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%OBJECT_SIZE% | Размер вложения или данных о фишинговой / вредоносной ссылке. В теле уведомления макрос заполняется информацией о результатах проверки отдельных частей сообщения. Под частями сообщения понимаются вложения или фишинговые / вредоносные ссылки в тексте сообщения. В теме уведомления макрос заполняется информацией об итоговом результате проверки сообщения, формируемом на основе проверки всех частей сообщения. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%STATUS% | Результат проверки сообщения. В теле уведомления макрос заполняется информацией о результатах проверки отдельных частей сообщения с указанием имен обнаруженных объектов. Под частями сообщения понимаются вложения или фишинговые / вредоносные ссылки в тексте сообщения. Применимо для следующих статусов:
| scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |
%OBJECT_ACTION% | Действие программы над вложением или фишинговой / вредоносной ссылкой. В теле уведомления макрос заполняется информацией о результатах проверки отдельных частей сообщения. В теме уведомления макрос заполняется информацией об итоговом результате проверки сообщения, формируемом на основе проверки всех частей сообщения. | scanStatusAlertForAdmin, scanStatusAlertForSender, scanStatusAlertForRecipient, scanStatusAlertForOthers |