exponenta event banner

zipTemplate

Упаковка HTML-файла DOM и шаблона PDF в zip-файл

Описание

пример

zipTemplate(unzippedTemplateFolder) zips (сжимает и помещает в zip-файл) распакованный шаблон DOM в unzippedTemplateFolder. Результирующее имя файла шаблона в архиве - это имя, указанное в unzippedTemplateFolder, плюс расширение файла htmtx или pdftx. zipTemplate помещает все файлы в незарегистрированную папку шаблонов, включая файлы во вложенных папках. Структура папки шаблона в архиве дублирует структуру папки шаблона в архиве. Имена файлов в распакованном шаблоне должны содержать только символы ASCII.

Используйте этот синтаксис, если распакованный шаблон был создан путем распаковки шаблона, созданного одним из следующих способов:

  • Б/У mlreportgen.dom.Document.createTemplate

  • Копирование шаблона из шаблона DOM по умолчанию

  • Шаблон создавался без использования шаблонов DOM API или DOM, а архивированный файл соответствовал условиям, перечисленным в разделе «Советы».

пример

zipTemplate(zippedTemplate,unzippedTemplateFolder) помещает распакованный шаблон DOM в файл, указанный в zippedTemplate.

zipTemplate(zippedTemplate,unzippedTemplateFolder,mainDocument) помещает распакованный шаблон DOM в файл, указанный в zippedTemplate. Используйте mainDocument аргумент для указания имени основного документа в незарегистрированном шаблоне, если имя основного документа в незарегистрированном шаблоне не является report.html или root.html и файл библиотеки шаблонов деталей документа, если он существует, находится в файле с именем docpart_templates.html.

пример

zipTemplate(zippedTemplate,unzippedTemplateFolder,mainDocument,partTemplates) помещает распакованный шаблон DOM в файл, указанный в zippedTemplate. Используйте этот синтаксис, когда распакованный шаблон включает файл библиотеки шаблонов деталей документа, имя файла которого не является docpart_templates.html. Необходимо указать mainDocument в качестве третьего аргумента, даже если основной файл документа вызван report.html или root.html.

Примеры

свернуть все

Запишите шаблон myTemplate в zip-файл с именем myTemplate.htmtx.

zipTemplate('myTemplate');

Запишите шаблон myTemplate в zip-файл с именем myReportTemplate.htmtx.

zipTemplate('myReportTemplate.htmtx','myTemplate');

ZIP-файл шаблона, основной частью которого является mainpart.html и файл библиотеки шаблонов деталей documentpart_templates.html.

zipTemplate('myTemplate.htmtx','myTemplate',...
    'mainpart.html','documentpart_templates.html');

Входные аргументы

свернуть все

Путь к папке, содержащей распакованный шаблон, указанный как символьный вектор. Имена файлов в распакованном шаблоне должны содержать только символы ASCII.

Полный путь к zipped шаблону DOM, включая расширение файла .htmtx или .pdftx, задается как символьный вектор.

Имя файла основного документа, включая расширение файла, указанное как символьный вектор.

Имя файла библиотеки деталей документа, включая расширение файла, указанное как символьный вектор.

Совет

  • Если вы создали распакованный шаблон, распаковав шаблон, созданный с помощью mlreportgen.dom.Document.createTemplate или копирование шаблона из шаблона DOM по умолчанию, можно использовать любой из этих синтаксисов без дальнейших действий:

    zipTemplate(zippedTemplate,unzippedTemplateFolder)

    Можно также использовать любой из этих двух синтаксисов, если распакованный шаблон был создан без использования интерфейса DOM и шаблон соответствует следующим требованиям.

    • Имя основного файла документа: report.html или root.html.

    • Распакованный шаблон либо не включает файл библиотеки шаблонов деталей документа, либо включает файл библиотеки шаблонов деталей документа с именем docpart_templates.html.

    • Распакованный шаблон хранит изображения в папке с именем images.

    Если распакованный файл основного документа шаблона не назван, то report.html или root.html, используйте mainDocument входной аргумент.

    Если распакованный шаблон включает файл библиотеки шаблонов деталей документа с именем, отличным от docpart_templates.html, используйте partTemplates входной аргумент.

    Если распакованный шаблон хранит изображения в папке, отличной от папки с именем images в корневой папке шаблона, включить текстовый файл с именем _imgprefix в папке, содержащей изображения для распакованного шаблона. В _imgprefix можно включить префикс для интерфейса DOM для создания изображений имен, добавляемых в документы. Например, если _imgprefix файл содержит префикс graphic, сгенерированные имена изображений: graphic1.png, graphic2.pngи так далее. Если вы покинете _imgprefix файл пуст, затем созданные изображения используют префикс image.

Представлен в R2014b