Internet technologies and communication software



List of Macros
Macros are special commands used within message templates. They allow you to automatically generate text, set message parameters and add your signature to the message. Every macro is preceded by the percentage symbol %.  

Here is the list of most common macros used in The Bat!: 
Macro Description
Message sender
%FROMNAME Sender's full name
%FROMFNAME Sender's first name
%FROMLNAME Sender's last name
%FROMADDR Sender's email address
%FROM = "address" Allows to change sender's address
%FOLDERFROMADDR FROM address specified in active folder properties
%FOLDERFROMNAME FROM name specified in active folder properties
%FOLDERORGANISATION, %FOLDERORGANIZATION Organization name specified in active folder properties
%BCC = "address(es)" Adds address(es) to BCC field
%CC = "address(es)" Adds address(es) to CC field
Message recipient
%TONAME Full name of the first recipient from TO field
%TOADDR Address of the first recipient from TO field
%TO = "address(es)" Adds address(es) to TO field
%TOLIST Full list of the recipients from TO field
%OTOADDR (reply and resend) Address of the first recipient of the original message
%OTONAME (reply and resend) Full name of the first recipient of the original message
Message subject
%SUBJ Message subject without Re: and Fwd: prefixes
%SUBJECT = "subject" Allows to assign new subject
%FULLSUBJ, %FULLSUBJECT New message subject (full). Note: Subject contains Re: and Re[n]: prefixes
%REPLYCOUNTER, %RECOUNT Reply counter. Example%SUBJECT="%RECOUNT  Let's change message subject"
%SINGLERE Removes Re prefix from reply
Message text
%CURSOR Moves cursor of message editor to a specified position in message text
%BLANK Allows to create a blank message
%CLEAR Clears message text when used in Quick Template
%QUOTES Original  message text is quoted
%QUOTES = "text" Any text is quoted
%COOKIE Random cookie taken from the list (Account->Properties->Templates->Cookies)
%INCLUDE = "file path" Inserts text from a quick template from the specified file
%QINCLUDE="handle", %QT="handle" Позволяет вставить в текст сообщения результат работы быстрого шаблона с указанным псевдонимом. Примечание: Параметр должен в точности соответствовать псевдониму, который вы определили в редакторе быстрых шаблонов
%CAPITAL = "text" Преобразует первую букву каждого слова из этого текста в верхний регистр (в прописные буквы)
%CAPITALFIRST = "text" Преобразует первую букву из этого текста в верхний регистр (в прописную букву). То же что и UCFIRST
%UCFIRST = "text" Преобразует первую букву из этого текста в верхний регистр (в прописную букву). То же что и CAPITALFIRST
%UPPER = "text" Преобразует указанный текст в верхний регистр (в прописные буквы). То же что и CAPITAL
%LOWER = "text" Преобразует указанный текст в нижний регистр (в строчные буквы)
Date and time
%DATE , %DATE="text" Дата, используется полный формат даты, установленный в операционной системе - Пуск -> Настройка -> Панель управления -> Язык и стандарты -> Дата. Вы можете использовать свой формат с указанием параметра.
%DATEEN Дата в формате: день недели, месяц, день, год, причем значения полей день недели и месяц указываются прописью на английском языке
%DATESHORT Дата, используется краткий формат даты, установленный в операционной системе
%DOW День недели
%TIME, %TIME="text" Время, используется краткий формат времени на основе системных параметров. Вы можете использовать свой формат с указанием параметра.
%TIMELONG Время, используется полный формат времени на основе системных параметров.
%TIMELONGEN Time format: hours:minutes:seconds AM/PM
Message format
%ACCOUNT = "name" Назначает активным почтовый ящик с указанным названием
%FOLDER="folder path" Устанавливает текущую папку и ящик. После использования такого макроса соответственно изменятся значения персональных данных для письма, а также значения получаемых данных их макросов, отвечающих за имя папки и ящика. Полный путь должен быть представлен в виде:\\ящик\путь\к\папке или "путь\к\папке"
%ATTACHFILE = "file path" Attaches specified file to the message
%ATTACHVCARD Attaches vCard  to the message
%ATTACHMENT List of files attached to the message
%CHARSET = "identifier" Позволяет изменить кодировку нового письма. Идентификатор необходимой таблицы (набор символов MIME) можно узнать в диалоговом окне Свойства -> Таблицы перекодировок
%LANGUAGE = "identifier" Позволяет назначить необходимый язык для проверки орфографии.
%SPLIT Разбивает исходящее сообщение на части в случае превышения рекомендуемого размера, указанного в разделе Файлы и каталоги диалогового окна Свойства почтового ящика
%NOSPLIT Запрещает автоматическое разбиение исходящих сообщений на части (по умолчанию опция разбиения сообщений настраивается в свойствах ящика в разделе Файлы и каталоги)
%PRIORITY = "H/N/L" Sets message priority (H-high, N-normal, L-low)
%RCPTCONFIRM Установить для нового письма флажок Подтверждение доставки
%READCONFIRM Установить для нового письма флажок Подтверждение прочтения
System information
%ACCOUNTNAME Название активного почтового ящика
%FOLDERNAME Название активной папки
%WINDOWSBUILDNUMBER Версия Windows (номер сборки)
%THEBATSERIALNUMBER Серийный номер The Bat!
%THEBATVERSION Версия The Bat!
%TRACKINGNUMBER Случайное 32-битное число в шестнадцатеричном формате
%PAGENUMBER Номер страницы, которая была распечатана
%TOTALPAGES Количество всех страниц для печати
%ACCOUNTATTACHDIR Полный путь к папке хранения прикреплённых файлов (если задан такой параметр в свойствах ящика). Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
%ACCOUNTDIR Полный путь к домашней папке ящика. Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
%MAILDIR Содержит полный путь к почтовой папке программы. Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
%PROGRAMDIR Полный путь к папке, где установлена программа. Этот макрос может быть полезен как параметр для макросов %ATTACHFILE, %INCLUDE и %PUT
%SIGNCOMPLETE Позволяет установить параметр Подписать перед отправкой в редакторе сообщений
%ENCRYPTCOMPLETE Автоматически зашифровывает сообщение перед его отправкой
%NOSIGNCOMPLETE Позволяет отменить параметр Подписать перед отправкой в редакторе сообщений
%NOENCRYPTCOMPLETE Позволяет отменить параметр Зашифровать перед отправкой в редакторе сообщений
%USEPGP Разрешает использование OpenPGP на время текущего сеанса редактирования
%NOUSEPGP Запрещает использование OpenPGP на время текущего сеанса редактирования
%AUTOPGPMIME Устанавливает автоматическое использование опции PGP/MIME для сообщения по этому шаблону
%PGPMIME Разрешает использование PGP/MIME для этого письма.
%NOPGPMIME Отключает использование PGP/MIME для этого письма. То же, что и CLEARSIGN.
%USESMIME Разрешает использование S/MIME на время текущего сеанса редактирования
%NOUSESMIME Запрещает использование S/MIME на время текущего сеанса редактирования
%INSERTPGPKEY = "address" Открытый ключ OpenPGP, который принадлежит владельцу указанного адреса (работает только с внутренней версией OpenPGP)

Please note:
Macros can be used not only within message templates but also in Sorting Office. Some Sorting Office actions use macros as parameters. Thus, for example, you can move a message to a folder named %ODATE="yyyy-mm" (year and month of the message) or %ABFROMNAME (sender's name in address book), while folders will be created automatically.

Back to the list