Report Explorer позволяет вам использовать шаблоны, чтобы отформатировать ваши отчеты. Шаблон является HTML или документом Word, который задает фиксированное содержимое, формат и размещение вашего отчета. Можно использовать Microsoft® шаблоны Word, чтобы отформатировать Word и отчеты PDF и шаблоны HTML, чтобы отформатировать отчеты PDF и HTML. 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 расширениями. Report Explorer использует Процессор Formatting Objects (FOP) Apache, чтобы преобразовать представление 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 ограничили параметры форматирования. Например, все заголовки и все абзацы тела в вашем отчете должны иметь тот же формат. В отличие от этого, шаблоны позволяют вам использовать все параметры форматирования, доступные в документах HTML и Microsoft Word.
Масштабируемость: Report Explorer использует основанный на MATLAB конвертер файла, названный db2dom, преобразовывать отчеты на основе шаблонов. Report Explorer использует основанные на Java конвертеры файла, xslt и JADE, преобразовывать отчеты на основе XSL и таблицы стилей DSSSL. 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, включают компоненты Paragraph и Text. Таким образом можно настроить внешний вид отдельных экземпляров компонента. Например, стилем по умолчанию компонента 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.
