DOM API поставляется с шаблонами по умолчанию для каждого типа вывода для форматирования отчета при его создании. Шаблоны полезны для предоставления форматов конструкции по умолчанию, поэтому их не нужно указывать в отчете. Этот подход полезен, если несколько отчетов имеют одинаковый вид, что характерно для большинства организаций. В программе отчетов используется ссылка по имени на шаблон и его стили и макеты. При создании отчета внешний вид объектов документа определяется шаблоном.
Шаблоны также позволяют создавать документы на основе форм. В шаблоне можно определить фиксированное содержимое и отверстия (заготовки). Программа отчетов может заполнять отверстия содержимым, например текстом или изображениями. См. раздел Отчеты на основе форм.
Еще одно преимущество использования шаблонов заключается в обслуживании. При изменении конструкции отчета изменяется только шаблон, но не все программы, использующие эту конструкцию.
Использование шаблонов также уменьшает размер программы отчетов, поскольку нет необходимости задавать свойства для каждого создаваемого объекта. Для отчетов, содержащих сотни страниц, использование шаблонов также может повысить производительность.
Можно создать копию шаблонов по умолчанию и настроить их для задания форматирования и формата отчетов по умолчанию. Чтобы шаблон вступил в силу, программа отчетов должна обратиться к шаблону и указать имена стилей и детали документа для использования.
Можно создать копию шаблонов по умолчанию с помощью mlreportgen.dom.Document.createTemplate способ. Шаблоны по умолчанию могут служить отправной точкой для шаблона.
Все шаблоны DOM, за исключением однофайловых HTML-шаблонов, состоят из документов, таблиц стилей и файлов изображений, упакованных в пакеты на основе Соглашения об открытой упаковке (OPC). Однофайловой HTML-шаблон встраивает таблицы стилей и изображения в качестве HTML-элементов в HTML-документ. Можно использовать Microsoft ® Word для редактирования шаблонов Word (определяемых .dotx внутренний номер) непосредственно. Можно также редактировать однофайловые HTML-шаблоны непосредственно с помощью любого текстового или HTML-редактора.
Редактирование многофайловых HTML-шаблонов (идентифицируемых .htmtx расширение) и шаблоны PDF (идентифицируются .pdftx ), необходимо сначала распаковать их. Отредактированный шаблон HTML или PDF можно повторно создать перед его использованием для создания отчета. DOM API предоставляет функции для архивации и распаковки многофайловых шаблонов HTML и PDF: zipTemplate и unzipTemplate.
Стили, определенные в шаблонах, можно использовать для форматирования абзацев, текста, таблиц, списков и т.д. Можно изменять стили или создавать собственные. См. раздел Использование стилей таблиц стилей.
Шаблоны слов включают стандартные стили Word, такие как «Обычный», «Заголовок 1» и «Заголовок». Стили создаются и изменяются с использованием стандартных методов 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