Субъект “Формирование отчета”. Пример расположения субъекта. Окно настройщика субъекта. Окно выбора каталога отчета

Субъект “Формирование отчета”

Субъект “Формирование отчета” предназначен для генерации отчета по выполненной методике и его сохранения. Субъект применяется только как часть методики и должен выполняться после субъекта “Инициализация методики” и перед субъектом “Очистка данных”.

Расположение

Субъект “Формирование отчета” расположен во всех методиках, результатом которых является отчет. Например, данный субъект есть в методике “Зерно в стали, ГОСТ 5639”, расположенной в каталоге Металлографические методики / Анализ зерна в стали (рис. 1).

Настройщик: внешний вид

Вид окна настройщика субъекта приведен на рис. 2.

Настройщик: описание

Файл отчета генерируется как файл формата ‘rtf’ на основе шаблона, созданного ранее разработчиком методики. Шаблон также представляет собой файл формата ‘rtf’ (обязательно), в котором обозначается структура отчета, а на месте будущих числовых и символьных результатов указываются строки подстановки.

Имя файла шаблона указывается в строке “Входной файл”. Имя сгенерированного файла отчета – в строке “Выходной файл”. Строковая последовательность, заключенная между двумя символами ‘%’ (например, ‘%siams600%’) является служебной и интерпретируется субъектом:

·  строка ‘%siams600%’ заменяется строкой каталога SIAMS 600, например, C:\Siams600.

·  строка ‘%reportdir%’ заменяется строкой каталога отчетов SIAMS 600, например, C:\Siams600\Report.

·  строка ‘%ipl%’ указывает, что последующая строковая последовательность является переменной языка IPL периода выполнения.

Если включен флаг “Создавать каталог для отчета”, то путь выходного файла игнорируется, и при запуске субъекта на выполнение местоположение файла отчета пользователь должен будет указать в окне “Выбор каталога отчета” (рис. 3).

Например, если хотим поместить отчет в папку C:\Отчеты, то пишем имя каталога в строке “Имя каталога отчета”. При нажатии кнопки “OK” отчет будет помещен в нужный каталог (а каталог, при необходимости, создан). Если в указанном каталоге уже существует файл с таким же именем, и если ранее в окне подготовки отчета был включен флаг “Предупреждать о перезаписи отчета”, то будет предложено либо переписать старый файл новым, либо не изменять старый файл (тогда для сохранения нового отчета нужно будет еще раз указать другой каталог в окне выбора каталога). Если флаг “Предупреждать о перезаписи отчета” был выключен, то запись происходит всегда.

Флаг “Автоматически запускать просмотр отчета” определяет, надо ли субъекту запускать программу просмотра файла отчета (например, Microsoft Word) сразу после его генерации. Когда флаг включен, просмотр запускается, когда выключен, – не запускается.

Таблица “Описание замены текста” определяет строк в файле шаблона. В столбце “Строка входного файла” указываются строки в файле шаблона, подлежащие замене, в столбце “Строка выходного файла” – какие значения подставлять вместо строк. Столбец “Пар” определяет режим замены строк. Значение в этом столбце может принимать следующие значения: ‘ ‘, ‘i’, ‘w’, ‘iw’, где наличие одного из символов включает соответствующий режим:

·  ‘i’ – ignore case – игнорировать регистр букв;

·  ‘w’ – word only – только слово целиком.

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

Поле “Разделители слов” в окне подготовки отчета определяет, какие символы являются разделителями строк. Например, если в качестве разделителей указаны ‘=+-’, то текст ‘iplString_1+iplString_2=iplString_3’ содержит три строки: ‘iplString_1’, ‘iplString_2’ и ‘iplString_3’.

Таблица “Подготовка графиков и таблиц” предназначена для сопоставления графиков, гистограмм и таблиц результатов Siams600 графическим файлам формата ‘wmf’. В столбце “Имя файла отчета” указываются файлы графиков, гистограмм, таблиц, а в столбце “Имя файла отчета” – соответствующие им графические файлы. Также как и в случае с полем “Выходной файл”, если включен флаг “Создавать каталог для отчета”, то путь в строке “Имя файла отчета” игнорируется. Столбец “dpi” указывает разрешение, с которым следует записать графический файл.

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

Таблица “Запись регистров анализатора” предназначена для сопоставления регистров Siams600 графическим файлам формата ‘bmp’, которые будут вставлены в отчет. В столбце “Регистр” указываются номера регистров, а в столбце “ранее ” – под какими именами следует сохранить регистры как файлы формата ‘bmp’. Также как и в случае с полем “Выходной файл”, если включен флаг “Создавать каталог для отчета”, то путь в строке “Имя выходного файла” игнорируется. Столбец “x/dpi” указывает увеличение, с которым следует записать графический файл.

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

Флаг и поле “Заменять пустые регистры файлом” определяют, вставлять ли в отчет вместо пустых регистров графический файл.

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

Рекомендации

Основные настройки субъекта “Формирование отчета” производит разработчик методики, в которой этот субъект расположен. Пользователю может понадобиться изменять только режим флагов “Создавать каталог для отчета”, “Предупреждать о перезаписи отчета”, “Автоматически запускать просмотр отчета”, поле “Выходной файл”, значения в столбце “x/dpi” в таблице “Запись регистров анализатора”. Непродуманное изменение других параметров настройщика субъекта может привести к ошибкам в генерации отчета.

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

Как правило, файлы шаблонов расположены в каталогах Template/.