Автоматическое выполнение отчета |
Оглавление Назад Далее |
Модуль АльфаЦЕНТР Генератор отчетов может автоматически выполнять команды отчета, т.е. поддерживает работу в пакетном режиме. Пакетный режим работы - это работа по созданию отчета без участия пользователя и без вывода сообщений на экран.
Для запуска модуля АльфаЦЕНТР Генератор отчетов в пакетном режиме необходимо запустить модуль с параметрами (в квадратных скобках [] указываются необязательные параметры, кроме значений в параметре 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 "Пример автоматизации создания отчета".
|