"Автоматизация отчетов"

Активные макросы

На предприятиях часто возникает задачи автоматического вывода отчета при выполнении какой-либо важной операции. Примером может служить вывод документа при оправки проекта в производство. Для этого существует следующие формы вызова отчетов:

• макрос.вход_в_программу
• макрос.подготовка_расчет
• макрос.расчет_проекта
• макрос.изменение_статуса
• макрос.расчет_изделия
• макрос.сделан_резерв
• макрос.отмена_резерва
• макрос.в_производство
• макрос.отмена_производства
• макрос.проект_завершен
• макрос.групповой раскрой
• макрос.выгрузка_данных

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

Если определено несколько отчетов с требуемой формой вызова, то программа выведет диалоговое окно и предложит выбрать необходимый макрос. Активные макросы доступны при наличии модуля статистики и групповых операций. Примером использования автоматического макроса может служить запуск отчета нехватки материалов на складе после расчета проекта.

Запуск внешних программ

Для запуска внешних программ имеется команда: ~Отчет:Запустить_файл:…~ Причем файлом может быть любой файл, например документ (*.doc) - в этом случае запуститься MicroSoft Word и откроет указанный файл.

Примером применения команды может служить формирование пакета данных макросом и передача их производственной линии с числовым программным управлением с помощью внешней программы - драйвера, предоставленной производителем оборудования.

Примеры

<!-- запуск и просмотр прикрепленных к проекту документов -->
~SQL1:Установить:SELECT dNumb,dpath FROM DocsPrj~
~SQL1:Добавить:WHERE pUnic=:Индекс1.AsInteger: ORDER BY dNumb~
~SQL1:Начало~
~SQL1:dpath:AsString:ФАЙЛ~

~Отчет:Запустить_файл:ФАЙЛ.AsText~

~SQL1:Конец~

<!-- принудительное закрытие окна просмотра -->
~Отчет:Закрыть~

<!-- указание сформировать другой отчёт после закрытия предварительного просмотра текущего отчета (организация последовательного формирования нескольких отчётов) -->
~Отчет:Следующий:НазваниеОтчёта~

К СВЕДЕНИЮ
Для разделения синтаксиса в команде используется символ ':', и в некоторых случаях, при не правильном понимании работы генератора отчётов, возможно не выполнение команды. Например, запись файла в корень диска 'D:' с явным указанием имени файла в команде вместо параметра подстановки:

~Отчет:Запустить_файл:D:\ИмяФайла.exe~

не будет выполнена, так как здесь необходимо подставить служебный символ автозамены разделителя команд генератора '?':

~Отчет:Запустить_файл:D?\ИмяФайла.exe~

Сохранение отчёта во внешнем файле

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

~ОТЧЕТ:Сохранить_в_файл:ИмяФайла~ - явное указание пути с именем файла
~ОТЧЕТ:Сохранить_в_файл_?:ИмяФайла~ - вызов диалога сохранения файла с указанием имена файла по умолчанию

В набор поставляемых отчётов входит заготовка формы вызова "черновик" с практическим примером формирования имени файла с номером заказа и его сохранения:

~AsString:Заказ№='не найден'~
~SQL1:Установить:SELECT zNumb FROM ListPrj WHERE pUnic=:Индекс1.AsInt~
~SQL1:Начало~
~SQL1:zNumb:AsString:Заказ№~
~SQL1:Конец~

<!-- проверка допустимости символов для имени файла Windows -->
~AsString:Заказ№=VerFileName(Заказ№)~

~AsString:Файл=Система.Каталог.Присоединенные_Файлы~
~AsString:Файл=STRCAT(Файл,Заказ№)~
~AsString:Файл=STRCAT(Файл,'.html')~

~Отчет:Сохранить_в_файл:Файл.AsText~

Сохранение отчёта в формате MHT

При наличии модуля мультиформатной поддержки возможно использовать команду сохранения сформированного выходного отчёта в файле веб-архива MHT, в теле которого будет содержаться как сам текст отчёта, так все его изображения:
~MHT:FILE:D?\ProfSegment\Pic\Files\ИмяФайла.mht~ - явное указание пути с именем файла
~MHT:FILE:ИмяФайла.AsText~ - подстановка значения строкового параметра, ранее сформированного, например, с номером заказа

Эту команду можно помещать в любое место исходного текста, отчётов, так как её выполнение просходит только после завершения формирования отчёта.

Дополнительные команды

Для проектов имеется наглядный, визуальный функционал отметок. Для удобства написания макросов в генератор отчётов введены команды работы с отметками проекта:
~ОТМЕТКИ.ПРОЕКТ.УСТАНОВИТЬ:Отметка№:pUnic.AsInt~ - установить отметку на проект
~ОТМЕТКИ.ПРОЕКТ.СНЯТЬ:Отметка№.AsInt:pUnic.AsInt~ - снять отметку с проекта
~ОТМЕТКИ.ПРОЕКТ.ПРОВЕРИТЬ:Отметка№:Параметр~ - проверка установленной отметки на проект (если установлена, то создаётся параметр типа AsInt со значением 1, иначе - со значением 0)

Для программного изменения статуса проекта с записью в журнал статусов предусмотрена команда:
~Установить.Статус.Проекта:pUnic.AsInt:Статус.AsText~

Для реализации возможности создания специальных текстовых файлов формата UTF-8 в функционале генератора отчётов имеется команда:
~Отчет:ФОРМАТ_СОХРАНЕНИЯ:UTF-8~