API DOM идет с шаблонами по умолчанию для каждого выходного типа для форматирования вашего отчета, как это генерирует. Шаблоны полезны для обеспечения форматов оформления по умолчанию так, чтобы вы не должны были задавать их в своем отчете. Этот подход полезен, если несколько отчетов имеют тот же взгляд, который типичен в большинстве организаций. В вашей программе отчета вы обращаетесь по наименованию к шаблону и его стилям и размещениям. Когда ваш отчет генерирует, шаблон определяет внешний вид объектов документа.
Шаблоны также включают основанную на форме генерацию документов. Можно задать зафиксированное содержимое и отверстия (пробелы) в шаблоне. Ваша программа отчета может заполнить отверстия содержимым, такие как текст или изображения. Смотрите Основанное на форме Создание отчетов.
Другое преимущество использования шаблонов для обслуживания. Если ваши конструктивные изменения отчета, вы изменяете только шаблон и не все программы то использование тот проект.
Используя шаблоны также сохраняет вашу программу отчета меньшей, потому что вы не должны задавать свойства для каждого объекта, который вы создаете. Для отчетов, которые являются сотнями страниц, с помощью шаблонов, может также улучшать производительность.
Можно создать копию шаблонов по умолчанию и настроить их, чтобы задать форматирование по умолчанию и размещение отчетов. Для шаблона, чтобы вступить в силу, ваша программа отчета должна относиться к вашему шаблону и задать имена стиля и части документа, чтобы использовать.
Можно создать копию шаблонов по умолчанию с помощью mlreportgen.dom.Document.createTemplate
метод. Шаблоны по умолчанию могут служить начальной точкой для вашего шаблона.
Все шаблоны DOM, за исключением однофайловых шаблонов HTML, состоят из документа, таблицы стилей и файлов изображений, заархивированных в пакеты на основе Открытого упаковочного соглашения (OPC). Однофайловый шаблон HTML встраивает таблицы стилей и изображения как элементы HTML в документе HTML. Можно использовать Microsoft® Word, чтобы отредактировать шаблоны Word (идентифицированный .dotx
расширение) непосредственно. Можно также отредактировать однофайловые шаблоны HTML непосредственно с помощью любого текстового редактора или редактора HTML.
Отредактировать многофайловые шаблоны HTML (идентифицированный .htmtx
расширение) и шаблоны PDF (идентифицированный .pdftx
расширение), необходимо сначала разархивировать их. Можно опционально повторно архивировать отредактированный шаблон HTML или PDF перед использованием его, чтобы сгенерировать отчет. API DOM обеспечивает функции для архивирования и разархивации многофайлового HTML и шаблонов PDF: zipTemplate
и unzipTemplate
.
Можно использовать стили, заданные в шаблонах к форматированию абзацев, тексту, таблицам, спискам, и так далее. Можно изменить стили или создать собственное. См. таблицу стилей Использования Стили.
Шаблоны Word включают стандартные стили Word, такой как Нормальные, Направляясь 1, и Заголовок. Вы создаете и изменяете стили с помощью стандартных методов Word. Смотрите Изменяют Стили в Шаблоне Microsoft Word.
HTML и шаблоны PDF задают стили с помощью свойств CSS в файлах шаблона тот конец с .css
. Для получения дополнительной информации смотрите, Изменяют Стили в Шаблонах HTML и Изменяют Стили в Шаблонах PDF
Можно использовать шаблоны, чтобы задать макет страницы Word и отчетов PDF, включая размер, ориентация (портрет или среда), поля, и верхние колонтитулы страницы и нижние колонтитулы. Можно использовать шаблон, чтобы задать различные макеты страницы для различных разделов документа. Смотрите Создают Разделы Макета страницы.
Можно также задать макеты страницы программно или использовать комбинацию размещений, которые заданы программно и в шаблоне.
Шаблон части документа является шаблоном для повторяемой структуры в вашем отчете. Можно вставить экземпляр части документа в отчете из программы отчета с помощью DocumentPart
объект. Вы создаете шаблоны части документа в библиотеке шаблонов части документа.
Для шаблонов Word вы задаете шаблоны части документа и храните их в Word Quick Parts Gallery, который служит библиотекой. Шаблон по умолчанию не включает шаблонов части документа. Чтобы создать их, смотрите, Создают Библиотеку шаблонов Части Документа Microsoft Word.
Для HTML и PDF, шаблон по умолчанию содержит файл с именем библиотеки шаблонов части документа docpart_templates.html
. Этот файл создает библиотеку и содержит некоторые шаблоны части документа по умолчанию. Можно изменить или удалить предоставленные шаблоны части документа и добавить собственное. Смотрите Создают Библиотеку шаблонов Части Документа HTML и Создают Библиотеку шаблонов Части Документа в формате PDF.
mlreportgen.dom.Document.createTemplate
| unzipTemplate
| zipTemplate