Справочник The Bat!

Макросы

  • Общая информация
  • Информация о почтовом ящике
  • Адресная информация
  • Текст и тема
  • Формат письма
  • Язык
  • Дата и время
  • Заголовки письма
  • Адресная книга
  • Системная информация
  • Безопасность
  • Правила сортировки
  • Программирование и регулярные выражения

  • Общая информация

    Макросы - это специальные команды обработчику шаблонов, которые позволяют сгенерировать текст, настроить параметры письма и добавить в него свою подпись. Макросы можно использовать не только в тексте шаблонов писем, но и в сортировщике, так как многие действия Сортировщика также воспринимают макросы в качестве параметров. Например, при помощи правила в Сортировщике писем письмо можно сохранить в папку с именем %ODATE="yyyy-mm" (год и месяц письма) или %ABFROMNAME (имя отправителя по адресной книге).

    Синтаксис

    Параметры макросов можно обрамлять двойными и одинарными кавычками (апострофами). Если эти символы присутствуют в тексте параметра, их необходимо удвоить. К примеру, параметром макроса %MACRO='Текст "в двойных" кавычках' является строка Текст "в двойных" кавычках.

    При написании придерживайтесь следующих правил:
    • Перед каждым макросом должен быть символ процента %
    • Некоторые макросы требуют обязательного параметра (например, %ATTACHFILE="C:\My Files\invoice.txt"), для некоторых параметры необязательны; при этом параметры могут содержать другие макросы, текст, адреса и другое
    • Если макрос содержит больше одного параметра, необходимо использовать скобки
    • Использовать кавычки в параметре не нужно, если параметр состоит из одного слова или в параметре используются скобки
    • Используйте двойной знак процента %%, если вы хотите вставить процент в текст письма, например, 30%% скидка


    0  

    Информация о почтовом ящике

    Макрос Описание
    %AccountName Название почтового ящика
    %AccountConnectionType Протокол почтового ящика (POP3 или IMAP4)
    %AccountCheckOnStartup Если опция «Проверять при запуске The Bat!» включена, макрос возвращает значение 1, если опция отключена, макрос возвращает значение 0
    %AccountPeriodicalCheck Если опция «Проверять с интервалом в» включена, макрос возвращает значение 1, если опция отключена, макрос возвращает значение 0
    %AccountPeriodicalCheckTime Макрос возвращает число, установленное для опции «Проверять с интервалом в». Например, если установлено «5 минут», то макрос вернет значение «5».
    %AccountPeriodicalCheckUnit Макрос возвращает единицу измерения времени, установленную для опции «Проверять с интервалом в».
    %AccountCombinedSendReceive Если опция «Совмещенная доставка (получение + отправка)» включена макрос возвращает значение 1, если опция отключена, макрос возвращает значение 0
    %AccountFromName Имя отправителя, установленное в настройках ящика
    %AccountFromAddress E-mail адрес отправителя, установленный в настройках ящика
    %AccountReplyName Имя для поля Обратный адрес, установленное в настройках ящика
    %AccountReplyAddress E-mail адрес для поля Обратный адрес, установленный в настройках ящика
    %AccountIsDefault Макрос возвращает значение 1, если ящик установлен ящиком по умолчанию для "mailto:" URL, в обратном случае макрос возвращает значение 0
    %AccountSendServer SMTP-сервер ящика
    %AccountSendPort Порт SMTP-сервера
    %AccountReceiveServer Сервер ящика для получения почты
    %AccountReceivePort Порт сервера для получения почты
    %AccountMemo Заметки ящика


    0  

    Адресная информация

    Макрос Описание
    %BCC="" Убирает всех получателей из поля «Скрытая копия» (очищает это поле)
    %BCC="адрес(а)" Добавляет адрес(а) в поле «Скрытая копия»
    %BCCLIST Список получателей из поля «Скрытая копия»
    %CC="" Убирает всех получателей из поля «Копия» (очищает это поле)
    %CC="адрес(а)" Добавляет адрес(а) в поле «Копия»
    %CCLIST Список получателей из поля «Копия»
    %FOLDERFROMADDR Адрес из поля «От» (From), указанный в свойствах активной папки
    %FOLDERFROMNAME Имя из поля «От» (From), указанное в свойствах активной папки
    %FOLDERORGANISATION или %FOLDERORGANIZATION Название организации, указанное в свойствах активной папки
    %FOLDERREPLYADDR Адрес из поля «Обратный адрес» (Reply-To) , указанный в свойствах активной папки
    %FOLDERREPLYNAME Имя из поля «Обратный адрес» (Reply-To), указанное в свойствах активной папки
    %FROM="адрес" Заменяет адрес отправителя на указанный в макросе адрес (содержимое поля «От»)
    %FROMADDR Адрес отправителя (содержимое поля «От»)
    %FROMFNAME Имя отправителя
    %FROMLNAME Фамилия отправителя
    %FROMNAME ФИО отправителя
    %OBCCLIST или %OBCC Список получателей из поля «Скрытая копия» исходного письма (используется при ответе или пересылке)
    %OCCLIST или %OCC Список получателей из поля «Копия» исходного письма (используется при ответе или пересылке)
    %OFROMADDR Адрес отправителя исходного письма (используется при ответе или пересылке)
    %OFROMFNAME Имя отправителя исходного письма (используется при ответе или пересылке)
    %OFROMLNAME Фамилия отправителя исходного письма (используется при ответе или пересылке)
    %OFROMNAME ФИО отправителя исходного письма (используется при ответе или пересылке)
    %OORGANIZATION или %OORGANISATION Организация, в которой состоит отправитель исходного письма (используется при ответе или пересылке)
    %OREPLYADDR Обратный адрес отправителя исходного письма (используется при ответе или пересылке)
    %OREPLYCOUNTER или %ORECOUNT Счетчик количества ответов на исходное письмо (используется при ответе или пересылке)
    %OREPLYFNAME Имя отправителя исходного письма из поля «Обратный адрес» (используется при ответе или пересылке)
    %OREPLYNAME ФИО отправителя исходного письма из поля «Обратный адрес» (используется при ответе или пересылке)
    %OREPLYLNAME Фамилия отправителя исходного письма из поля «Обратный адрес» (используется при ответе или пересылке)
    %ORETURNPATH Адрес отправителя исходного письма из поля «Обратный адрес» (используется при ответе или пересылке)
    %ORG/ORGANIZATION/ORGANISATION="организация" Позволяет изменить название вашей организации в поле «Организация». Указанное название заменит название, заданное по умолчанию в меню «Ящик -> Свойства почтового ящика -> Общие сведения»
    %OTOADDR Первый получатель исходного письма (используется при ответе или пересылке)
    %OTOFNAME Имя первого получателя исходного письма (используется при ответе или пересылке)
    %OTOLIST или %OTO Список получателей исходного письма (используется при ответе или пересылке)
    %OTOLNAME Фамилия первого получателя исходного письма (используется при ответе или пересылке)
    %OTONAME ФИО первого получателя исходного письма (используется при ответе или пересылке)
    %REPLYADDR Ваш адрес из поля «Обратный адрес»
    %REPLYFNAME Ваше имя из поля «Обратный адрес»
    %REPLYLNAME Ваша фамилия из поля «Обратный адрес»
    %REPLYNAME Ваши ФИО из поля «Обратный адрес»
    %REPLYTO="адрес" Позволяет изменить установленный по умолчанию адрес в поле «Обратный адрес»
    %RETURNPATH="адрес" Позволяет изменить установленный по умолчанию адрес в поле «Обратный путь»
    %TO="" Убирает всех получателей из поля «Кому» (очищает его)
    %TO="адрес(а)" Добавляет адрес(а) в поле «Кому»
    %TOADDR Адрес первого получателя из поля «Кому» вашего письма
    %TOFNAME Имя первого получателя из поля «Кому» вашего письма
    %TOLIST Список всех получателей из поля «Кому» вашего письма
    %TOLNAME Фамилия первого получателя из поля «Кому» вашего письма
    %TONAME ФИО первого получателя из поля «Кому» вашего письма

    0  

    Текст и тема

    Макрос Описание
    %BLANK Позволяет создать пустое письмо (если не указывать этот макрос, программа заменит пустой шаблон на соответствующий шаблон по умолчанию)
    %CAPITAL="текст"
    Преобразует первую букву каждого слова из этого текста в верхний регистр (прописные буквы)
    %CAPITALFIRST="текст" или UCFIRST="текст" Преобразует первую букву из этого текста в верхний регистр (в прописную букву)
    %CLEAR При использовании в быстром шаблоне очищает текст письма
    %CLIPBOARD Содержимое буфера обмена
    %CLIPBOARD="привет" или %SetCLIPBOARD="привет" Добавляет в буфер обмена текст из кавычек. Например, макросы %CLIPBOARD="привет" или %SetCLIPBOARD="привет" копируют в буфер обмена слово привет
    %COOKIE Произвольный девиз из набора девизов, указанного в меню «Ящик -> Свойства почтового ящика -> Шаблоны -> Девизы»
    %COOKIE="путь к файлу" Произвольный девиз из указанного файла. Макрос может содержать два параметра: первый параметр – это путь к файлу, второй параметр – это кодировка содержимого файла.
    %COPY ("text", start, count) Извлекает часть символов из „text“, начиная с определённого символа. Например, макрос %COPY("%otext", 1, 100) отобразит 100 символов, начиная с первого символа оригинального текста письма (используется при ответе или пересылке)
    %CURSOR Переводит курсор текстового редактора на указанную позицию в тексте письма
    %FULLSUBJ или %FULLSUBJECT Тема нового письма включая префиксы
    %INCLUDE="путь к файлу" Текст, созданный по шаблону из указанного файла. Макрос может содержать два параметра: первый параметр – это путь к файлу, второй параметр – это кодировка содержимого файла.
    %ISSIGNATURE При использовании в быстром шаблоне указывает на то, что текст этого шаблона служит в качестве подписи. Другими словами, программа заменит результатом работы этого шаблона текст, который стоит после специальной отметки подписи ("--"). Если такая отметка не будет найдена, редактор создаст её принудительно.
    %LOWER="текст" Преобразует указанный текст в нижний регистр (в строчные буквы)
    %MEMO Добавляет в текст заметки письма
    %NEWLINE Добавляет в текст пустую строку. Чтобы добавить несколько пустых строк, используйте макроc NEWLINE(n), в котором параметр n задаёт количество строк
    %NOWRAPJUSTIFY Используется вместе с макросом %WRAPPED=" ", при этом редактор выровняет текст письма не равномерно, а только по левому краю
    %OFULLSUBJ или %OFULLSUBJECT Тема исходного письма включая префиксы (используется при ответе или пересылке)
    %ONELINE или %SINGLELINE При использовании в быстром шаблоне указывает на то, что результат работы этого шаблона необходимо вывести в одну строчку.
    %OSUBJ или %OSUBJECT Тема исходного письма без префиксов Re: и Fwd: (используется при ответе или пересылке)
    %PUT="путь к файлу" Позволяет вставить в текст письма содержимое указанного файла. Макрос может содержать два параметра: первый параметр – это путь к файлу, второй параметр – это кодировка содержимого файла. Примеры: %Put("C:\Folder\sample.txt", "utf8")
    %Put("C:\Folder\sample.txt", "windows-1251")
    %QINCLUDE="псевдоним" или QT="псевдоним" Позволяет вставить в текст письма результат работы быстрого шаблона с указанным псевдонимом. Параметр должен в точности соответствовать псевдониму, который вы установили в редакторе быстрых шаблонов
    %QUOTECLIPBOARD или %QClipboard Содержимое буфера обмена в виде цитаты
    %QUOTEEMPTYLINES Включает цитирование пустых строк, которое выключено по умолчанию
    %QUOTES Текст исходного письма в виде цитаты
    %QUOTES="текст" или QUOTED("текст") Вставляет "текст" как цитату
    %QUOTESTEXT Работает точно так же, как макрос %QUOTES, но не зависит от формата письма
    %QUOTESTYLE="выражение" Информация об авторе исходного письма для префикса цитат. Допустимые значения выражения:
    • NONE ничего (по умолчанию)
    • I инициалы
    • IF первая буква
    • N имя и фамилия
    • F имя
    • L фамилия
    • =текст указанный текст в качестве префикса
    %REPLYCOUNTER или %RECOUNT Счётчик количества ответов на ваше письмо. Пример: %SUBJECT="%RECOUNT Предлагаю сменить тему письма"
    %SINGLERE При ответе на письмо убирает из темы префикс Re:
    %SUBJ Тема письма без префиксов Re: и Fwd:
    %SUBJECT="тема" Позволяет назначить определённую тему письма
    %TEXT="nn" Первые nn строк текста исходного письма (используется при ответе или пересылке)
    %TEXT="nnL" Первые nn строк текста исходного письма и все строчки, которые содержат ссылки (используется при ответе или пересылке)
    %TEXT или %OTEXT Текст исходного письма (используется при ответе или пересылке)
    %TEXTSIZE или %OTEXTSIZE Размер текста исходного письма в байтах (используется при ответе или пересылке)
    %UPPER="текст" Преобразует указанный текст в верхний регистр (в прописные буквы)
    %WRAPJUSTIFY Используется вместе макросом %WRAPPED=" ", при этом редактор выровняет текст письма как по левому, так и по правому краю
    %WRAPPED="текст" Вставляет указанный текст и выравнивает его в соответствии с текущими параметрами редактора
    %QuoteIgnoreSeparator Позволяет цитировать также подпись – текст, расположенный под Разделителем ("-- ") – используйте для этого макрос %QuoteIgnoreSeparator%QUOTES

    0  

    Формат письма

    Макрос Описание
    %ACCOUNT="название" Назначает активным почтовый ящик с указанным названием
    %ATTACHFILE="путь к файлу" Прикрепляет к письму указанный вами файл
    %ATTACHMENTS Список файлов, прикрепленных к письму
    %AttachOriginalFiles=<Маска> Прикрепляет файлы оригинального письма к автоматически сгенерированному письму. Примеры: %AttachOriginalFiles="*", %AttachOriginalFiles="*.txt,*.pdf".
    %ATTACHVCARD Прикрепляет к письму vCard (визитную карточку) активного почтового ящика
    %CHARSET="идентификатор" Позволяет изменить кодировку письма. Идентификатор необходимой таблицы можно узнать в меню «Свойства -> Настройка -> Другие опции -> Наборы символов»
    %FOLDER="полный путь папки" Устанавливает текущую папку и ящик. После использования такого макроса соответственно изменятся значения персональных данных для письма. Полный путь должен быть представлен в виде: \\ящик\путь\к\папке или "путь\к\папке"
    %LANGUAGE ="идентификатор" Позволяет назначить необходимый язык для проверки орфографии. Для получения дополнительной информации смотрите раздел Язык
    %NORCPTCONFIRM или %NoRRQ Позволяет отменить опцию «Подтверждение доставки» в редакторе писем
    %NOREADCONFIRM или %NoRCR Позволяет отменить опцию «Подтверждение прочтения» в редакторе писем
    %NOSPLIT Запрещает автоматическое разбиение исходящих писем на части
    %OATTACHMENTS Список файлов, прикрепленных к исходному письму (используется при ответе и пересылке)
    %OCHARSET Устанавливает кодировку исходного письма (используется при ответе и пересылке)
    %POSTPONE=”значение” или DELAY=”значение” Позволяет настроить отложенную отправку. В качестве значения необходимо указать время, на которое отправка будет отложена. Например, макрос %POSTPONE="1d 2h 5m" отложит отправку письма на один день, 2 часа и 5 минут. Подробнее об отложенной отправке.)
    %PRIORITY="H/N/L" Устанавливает приоритет письма (H-высокий, N-нормальный, L-низкий)
    %RCPTCONFIRM Устанавливает опцию «Подтверждение доставки»
    %READCONFIRM Устанавливает опцию «Подтверждение прочтения»
    %SETEDITOR="номер" Позволяет установить редактор для письма. Возможные варианты для параметра: 1 - Только текст (MicroEd); 2 - Только текст (Windows); 3 - HTML / Простой текст; 4 - Только HTML
    %SPLIT Разбивает исходящее письмо на части в случае превышения рекомендуемого размера, указанного в меню «Ящик -> Свойства почтового ящика -> Файлы и каталоги»


    0  

    Язык
    Макрос LANGUAGE="идентификатор" позволяет назначить необходимый язык для проверки орфографии. Допустимые значения идентификатора:

    AM Английский (США)
    BR Английский (Великобритания)
    CS Чешский
    DA Датский
    DU Голландский
    FI Финский
    FR Французский
    GE Немецкий
    HU Венгерский
    IT Итальянский
    NB Норвежский (Bokmal)
    PB Португальский (Бразилия)
    PT Португальский (Иберийский)
    RU Русский
    SP Испанский
    SW Шведский


    0  

    Дата и время

    Вы можете использовать следующие префиксы макросов:

    без префикса Текущие дата и время
    O Дата и время создания исходного письма (используется только при ответе и пересылке)
    ORCV Дата и время получения исходного письма (используется только при ответе и пересылке)

    Макрос Описание
    %<префикс>DATE или %<префикс>DATE="текст" Вставляет дату письма, при этом используется полный формат даты, установленный в операционной системе в меню «Пуск -> Панель управления -> Часы, язык и регион -> Дата и время». Вы можете использовать свой формат с указанием параметра, см. https://msdn.microsoft.com/en-us/library/dd317787%28VS.85%29.aspx
    Чтобы вставить дату на определенном языке, можно использовать ID языка в качестве значения второго параметра. В качестве значения первого параметра можно использовать L, чтобы вставить полную дату. Например, макрос %DATE("L", "RU") вставит в текст "25 ноября 2015 г.", а макрос %DATE("dddd, dd MMMM yyyyy", "RU") соответственно "среда, 25 ноября 2015".
    %<префикс>DATEEN Вставляет дату в формате «день недели, месяц, день, год», причем значения полей день недели и месяц указываются прописью на английском языке
    %<префикс>DATESHORT Вставляет дату, при этом используется краткий формат даты, установленный в операционной системе в меню «Пуск -> Панель управления -> Часы, язык и регион -> Дата и время»
    %<префикс>DOW Вставляет день недели
    %<префикс>TIME или %<префикс>TIME="текст" Вставляет время, при этом используется краткий формат времени на основе системных параметров в меню «Пуск -> Панель управления -> Часы, язык и регион -> Дата и время». Вы можете использовать свой формат с указанием параметра
    %<префикс>TIMELONG Вставляет дату, при этом используется полный формат даты, установленный в операционной системе в меню «Пуск -> Панель управления -> Часы, язык и регион -> Дата и время»
    %<префикс>TIMELONGEN Вставляет время в формате часы:минуты:секунды AM/PM


    0  

    Заголовки письма

    Макрос Описание
    %ADDHEADER(header, текст) Добавляет текст к заголовку письма. Параметр header - это имя заголовка по RFC, определяемое в меню «Свойства -> Настройка -> Редактор и Просмотр писем -> Заголовки писем»
    %COMMENT Значение поля Comment (комментарий) из заголовков письма (RFC-822). Примечание: в этом заголовке отсутствуют управляющие символы возврата каретки (#10) и новой строки (#13), поэтому при использовании данного макроса управляющие символы заменяются пробелом
    %COMMENT="текст" Добавляет в заголовки письма (RFC-822) поле Comment (комментарий)
    %HDRheader Вставляет текст из заголовка, определяемому по идентификатору header. Параметр header - это имя заголовка по RFC, определяемое в меню «Свойства -> Настройка -> Редактор и Просмотр писем -> Заголовки писем»
    %HDRheader="текст" Добавляет текст к заголовку письма. Параметр header - это имя заголовка по RFC, определяемое в меню «Свойства -> Настройка -> Редактор и Просмотр писем -> Заголовки писем»
    %HEADER(header) Вставляет текст из заголовка, определяемому по идентификатору header. Параметр header - это имя заголовка по RFC, определяемое в меню «Свойства -> Настройка -> Редактор и Просмотр писем -> Заголовки писем»
    %HEADERS Заголовки исходного письма (RFC-822)
    %MODIFYONCE(заголовок, заголовок, ... ) Если вы применяете к письму шаблоны более одного раза (в том числе автоматически), то текст создаваемого письма не всегда может изменяться, если меняются заголовки. Используйте этот макрос для того, чтобы защитить значения заголовков в шаблоне. Примечание: Этот макрос следует вставить до макросов изменения заголовков
    %MSGID Идентификатор исходного письма (поле Message-ID из заголовков). Для только что созданных писем этот макрос работать не будет, так как в их заголовках пока еще нет идентификатора
    %OCOMMENT Значение поля Comment (комментарий) из заголовков исходного письма (RFC-822) (используется при ответе и пересылке)
    %OHEADER="заголовок" Вставляет заголовок исходного письма, имя заголовка указывается в параметре. Имя заголовка должно быть именем по RFC, определённым в меню «Свойства -> Настройка -> Редактор и Просмотр писем -> Заголовки писем» (используется при ответе и пересылке)
    %OMSGID Идентификатор исходного письма - содержимое поля Message-ID (используется при ответе и пересылке)
    %QHEADERS Заголовки исходного письма (RFC-822) в виде цитаты
    %SETHEADER("заголовок", "текст") Заменяет содержимое заголовка (если оно было) на указанный текст
    %SOURCE или %SOURCE=Charset Включает исходный текст письма (возможно использование заданной кодировки)


    0  

    Адресная книга

    Макросы группы AbnnnPPP позволяют добавить в текст письма любую информацию из адресной книги. Часть "nnn" определяет адрес (отправитель или получатель, поля «От» (From) или «Обратный адрес» (Reply-to)), а часть "PPP" указывает на то, какого рода информация вам необходима.

    Если макрос используется с параметром (%AbnnnPPP="текст"), то программа заменит информацию на указанный текст.

    Допустимые значения для части «nnn»:

    FROM Адрес из поля «От» (From) нового письма
    OFROM Адрес из поля «От» (From) исходного письма
    OREPLY Адрес из поля «Обратный адрес» (Reply-to) исходного письма
    OTO Адрес из поля «Кому» (To) исходного письма
    REPLY Адрес из поля «Обратный адрес» (Reply-to) нового письма
    TO Адрес из поля «Кому» (To) нового письма


    Допустимые значения для части «PPP»:

    Общая информация
    Name ФИО
    FirstName Имя
    LastName Фамилия
    MiddleName Отчество
    Handle Псевдоним
    Gender Пол. Возможные значения: 0 - не указан, 1 - мужской, 2 - женский
    Charset Используемая таблица перекодировки
    Memo Заметки в свойствах адреса
    NamePrefix Префикс имени («Mr.», «Mrs.», «Dr.»)
    NameSuffix Суффикс имени («, Jr.», «, PhD»)
    Birthday Дата рождения
    Email Основной адрес e-mail
    Информация на закладке «Личное»
    Addr Дом, улица
    City Город
    State Штат / Провинция / Область / Край
    ZIP ZIP / Почтовый индекс
    Country Страна
    Phone Телефон
    Fax Факс
    Mobile Мобильный
    Page Личная WWW-страница
    Информация на закладке «Место работы»
    Company Название компании / организации
    Job Должность
    Dept Отдел
    Office Офис
    BusAddr Улица, дом
    BusCity Город
    BusState Штат / Провинция / Область / Край
    BusZIP ZIP / Почтовый индекс
    BusCountry Страна
    BusPhone Телефон
    BusFax Факс
    BusPager Пейджер
    BusPage WWW-страница


    0  

    Системная информация

    Макрос Описание
    %ACCOUNTATTACHDIR Полный путь к папке хранения прикреплённых файлов (если задан такой параметр в свойствах ящика). Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
    %ACCOUNTDIR Полный путь к папке ящика. Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
    %Accountconnectiontype Протокол почтового ящика
    %ACCOUNTNAME Название активного почтового ящика
    %FOLDERDIR Полный путь к текущей папке в почтовом ящике. Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
    %FOLDERMESSAGESTOTAL Общее число писем в текущей папке
    %FOLDERMESSAGESUNREAD Число непрочитанных писем в текущей папке
    %FOLDERNAME Название активной папки
    %FOLDERFULLNAME Полное название активной папки (Пример: \\test@ritlabs.com\Inbox\Test)
    %MAILDIR Содержит полный путь к почтовому каталогу. Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
    %PAGENUMBER Номер страницы, которая была распечатана
    %PROGRAMDIR Полный путь к папке, где установлена программа. Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
    %RANDOMNUMBER Возвращает случайное число, состоящее из 8 шестнадцатеричных цифр ('0'-'9', 'A'-'F').
    В отличие от %TRACKINGNUMBER, значение %RANDOMNUMBER не является неизменным в пределах текущего письма.
    Возможно применение параметра для установки предельного значения, чтобы возвращаемое число всегда было меньше этого значения. Если параметр не задан, предельным значением является 2147483647.
    Существует дополнительный второй параметр. Если установить "H", то возвращаемое значение будет шестнадцатеричным; в противном случае, если вы указали предельное значение в качестве первого параметра, возвращаемое значение будет десятичным
    %SOFTWAREBITS или %THEBATBITS Отображает битность установленной программы
    %THEBATSERIALNUMBER или %SOFTWARESERIALNUMBER Серийный номер The Bat!
    %THEBATVERSION или %SOFTWAREVERSION Версия The Bat!
    Возможные агрументы параметра макроса:
    COPYR – уведомление об авторских правах: Copyright © 1998-2015 Ritlabs, SRL
    LNG – номер версии на языке, выбранном в интерфейсе программы: Версия 7.0.0.56
    WITHBITS – версия программы с указанием битности: Version 7.0.0.56 (64-bit)
    0 –название продукта: The Bat!
    1 –номер версии The Bat!: 7.0.0.56
    2 –уведомление об авторских правах: Copyright (C) 1998-2015 Ritlabs, SRL
    3 – версия файла: 7.0.0.56
    4 – вставляет строку: The Bat! E-Mail Client by Ritlabs, SRL
    5 - вставляет описание: Natural E-Mail System (TM)
    %THEBATVERSION(WITHBITS) Отображает версию программы с указанием битности
    %TOTALPAGES Количество всех страниц для печати
    %TRACKINGNUMBER Случайное 32-битное число в шестнадцатеричном формате
    %WINDOWSBUILDNUMBER Версия Windows (номер сборки)
    %WINDOWSCSDVERSION Версия Windows (дополнительный номер сборки)
    %WINDOWSMAJORVERSION Основная версия Windows
    %WINDOWSMINORVERSION Дополнительная версия Windows
    %WINDOWSPLATFORMNAME Название версии Windows (Windows 7, Windows 8 и т.д.)


    0  

    Безопасность

    Макрос Описание
    %AUTOPGPMIME Устанавливает автоматическое использование опции PGP/MIME для письма по этому шаблону
    %ENCRYPTCOMPLETE Автоматически зашифровывает письмо перед его отправкой
    %INSERTPGPKEY="адрес" Вставляет открытый ключ OpenPGP, который принадлежит владельцу указанного адреса
    %NOENCRYPTCOMPLETE Отменяет параметр «Зашифровать перед отправкой» в редакторе писем
    %NOPGPMIME или %CLEARSIGN Отключает использование PGP/MIME для этого письма
    %NOSIGNCOMPLETE Отменяет параметр «Подписать перед отправкой» в редакторе писем
    %NOUSEPGP Запрещает использование OpenPGP на время текущего сеанса редактирования
    %NOUSESMIME Запрещает использование S/MIME на время текущего сеанса редактирования
    %PGPMIME Разрешает использование PGP/MIME для этого письма
    %SIGNCOMPLETE Устанавливает параметр «Подписать перед отправкой» в редакторе писем
    %USEPGP Разрешает использование OpenPGP на время текущего сеанса редактирования
    %USESMIME Разрешает использование S/MIME на время текущего сеанса редактирования


    0  

    Правила сортировки

    Макрос Описание
    %FilterName Имя текущего правила. Примечание: только для использования в правилах
    %FilterResults Результаты сортировки для некоторых действий. Если было использовано сложное условие, например: <<Текст содержит "абв" или Текст содержит "где" или Текст содержит "жзи">>, то %FilterResults будет содержать точно отработавшую строку. Т.е. если "Текст" = "Где я?", то после работы %FilterResults будет равно "где". Более сложно работает с регулярными выражениями. Т.е. если в условии идет регулярное выражение, то %FilterResults можно использовать с индексами, например %FilterResults(0) – всё совпадение, %FilterREsults(1) - первое подвыражение и т.д. Примечание: только для использование в правилах
    %FilterTag Тег текущего правила. Примечание: только для использования в правилах
    %SetUserParam("параметр", "значение") Устанавливает переменную «параметр» в значение «значение». Может быть использован в сложном вложенном макросе. Смотрите также UserParam
    %Userparams="переменная" Извлекает значение переменной (которая должна быть выставлена в этой же сессии сортировки). Может быть использован в действиях сортировщика, например: Переместить в папку %UserParams("FltFolder")
    %VALIDFILECHARS Заменяет неверные символы в аргументе знаками подчёркивания. Макрос может быть полезен, например, в правилах сортировки, которые создают папку с использованием макроса %OSUBJ в качестве названия папки. Например, %VALIDFILECHARS="%OSUBJ"


    0  

    Программирование и регулярные выражения

    Макрос Описание
    %- Тире (%-) можно вставить в конце любой строчки шаблона, чтобы объединить ее со следующей. Если этот макрос указан в середине строки, программа просто удалит его из текста письма
    %_name="значение" или %VARname="значение" Установка значения переменной. Часть name - это имя переменной, которое может содержать только буквы, цифры и знак подчёркивания. Переменные могут быть полезны при использовании вставки одинакового текста (например, рассчитываемого с помощью вычислений или регулярных выражений) в разные части письма. Они также помогают временно сохранить результат выполнения макроса. Примечание: То же, что и макрос %VARname
    %IF :
    "переменная1" <оператор сравнения>
    "переменная2" : <тогда> : <иначе>
    Оператор сравнения, который позволяет вставлять в текст письма различные фрагменты в зависимости от выполнения заданного условия: <Оператор сравнения> может принимать значение '=' (равно), '>' (больше), '<' (меньше) или '<>' (не равно). Таким образом, если <переменная 1> = или > или < или <> <переменная 2>, используется фрагмент из секции <тогда>. Если это не так, программа вставляет в текст письма содержимое секции <иначе>. Пример: %IF:"%TIME"<"12:00":"утро":%- "%IF:'%TIME'>'17:00':'вечер':'день'". В качестве переменных секций <тогда> и <иначе> можно использовать не только фрагменты текста. Этот оператор поддерживает также быстрые шаблоны и результат выполнения других макросов.
    %CALCULATE="выражение" или %CALC="выражение" Позволяет рассчитывать простые математические формулы
    %IFCASE : "переменная1" <оператор сравнения>
    "переменная2" : <тогда> : <иначе>
    То же что и макрос %IF, но с чувствительностью к регистру символов
    %IFN : "переменная1" <оператор сравнения>
    "переменная2" : <тогда> : <иначе>
    То же что и макрос IF, но для числовых параметров. Примечание: если параметр не может быть сконвертирован в число, то он будет равным нулю. Числа должны быть в строгой форме – без разделителя тысяч и со знаком точки (.) в качестве десятичного разделителя
    %REGEXPBLINDMATCH="текст" Работает аналогично %REGEXPMATCH, разница лишь в том, что найденный текст не вставляется в тело письма, а сохраняется в специальной внутренней переменной (его можно извлечь при помощи макроса %SUBPATT="n")
    %REGEXPMATCH="текст" Результат поиска в указанном тексте на основе регулярного выражения, установленного ранее при помощи макроса %SETPATTREGEXP="выражение"
    %REGEXPQUOTES="выражение" Позволяет осуществить поиск в тексте исходного письма на основе регулярного выражения (возвращает результат в виде цитаты)
    %REGEXPTEXT="выражение" Позволяет осуществить поиск в тексте исходного письма на основе регулярного выражения
    %REM="комментарий" Позволяет добавить в шаблон комментарий, чтобы пояснить принцип его работы
    %SETPATTREGEXP="выражение" Позволяет установить регулярное выражение для поиска в тексте, на который указывает макрос %REGEXPMATCH
    %SUBPATT="n" n - порядковый номер подстроки, которую необходимо вставить в текст письма (она является результатом поиска в заданной области, на которую ссылались макросы REGEXPMATCH или REGEXPBLINDMATCH). SUBPATT='0' возвращает результат работы всего регулярного выражения, 1 - результат его первой части, 2 - второй и т.д.
    %Replace( pattern, replaceWith, text ) Автоматическая замена всех совпадений в
    %ReplaceRegExp( patternRegExp, replaceWith, text [, subPattNo] ) Автоматическая замена всех совпадений, соответствующих , в . - дополнительный параметр, определяющий точную подмаску для замены
    %REGEXP( pattern, sample, subPatternNo ) Упрощенная замена для комбинации %SetPattRegexp=...%RegexpBlindMatch=...%SubPatt=...


    0