Обозреватель отчетов позволяет использовать шаблоны для форматирования отчетов. Шаблон - это документ HTML или Word, который определяет фиксированное содержимое, формат и макет отчета. Шаблоны Microsoft ® Word можно использовать для форматирования отчетов Word и PDF, а шаблоны HTML - для форматирования отчетов HTML и PDF. Generator™ отчетов MATLAB ® поставляется с набором шаблонов Word по умолчанию для отчетов PDF и Word и HTML для отчетов PDF и HTML. Можно создать собственные шаблоны путем копирования и настройки этих шаблонов по умолчанию.
Обозреватель отчетов предоставляет набор типов вывода отчетов на основе шаблонов. Эти типы выходных данных отображаются в выпадающем списке Формат файла в корневом компоненте Form или Reporter генератора отчетов. Выбор типа вывода на основе шаблона заполняет соседний выпадающий список шаблонами, доступными для этого типа вывода, включая встроенные шаблоны Report Explorer и любые шаблоны, которые существовали на пути MATLAB или в текущем каталоге в начале сеанса MATLAB. По умолчанию в проводнике отчетов используется шаблон по умолчанию для форматирования отчета для указанного типа вывода. Можно указать другой шаблон, выбрав его из смежного списка.
Типы вывода на основе шаблона
| Имя компонента формы | Имя компонента отчета | Производит |
|---|---|---|
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. Обозреватель отчетов поддерживает форматирование на основе таблиц стилей для обеспечения обратной совместимости с генераторами отчетов, разработанными с помощью проводника отчетов в выпусках, предшествовавших доступности шаблонов. Шаблоны следует использовать исключительно для новых генераторов отчетов, разработанных с помощью проводника отчетов. Это связано с тем, что шаблоны имеют значительные преимущества перед таблицами стилей:
Форматирование: таблицы стилей XSL и DSSL имеют ограниченные возможности форматирования. Например, все заголовки и все основные абзацы отчета должны иметь одинаковый формат. Напротив, шаблоны позволяют использовать все параметры форматирования, доступные в документах Microsoft Word и HTML.
Масштабируемость: в Report Explorer используется преобразователь файлов на основе MATLAB, называемый db2dom, для преобразования отчетов на основе шаблонов. В проводнике отчетов используются преобразователи файлов на основе Java, xslt и JADE, для преобразования отчетов на основе таблиц стилей XSL и DSSL. db2dom конвертер обычно на порядок быстрее, чем xslt и JADE и не использует память Java для вывода Word и HTML и гораздо меньше памяти для вывода PDF. В результате проводник отчетов может создавать гораздо большие отчеты с шаблонами, чем выходные данные на основе таблиц стилей.
Каждый шаблон отчета содержит таблицу стилей. Эта таблица стилей, которую не следует путать с таблицей стилей XSL или DSSSL, является документом, определяющим именованные наборы форматов текста, абзаца, списка и таблицы, называемых стилями. Во время создания отчета конвертер файлов Report Explorer, db2domкопирует таблицу стилей шаблонов в созданный отчет и назначает имена стилей абзацам, тексту, спискам и таблицам, сгенерированным компонентами генератора отчетов. Программа, используемая для отображения или печати отчета, например HTML-браузер или Microsoft Word, использует стили для форматирования отчета.
Шаблоны Report Explorer по умолчанию определяют все стили, необходимые для форматирования отчета, созданного Report Explorer из файла настройки отчета. Чтобы отличить их от других стилей, названия этих стилей начинаются с префикса, rg, например, rgParagraph. Можно изменить внешний вид отчета, настроив определения (но не имена) этих стилей в копии шаблона по умолчанию и используя копию для создания отчета.
Можно также определить собственные стили в настраиваемом шаблоне и назначить их компонентам, в диалоговых окнах которых содержится свойство StyleName. Компоненты, имеющие свойство StyleName, включают компоненты «Текст» и «Абзац». Таким образом можно настроить внешний вид отдельных экземпляров компонента. Например, стиль по умолчанию компонента «Абзац»: rgParagraph. Путем создания и назначения собственного стиля, например, myParagraph, для определенного компонента абзаца можно отличить внешний вид выходных данных этого компонента от внешнего вида абзацев по умолчанию rgParagraph стиль.
Шаблоны Report Explorer по умолчанию содержат библиотеку шаблонов компонентов. Библиотека шаблонов компонентов - это документ, который определяет шаблоны для компонентов Report Explorer, таких как компонент титульной страницы и компонент главы/раздела. Каждый шаблон в библиотеке имеет имя, например: rgRectoTitlePage, что позволяет генератору отчетов находить шаблон компонента в библиотеке. Библиотека компонентов позволяет одному шаблону, называемому основным шаблоном, содержать все шаблоны, необходимые для форматирования отчета, созданного из основного шаблона.
Можно изменить формат компонента отчета, такого как титульная страница, настроив его шаблон в копии шаблона по умолчанию и используя этот настроенный шаблон для создания отчета. Можно также создавать и сохранять шаблоны для компонентов подчиненной формы в основном шаблоне компонента формы. Таким образом можно создавать пользовательские компоненты отчетов с пользовательским содержимым и пользовательскими форматами. Например, можно создать пользовательский шаблон титульной страницы и использовать его с компонентом подчиненной формы для создания титульной страницы, которая содержит содержимое, не определенное компонентом титульной страницы, например блок подписания.
Шаблоны компонентов Report Explorer по умолчанию содержат местозаполнители, называемые отверстиями, которые указывают, куда вставлять сгенерированное содержимое относительно фиксированного содержимого шаблона и другого сгенерированного содержимого. Например, шаблоны компонента «Титульная страница» содержат отверстия для заголовка отчета, субтитра, автора, реферата и т.д. Обозреватель отчетов заменяет эти отверстия созданным содержимым во время создания отчета. Например, оно заменяет отверстие заголовка в шаблоне страницы заголовка заголовком, указанным свойством Title компонента страницы заголовка.
Можно изменить компоновку и содержимое компонента, определяющего содержимое, путем переупорядочивания или удаления его отверстий. Например, можно удалить или скорректировать расположение субтитра страницы заголовка, переместив или удалив отверстие субтитра в шаблоне компонента страницы заголовка. Можно также включить отверстия в шаблоны, созданные для компонентов формы и подчиненной формы, и заполнить эти отверстия с помощью компонентов шаблона отверстия в файле настройки генератора отчетов. Таким образом, например, можно создать титульную страницу, точно соответствующую требованиям к макету и формату титульной страницы.
При первом открытии проводника отчетов в сеансе MATLAB выполняется поиск шаблонов по пути MATLAB. В нем хранятся все шаблоны, найденные в кэше. Он также добавляет в кэш все шаблоны, созданные в сессии. Впоследствии он ищет в кэше любой указанный шаблон, который отсутствует в текущем каталоге. Это позволяет избежать необходимости поиска по пути MATLAB каждый раз, когда проводнику отчетов требуется создать отчет на основе шаблона. При попытке использовать шаблон, который отсутствует в пути MATLAB в начале сеанса MATLAB, обозреватель отчетов указывает, что он не может найти шаблон. В этом случае можно либо изменить рабочий каталог MATLAB на каталог шаблона, либо добавить каталог в путь MATLAB и обновить кэш. Чтобы обновить кэш, выполните команду
>> rptgen.db2dom.TemplateCache.getTheCache(true);
в командной строке MATLAB.