19 - Report Files
19.1 Обзор
В этой главе вводится понятие "Файлы отчетов": это файлы сценариев, которые позволяют пользователю сформулировать процесс генерации согласованных выходных данных программы. Они основаны на пакетных командах и пакетных файлах, поэтому пользователи должны быть знакомы с ними (см. предыдущие главы). Сочетая функциональность пакетных команд с дополнительными инструкциями по форматированию, такими как "новая страница", различные форматы отчетов могут быть объединены в единый отчетный документ. Аналогично пакетным файлам файлы отчетов запускаются, редактируются и управляются с помощью утилиты инструмент. Файлами отчетов могут обмениваться пользователи либо через общее расположение файлов, либо через локальные копии одних и тех же файлов. "Стандартные" файлы отчетов могут быть добавлены в меню интерфейса и списки, и эти списки сохраняются как часть INI-файла. Отчеты, созданные таким образом, могут быть отправлены прямо на принтер или в файл. В качестве альтернативы они могут быть отображены в текстовом редакторе, который предоставляет возможность редактировать / форматировать содержимое перед печатью.
Файлы отчетов используются для стандартизации и оптимизации процесса составления отчетов по результатам анализа приостановки. Они используют пакетные команды и пакетные файлы для загрузки, решения и отображения результатов, в то время как дополнительные параметры форматирования, такие как перевод строки и новая страница, включены для создания ‘стандартных’ форматов отчетов.
Файлы отчетов представляют собой текстовые файлы в формате ASCII, которые, хотя и похожи по форме на Пакетные файлы имеют некоторые специфические макеты и форматы и, таким образом, обычно не редактируются с помощью простого текстового редактора. Интерфейс обеспечивает инструмент "управление", как и в случае с пакетными файлами, но опция "Редактировать" открывает уникальный инструмент для редактирования электронных таблиц.
19.2 Элементы и аргументы файла отчета
Файлы отчетов состоят из последовательности строк, каждая строка определяет действие, результат или какое-либо другое релевантное действие. Ниже перечислены доступные элементы и связанные с ними аргументы.
Single Line of Text: Добавляет одну строку текста в документ отчета. Аргументами являются: текстовая строка, цвет шрифта, размер шрифта, выделение жирным шрифтом вкл/выкл, курсив вкл/выкл, Подчеркивание вкл/выкл, зачеркивание вкл/выкл, Надстрочный индекс вкл/выкл, Подстрочный индекс вкл/выкл, Выравнивание, перевод строки и тип шрифта.
Text file: Добавляет содержимое предоставленного текстового файла в документ отчета. Аргументами являются: имя файла, цвет шрифта, размер шрифта, выделение жирным шрифтом вкл/выкл, курсив вкл/выкл, Подчеркивание вкл/выкл, зачеркивание вкл/выкл, Надстрочный индекс вкл/выкл, Подстрочный индекс вкл/выкл, Выравнивание, перевод строки и Тип шрифта.
Single Blank Line: добавляет пустую строку (следовательно, подразумеваемый перевод строки) в документ отчета. Никаких споров.
Single Space: добавляет один пустой пробел в документ отчета в текущей позиции. Никаких споров.
Single Character: добавляет один символ в документ отчета в текущей позиции и с использованием текущих атрибутов шрифта. Единственный аргумент - Символ.
New Page: Добавляет разрыв страницы в документ отчета. Никаких споров.
Single Batch Command Line: выполняет пакетную команду или серию пакетных команд. Он не добавляет результаты в отчет, он просто допускает необходимые изменения данных, средства решения и т.д., Которые могут потребоваться для последующего включения требуемых результатов. Аргументами являются; строка пакетной команды.
Batch Command File: Так же, как и "однопакетная командная строка", это не добавляет результатов в отчет. Определенный пакетный файл будет содержать командные строки, необходимые для внесения изменений в данные, изменения в решателе и т.д., Чтобы впоследствии требуемые результаты могли быть добавлены в отчет. Аргументами являются; пакетный командный файл.
Formatted SDF: Включает результаты SDF, отформатированные по указанным углам, в документ отчета с использованием определенного набора форматов. Аргументами являются: цвет шрифта, размер шрифта, выделение жирным шрифтом включено/выключено, курсив включен/выключено, Подчеркивание включено/выключено, Зачеркивание включено/выключено, Надстрочный индекс включен/выключен, Подстрочный индекс включен/выключен, Выравнивание, Тип шрифта, номер угла и номер набора формата.
SDF Spline Fits: включает результаты подгонки по сплайну SDF с указанными углами в документе отчета с использованием заданного набора форматов. Аргументами являются: цвет шрифта, размер шрифта, выделение жирным шрифтом включено/выключено, курсив включен/выключено, Подчеркивание включено/выключено, Зачеркивание включено/выключено, Надстрочный индекс включен/выключен, Подстрочный индекс включен/выключен, Выравнивание, Тип шрифта, номер угла и номер набора формата.
SDF Spline Data: включает результаты данных SDF-сплайна с указанными углами в документе отчета с использованием определенного набора форматов. Аргументами являются; цвет шрифта, размер шрифта, Жирный шрифт включен/выключен, Курсив включен / выключен, Подчеркивание включено/выключено, Зачеркивание включено/выключено, Надстрочный индекс включен/выключен, Подстрочный индекс включен/выключен, Выравнивание, Тип шрифта, номер угла и номер набора формата.
Bush Deflections: Включает результаты отклонения втулок по указанным углам в отчетный документ с использованием заданного набора форматов. Аргументами являются; цвет шрифта, размер шрифта, Жирный шрифт вкл/выкл, Курсив вкл /выкл, Подчеркивание вкл /выкл, Зачеркивание вкл /выкл, Надстрочный индекс вкл /выкл, Подстрочный индекс вкл /выкл, Выравнивание, Тип шрифта и номер угла.
Joint-Bush Rotations: Включает результаты поворота шарнирной втулки по указанным углам в отчетный документ с использованием заданного набора форматов. Аргументами являются: цвет шрифта, размер шрифта, выделение жирным шрифтом вкл/выкл, Курсив вкл/выкл, Подчеркивание вкл/выкл, зачеркивание вкл/выкл, Надстрочный индекс вкл/выкл, Подстрочный индекс вкл/выкл, Выравнивание, тип шрифта и номер угла.
Bush Forces: включает результаты измерения усилия на втулке по указанным углам в документе отчета с использованием заданного набора форматов. Аргументами являются: цвет шрифта, размер шрифта, выделение жирным шрифтом вкл/выкл, Курсив вкл/выкл, Подчеркивание вкл/выкл, зачеркивание вкл/выкл, Надстрочный индекс вкл/выкл, Подстрочный индекс вкл/выкл, Выравнивание, тип шрифта и номер угла.
Formatted Point Forces: включает результаты отформатированных точечных усилий по указанным углам в документе отчета с использованием заданного набора форматов. Аргументами являются: цвет шрифта, размер шрифта, выделение жирным шрифтом включено/выключено, курсив включен/выключено, Подчеркивание включено выключено, Зачеркивание включено/выключено, Надстрочный индекс включен/выключен, Подстрочный индекс включен/выключен, Выравнивание, Тип шрифта, номер угла и номер набора формата.
List All Point Coords for User Position: Включает список всех точек для указанного угла в заданной позиции пользователя. Аргументами являются: цвет шрифта, размер шрифта, выделение жирным шрифтом вкл /выкл, курсив вкл /выкл, Подчеркивание вкл / выкл, зачеркивание вкл / выкл, Надстрочный индекс вкл / выкл, Подстрочный индекс вкл /выкл, Выравнивание, Тип шрифта, номер угла, перемещение по неровностям, направление движения и крен.
List a Point Coords at All Positions: Включает список указанных точек для требуемого угла во всех текущих точках решения. Аргументами являются; цвет шрифта, размер шрифта, Жирный шрифт включен/выключен, Курсив включен / выключен, Подчеркивание включено/выключено, Зачеркивание включено/ выключено, Надстрочный индекс включен/ выключен, Подстрочный индекс включен/ выключен, Выравнивание, Тип шрифта, номер угла и метка точки (или номер точки).
List All Point Coords at a Position: Включает список всех точек для указанного угла в заданном положении. Аргументами являются: цвет шрифта, размер шрифта, выделение жирным шрифтом вкл/выкл, курсив вкл/выкл, Подчеркивание вкл/выкл, зачеркивание вкл/выкл, Надстрочный индекс вкл/выкл, Подстрочный индекс вкл/выкл, Выравнивание, тип шрифта, номер угла и метка позиции (или номер позиции).
Insert User Window: Вставляет пользовательское окно/элемент управления в виде встроенного изображения в отчет. Аргументами являются: Номер пользовательского окна (или метка пользовательского окна), перевод строки и выравнивание.
Insert Visible Graph: Вставляет видимый график в виде встроенного изображения в отчет. Доступны только открытые в данный момент графики, поэтому необходимо будет использовать пакетные команды, чтобы убедиться, что они открыты, прежде чем включать их. Аргументами являются; Номер графика (или SDF Метка), Подача строки и выравнивание.
Insert Current Graphics: Вставляет текущее графическое представление в виде встроенного изображения в документ отчета. Аргументы таковы: Перевод строки и обоснование.
Insert Current AVI as File: Вставляет текущую анимационную последовательность в виде встроенного Объект AVI в документе отчета (включенный подобным образом в документ Word, он может быть просмотрен / анимирован непосредственно из Word при распространении документа). Аргументы таковы: Перевод строки и обоснование.
Insert Ball Joint Target Rotation: Вставляет графическое отображение целевого поворота шарового шарнира для указанной точки. Аргументами являются: Установка No, Угол (необязательно), точка No (необязательно), Короткая метка точки (необязательно), Перевод строки и выравнивание.
19.3 Запуск файла отчета в командном режиме
Файлы отчетов можно запускать из приложения, находясь в ‘Command Mode’ (не путать с командной строкой Windows). Например, вы могли бы ввести следующую короткую команду, FI RE RU report1.rpt
или FI RE RU <install>report1.rpt
Опция Run (RU) запустит только файл отчета. Если вы хотите впоследствии просмотреть файл отчета, вам нужно будет открыть rich text display (DI). Чтобы распечатать текущий отчет, выберите команду печать (PR). Обратите внимание, что вы можете указать как командам отображения, так и командам печати необязательное имя файла, чтобы он открывался или печатался с использованием нового файла отчета. Обратите внимание, что отображение и печать в настоящее время не поддерживают номер файла, это должно быть имя файла.
Приложение предоставляет список стандартных файлов ‘report’. Они могут быть добавлены / упорядочены с помощью инструмента в главном графическом интерфейсе. В командном режиме вы можете перечислить стандартные файлы с помощью команды FI RE LI short string. Они перечислены по номерам, и затем их можно запустить либо по имени файла, либо, проще говоря, по его номеру (см. комментарий выше о параметрах отображения и печати).
В командном режиме предусмотрены опции для просмотра (BR) файла отчета, списка (DIR) содержимое текущего каталога или измените (CD) текущий каталог. Обратите внимание, что для конкретных серверных установок поддерживается использование строки "<install>" как части имени файла, где "<install>" автоматически заменяется программным обеспечением с фактическим расположением папки установки программного обеспечения.
Печать управляется локальными свойствами печати, которые можно редактировать с помощью команды настройки локального принтера (SE).
19.4 Использование файлов отчетов в графическом интерфейсе
Файлы отчетов можно запускать непосредственно из меню результатов. Точно так же, как и при запуске в командном режиме, предоставляется список ‘standard’ файлов отчетов вместе с возможностью поиска файла. Запуск файла результатов из графического интерфейса приведет к открытию расширенного текстового отображения ‘results report’ и отображению созданного документа отчета.
Как только файл отчета будет готов, отображаемый отчет можно будет отредактировать, используя функциональные возможности форматированного текстового редактора. В качестве альтернативы его можно отправить на принтер, сохранить в форматированном текстовом документе или открыть непосредственно в Word.
Чтобы добавить существующий файл отчета в список значений по умолчанию, либо воспользуйтесь пунктом главного меню File / Manage Report Batch Files / Add Report File to List… и используйте браузер, чтобы найти необходимый файл, или из того же подменю откройте Report Batch File List Status…
Отображение ‘Report Batch File list – status’ позволяет добавлять другие файлы отчета таким же образом, как и предыдущий элемент, через обычный браузер. Он также предоставляет доступ к ряду других функций файла отчета. К ним относятся изменение порядка файлов в списке, удаление (всех) файлов, редактирование файла из списка, запуск файла из списка или создание/редактирование нового файла отчета.
Чтобы применить некоторые из этих действий, выделите нужный файл из списка: это включит дополнительные опции. Большинство из этих вариантов говорят сами за себя. Опция ‘Edit’ открывает электронную таблицу редактора определенного файла отчета для отображения содержимого выбранного файла (или пустую для ‘new’ файла), чтобы разрешить редактирование формата отчета (см. предыдущее обсуждение функциональных элементов и аргументов).
19.5 Пакетные файлы отчетов для конкретного сайта
Ожидается, что отдельные пользовательские сайты будут настроены таким образом, чтобы предоставлять список общекорпоративных ‘standard’ пакетных файлов отчетов. Как пользователь, вы можете сыграть важную роль в создании новых ‘standard’ пакетных файлов отчетов или просто использовать пакетные файлы отчетов, созданные другими пользователями. В любом случае вам, возможно, потребуется понять, где хранятся (или могли бы храниться) эти пакетные файлы отчетов, чтобы обеспечить доступ ко всему сайту.
19.6 Упражнение: Создание примера файла отчета
Мы создадим новый файл отчета, который воспроизводит упражнение из предыдущих глав, но вместо того, чтобы выводить результаты в окно пакетной обработки, мы создадим отображение файла отчета.
В главном интерфейсе мы откроем новый файл отчета и воспользуемся локальной таблицей редактирования, следуя приведенной ниже записи.
File / Manage Report Batch Files / Report Batch File List Status…
Нажмите кнопку Создать, чтобы открыть электронную таблицу редактора для нового файла. Мы будем вводить наши пакетные команды аналогично предыдущему, но будем использовать параметр ‘output’ для Отформатированный SDF, а не пакетная команда. Выполните действия, описанные ниже.
Задайте тип ‘Single Batch Command’ и строку как “//FI OP BR”
Задайте тип ‘Single Batch Command’ и строку как “//MO 3R”
Установите тип на ‘Formatted SDF…’, установите выравнивание по ‘Left’ и настройку на ‘set 5 Roll Exercise’
Установите тип на ‘Single Batch Command’ и строку как “//DA TY ED "Rolling Radius (mm)" 245.0 1”
Установите тип на ‘Formatted SDF…’, установите выравнивание по ‘Left’ и настройку на ‘set 5 Roll Exercise’
Верхняя половина записи должна выглядеть так же, как показано на снимке экрана ниже. Строки комментариев не являются обязательными.
Теперь сохраните файл отчета в подходящей папке как “exercise1.rpt”. Вам будет предоставлена возможность добавить этот файл отчета в список файлов отчетов по умолчанию, выберите Yes. Теперь мы можем запустить этот файл отчета с экрана состояния. Выделите файл и нажмите кнопку Выполнить. Выберите опцию Run – Go to Display. Выберите файл примера, и на экране появится редактор расширенного текста отчета с нашими двумя наборами отформатированных результатов.
Попробуйте запустить некоторые другие параметры ‘run’, такие как "открыть в word в формате rtf.