Приложение 3 "Макроподстановки"

Макроподстановки могут быть использованы для формирования имени файла при сохранение отчета в пакетном режиме и при экспорте отчета в ручном и пакетном режимах.

Параметры макроподстановок должны обрамляться символом "%" - процент. Регистр имеет значение.

Параметр	Описание
%date%	Дата в формате dd.mm.yyyy
%time%	Время в формате hh:nn
%NOW%	Дата и время в формате dd.mm.yyyy_hh:nn:ss
%now%	Дата и время в формате dd_mm_yyyy_hh_nn_ss
%Now%	Дата и время в формате dd.mm.yyyy hh:nn:ss
%DD%	Номер числа из даты в формате dd (с ведущим нулем)
%PREVDD%	Номер числа из предыдущей даты в формате dd (с ведущим нулем)
%MM%	Номер месяца из даты в формате mm (с ведущим нулем)
%YY%	Номер года из даты в формате yy (2 цифры)
%YYYY%	Номер года из даты в формате yyyy (4 цифры)
%DATE%	Дата в формате dd_mm_yyyy
%TIME%	Время в формате hh_nn
%D%	Номер числа из даты в формате d (без ведущего нуля)
%M%	Номер месяца из даты в формате m (без ведущего нуля)
%YESTERDAY%	Вчерашняя дата в формате dd.mm.yyyy
%TOMORROW%	Завтрашняя дата в формате dd.mm.yyyy
%yesterday%	Вчерашняя дата в формате dd_mm_yyyy
%tomorrrow%	Завтрашняя дата в формате dd_mm_yyyy
%PREVMONTH%	Прошлый месяц в формате mm, т.е. номер месяца
%prevmonth%	Прошлый месяц в формате mmmm, т.е. название месяца
%CURMONTH%	Текущий месяц в формате mm, т.е. номер месяца
%curmonth%	Текущий месяц в формате mmmm, т.е. название месяца

Пример использования - имя файла задано в виде: "C:\Primer\Мои_данные_ за_ %DATE%_Подстанция1.xlsx".

•При использование параметра -values указывает, что дальше (после двоеточия) будут указаны значения ячеек в виде адрес=значение, где адрес - это строка вида Лист!Ячейка, а значение - произвольная строка. Допускается указывать несколько пар ячеек-значений, каждая пара берется в квадратные скобки. Если указано несуществующее имя листа или имя из диспетчера имен, то пара игнорируется. Адреса так же берутся в квадратные скобки, например, [Лист1!A1=Подстанция].

•Для использования форматных масок в именах файлах необходимо брать форматную маску в фигурные скобки, например, {yyyy_dd_mm};

•Для доступа к ячейкам отчета адреса ячеек надо брать в "скобки" меньше/больше (<>), например, <Лист1!A1=Подстанция>;

•при выборе имени нового файлов с указанием имени файла вручную со ссылками на ячейки отчета через диалоговые окна необходимо использовать символы [[ и ]], вместо <> из-за ограничений имен файлов в ОС. Символы [[ и ]] будут автоматически заменены на <> при выборе файла;

Так же можно использовать значения ячеек отчета, указывая в полном имени файла ссылки на ячейки в виде <Лист!Ячейка>, например <ЛистОтчета!A5>. Для указания, что используется ссылка на ячейку отчета необходимо текст ссылки обрамлять символами "<" в начале и ">" в конце. Если в ссылке не указан лист, то подразумевается первый лист отчета. При выборе имени файла через формы выбора необходимо в имени файла вместо символов < и > (они запрещены в имени файла из-за ограничений ОС) указывать символы [[ и ]] соответственно. Они будут автоматически заменены на символы < и > при работе модуля;

Так же можно указать дату и время в произвольном формате, используя форматные маски, заключенные в фигурные скобки. Например, имя файла задано как C:\Report\{yyyy}\Отчет_за_{mm_dd}_сформирован_{hh_mm}.xlsx, при экспорте оно будет преобразовано (текущая дата 31.03.2018) в C:\Report\2018\Отчет_за_03_21_сформирован_09_23.xlsx

имя файла задано в виде: "C:\Primer\Мои_данные_за_%DATE%.xlsx". 19 мая 2011 года файл будет называться "C:\Primer\Мои данные за 19_05_2011.xlsx";

имя файла задано в виде: "C:\Primer\Мои_данные_за_%DATE%_объект_<Лист1!B8>.xlsx". 19 мая 2011 года файл будет называться "C:\Primer\Мои_данные_за_19_05_2011_объект_ ТЕКСТ_ИЗ_ЯЧЕЙКИ_B8_Лист1.xlsx", где ТЕКСТ_ИЗ_ЯЧЕЙКИ_B8_Лист1 - реальный текст из указанной ячейки отчета.