Этот Report Explorer позволяет использовать шаблоны для форматирования отчетов. Шаблон является документом HTML или Word, который задает фиксированное содержимое, формат и размещение вашего отчета. Можно использовать Microsoft® Шаблоны Word для форматирования отчетов Word и PDF и HTML-шаблонов для форматирования отчетов HTML и PDF. MATLAB® Report Generator™ поставляется с набором шаблонов Word по умолчанию для отчетов PDF и Word и шаблонов HTML для отчетов PDF и HTML. Можно создать собственные шаблоны путем копирования и настройки этих шаблонов по умолчанию.
Этот Report Explorer предоставляет набор основанных на шаблонах типов выхода отчетов. Эти типы выхода появляются в выпадающем списке File format в корневом Form генератора отчетов или Reporter компоненте. Выбор типа выхода на основе шаблонов заполняет соседний раскрывающийся список шаблонами, доступными для этого типа выхода, включая встроенные шаблоны Report Explorer и любые шаблоны, которые существовали в пути MATLAB или в текущей директории в начале вашего Сеанса работы с MATLAB. По умолчанию Report Explorer использует шаблон по умолчанию для форматирования отчета для заданного типа выхода. Можно задать другой шаблон, выбрав из смежного списка.
Основанные на шаблонах выходные типы
| Name on Form компонент | Name on Report компонент | Производит |
|---|---|---|
Direct PDF | Direct PDF (from template) | Представление объектов форматирования (FO) содержимого и формата отчета на основе HTML шаблона с специфичными для PDF расширениями. Представление FO преобразуется в PDF. |
PDF (from Word) | PDF (from Word template) | Отчет Microsoft Word из шаблона Microsoft Word, а затем использует Microsoft Word для преобразования отчета Word в PDF. Этот тип выхода доступен только в Windows. Размер отчета ограничен емкостью интерполяции Word, обычно около 500 страниц. |
HTML | HTML(from template)
| Пакет отчетов HTML из пакета шаблона HTML. Отчет и шаблон являются zip- файлов, которые содержат HTML документы, таблицы стилей, изображения и JavaScripts. |
Single-File HTML | Single-File HTML (from template) | HTML-отчет из пакета шаблона HTML. Отчет о HTML представляет собой один HTML файла, которая встраивает текст отчета, таблицы стилей, изображения и JavaScripts. |
Word | Word (from template) | Отчет Microsoft Word из отчета Word. |
Кроме шаблонов, Report Explorer поддерживает использование таблиц стилей XSL или DSSSL для форматирования отчетов. Таблица стилей XSL - это программа, написанная на диалекте XML под названием XSL, которая преобразует и форматирует промежуточные XML- содержимое отчета в HTML или PDF выхода. Таблица стилей DSSSL - это программа, написанная на диалекте Lisp, которая преобразует промежуточные XML- содержимое отчета в Microsoft Word выхода. Report Explorer поддерживает форматирование на основе таблиц стилей, чтобы обеспечить обратную совместимость с генераторами отчетов, разработанными в Report Explorer в релизах, которые предшествовали доступности шаблонов. Шаблоны следует использовать исключительно для новых генераторов отчетов, разрабатываемых с помощью Report Explorer. Это связано с тем, что шаблоны имеют значительные преимущества перед таблицами стилей:
Форматирование: таблицы стилей XSL и DSSL имеют ограниченные опции форматирования. Для примера все заголовки и все абзацы тела в вашем отчете должны иметь одинаковый формат. Напротив, шаблоны позволяют использовать все опции форматирования, доступные в документах Microsoft Word и HTML.
Масштабируемость: В Report Explorer используется файловый конвертер на основе MATLAB, называемый db2dom, для преобразования отчетов на основе шаблонов. Report Explorer использует Java-основанные конвертеры файлов, xslt и JADE, для преобразования отчетов на основе таблиц стилей XSL и DSSSL. The db2dom конвертер обычно имеет порядок величины быстрее, чем xslt и JADE и не использует Java память для Word и HTML выхода и гораздо меньше памяти для PDF вывода. В результате Report Explorer может создавать гораздо большие отчеты с шаблонами, чем выходы на основе таблиц стилей.
Каждый шаблон отчета содержит таблицу стилей. Эта таблица стилей, не путать с таблицей стилей XSL или DSSSL, является документом, который задает именованные наборы форматов текста, абзаца, списка и таблицы, называемые стилями. Во время генерации отчетов конвертер файлов Report Explorer, db2dom, копирует таблицу стилей шаблонов в сгенерированный отчет и присваивает имена стилей абзацам, тексту, спискам и таблицам, сгенерированным компонентами генератора отчетов. Программа, которая используется для отображения или печати отчета, например браузер HTML или Microsoft Word, использует стили для форматирования отчета.
Стандартные шаблоны Report Explorer определяют все стили, необходимые для форматирования отчета, сгенерированного Report Explorer из файла настройки отчета. Чтобы отличить их от других стилей, имена этих стилей начинаются с префикса rg, для примера, rgParagraph. Внешний вид отчета можно изменить, настроив определения (но не имена) этих стилей в копии шаблона по умолчанию и используя копию для создания отчета.
Можно также задать собственные стили в настраиваемом шаблоне и назначить их компонентам, диалоговые окна которых содержат свойство StyleName. Компоненты, которые имеют свойство StyleName, включают Text и Paragraph компоненты. Таким образом можно настроить внешний вид отдельных образцов компонента. Например, стиль по умолчанию для Paragraph компонента rgParagraph. Путем создания и назначения собственного стиля, например, myParagraphдля конкретного Paragraph компонента можно дифференцировать внешний вид вывода этого компонента от выходных данных абзацев, имеющих значение по умолчанию rgParagraph стиль.
Шаблоны по умолчанию для Report Explorer содержат библиотеку шаблонов компонентов. Библиотека шаблонов компонентов является документом, который задает шаблоны для компонентов Report Explorer, таких как компонент Title Page и компонент Chapter/Section. Каждый шаблон в библиотеке имеет имя, например rgRectoTitlePage, что позволяет генератору отчетов находить шаблон компонента в библиотеке. Библиотека компонентов позволяет одному шаблону, называемому основным шаблоном, содержать все шаблоны, необходимые для форматирования отчета, сгенерированного из основного шаблона.
Формат компонента отчета, например страницы заголовка, можно изменить, настроив его шаблон в копии шаблона по умолчанию и используя этот пользовательский шаблон для создания отчета. Можно также создавать и хранить шаблоны для Subform компонентов в основном шаблоне Form компонента. Таким образом можно создать пользовательские компоненты отчетов с пользовательским содержимым и пользовательскими форматами. Для примера можно создать пользовательский шаблон страницы заголовка и использовать его с Subform компонентом, чтобы сгенерировать страницу заголовка, которая содержит содержимое, не заданное компонентом Title Page, например, блок входа.
Шаблоны компонентов Report Explorer по умолчанию содержат заполнители, называемые отверстиями, которые обозначают, куда вставлять сгенерированное содержимое относительно фиксированного содержимого шаблона и другого сгенерированного содержимого. Например, шаблоны Title Page компонента содержат отверстия для заголовка отчета, субтитра, автора, абстрактного текста и т.д. Во время генерации отчетов Report Explorer заменяет эти отверстия сгенерированным содержимым. Для примера он заменяет отверстие заголовка в шаблоне Title Page на заголовок, заданный свойством Title Title Page компонента.
Можно изменить размещение и содержимое компонента, задающего содержимое, переставив или удалив его отверстия. Для примера можно удалить или настроить расположение субтитра страницы заголовка путем перемещения или удаления отверстия субтитра в шаблоне Title Page компонента. Можно также включать отверстия в шаблоны, которые вы создаете для Form и Subform компонентов, и заполнять эти отверстия, используя Template Hole компоненты в файле настройки генератора отчетов. Таким образом, для примера можно сгенерировать заголовок страницу, которая точно соответствует вашему заголовку макету страницы и требованиям к формату.
При первом открытии Report Explorer в сеансе работы с MATLAB он ищет шаблоны в пути MATLAB. Он хранит все шаблоны, которые он находит в кэше. Кроме того, в кэш добавляются все шаблоны, созданные в сеансе. Впоследствии он ищет в кэше любой заданный шаблон, который отсутствует в текущей директории. Это позволяет избежать необходимости поиска по пути MATLAB каждый раз, когда Report Explorer должен генерировать отчет на основе шаблона. Если вы пытаетесь использовать шаблон, который не находится в пути MATLAB в начале сеанса работы с MATLAB, Report Explorer указывает, что он не может найти шаблон. В этом случае можно либо изменить рабочую директорию MATLAB на директорию в директорию шаблонов, либо можно добавить директорию в путь MATLAB и обновить кэш. Чтобы обновить кэш, выполните
>> rptgen.db2dom.TemplateCache.getTheCache(true);
в командной строке MATLAB.