Автоматическое выполнение отчета

 Модуль АльфаЦЕНТР Генератор отчетов может автоматически выполнять команды отчета, т.е. поддерживает работу в пакетном режиме. Пакетный режим работы - это работа по созданию отчета без участия пользователя и без вывода сообщений на экран.

Для запуска модуля АльфаЦЕНТР Генератор отчетов в пакетном режиме необходимо запустить модуль с параметрами (в квадратных скобках [] указываются необязательные параметры, кроме значений в параметре values):

C:\AlphaCenter\ACReport\ACReport.exe -batch acreport-файл/acreportparams-файл [-values:[Лист1!A1=Подстанция][Лист2!B2=1.09.2016]],

•-batch - запускает модуль в пакетном режиме;

•acreport-файл - полное имя файла отчета;

•acreportparams-файл - полное имя файла параметров отчетов. Данный файл может содержать параметры командной строки в таком же виде, как и параметры командной строки при запуске модуля. Например, файл может содержать следующие строки:

-batch c:\Sample\отчет1.acreport

-batch c:\Sample\отчет1.acreport -values:[лист1A1=Подстанция1]

-batch c:\Sample\отчет1.acreport -values:[лист1A1=Теплоподстанция2]

c:\Sample\отчет2.acreport -values:[лист1A2=1.06.2023][лист1A3=30.06.2023]

В этом случае будет выполнен отчет с именем "отчет1", затем он же передачей значения "Подстанция" в ячейку "A1", затем он же, но с передачей значения "Теплостанция2", затем будет выполнен отчет с именем "отчет2" и передачей значения "01.06.2023" в ячейку A2 и значения "30.06.2023" в ячейку A3. Каждая строка содержит одну строку параметров командной строки, все строки с параметрами будут выполнены в пакетном режиме (эквивалентно параметру -batch), параметр -batch указывать необязательно.

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

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

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

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

Ранее необходимо было указать файл параметров пакетного выполнения (файл с расширением *.acrpar), теперь аналогичные параметры указываются в свойствах самого отчета на закладке "Пакетное выполнение" и необходимо указывать сам файл отчета.

или

C:\AlphaCenter\ACReport\ACReport.exe -export acreport-файл [xlsx-файл],

•-export - запускает модуль в упрощенном пакетном режиме;

•acreport-файл - полное имя к файлу отчета;

•xlsx-файл  - имя файла, в который будет произведен экспорт отчета после выполнения всех команд отчета;

или

C:\AlphaCenter\ACReport\ACReport.exe -scenario acreport-файл [xlsx-файл],

•-scenario - запускает модуль в упрощенном пакетном режиме и выполняет сценарий;

•acreport-файл - полное имя к файлу отчета;

•xlsx-файл  - имя файла, в который будет произведен экспорт отчета после выполнения всех команд отчета;

Упрощенный пакетный режим подразумевает:

•На файл отчета не установлен пароль;

•При указание -export выполняются следующие действия - Выполнения команд отчета, Выполняется экспорт в файл MS Excel, Модуль завершает свою работу;

•При указание -scenario выполняются следующие действия - Выполнения сценария, Выполняется экспорт в файл MS Excel, Модуль завершает свою работу;

•Сохранения отчета не производится;

•Имя файла для экспорта совпадает с именем отчета, только имеет расширение .xlsx, если не указан параметр xlsx-файл;

 Таким образом, строка запуска приложения будет выглядеть следующим образом:

C:\AlphaCenter\ACReport\ACReport.exe -batch "c:\My Report\My Report.acreport",

или

C:\AlphaCenter\ACReport\ACReport.exe -export "c:\My Report\My Report.acreport"

или

C:\AlphaCenter\ACReport\ACReport.exe -scenario "c:\My Report\My Report.acreport"

где

•C:\AlphaCenter\ACReport\ACReport.exe - полный путь к модулю АльфаЦЕНТР Генератор отчетов;

•параметр -batch - опция, указывает что модуль будет работать в пакетном режиме;

•c:\My Report\My Report.acreport - полный путь к файлу отчет, если полный путь с именем файла содержит пробелы, то весь полный путь с именем файла необходимо брать в кавычки, например "c:\My Report\My Report.acreport";

•параметр -export - опция, указывает что модуль будет работать в упрощенном пакетном режиме;

•параметр -scenario - опция, указывает что модуль будет работать в упрощенном пакетном режиме и выполнять только сценарий;

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

•при указание только имен файлов (без параметров -batch, -export и т.п.), все файлы отчетов будут открыты;

При запуске из модуля "Запуск внешних приложений" в пакетном режиме и указание нескольких имен файлов *.acreport:

•модуль не передает Описание отчета, поскольку отчет не один;

•имена файлов отчета передаются так же, как они заданы в командной строке;

•сообщение о выполнение отчетов передается в виде "Исполнение отчета завершено успешно";

•значения, переданные как параметр -values, применяются для каждого отчета, если это возможно.

 Для пакетного исполнения в свойства отчета необходимо указать следующие параметры:

•Выполняемые действия:

1.Выполнить команды отчета - все команды отчета будут выполнены. Данные этих команд будут помещены на заранее указанные листы отчета;

2.Выполнить сценарий - будет выполнен только сценарий отчета. Команды отчета, которые не участвуют в сценарии выполняться не будут. Если в отчете не описан сценарий, то будут выполнены все команды отчета;

3.Выполнить экспорт в файл MS Excel - выгрузка данных в указанный файл MS Excel (поле "Имя файла для экспорта в формате MS Excel") в зависимости от настроек экспорта в MS Excel, указанный в отчете. Если имя файла указано в поле "Имя файла для экспорта в формате MS Excel", то при экспорте имя файла, указанное в настройках экспорта игнорируется;

4.Выполнить экспорт в файл CSV - выгрузка данных в указанный файл CSV (поле "Имя файла для экспорта в формате CSV") в зависимости от настроек экспорта в файл CSV, указанный в отчете. Если имя файла указано в поле "Имя файла для экспорта в формате CSV", то при экспорте имя файла, указанное в настройках экспорта игнорируется;

5.Сохранить отчет в файл - сохранение отчета в указанный файл (поле "Имя файла конечного отчета"). Если имя не указано, то отчет сохраняется с тем же именем;

•Имена файлов:

1.Имя файла конечного отчета - имя файла отчета, в который будет сохранен сформированный отчет, если установлено действие "Сохранить отчет в файл";

2.Имя файла для экспорта в формате MS Excel - имя файла MS Excel, в который будет произведен экспорт отчета в параметрами, указанными в настройках экспорта отчета в MS Excel;

3.Имя файла для экспорта в формате CSV - имя файла CSV, в который будет произведен экспорт отчета в параметрами, указанными в настройках экспорта отчета в CSV.

 После сохранения и экспорта модуль АльфаЦЕНТР Генератор отчетов информирует о результатах работы (созданных файлах или ошибках, если они возникли). Модуль АльфаЦЕНТР Запуск приложений может считывать результаты выполнения и передать дальше по модулям в рамках АльфаЦЕНТР Диспетчер заданий.

 Пример автоматизации формирования отчета и его экспорта в файл в формате MS Excel приведен в Приложение 4 "Пример автоматизации создания отчета".