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