zipTemplate

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

Описание

пример

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

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

  • Используемые mlreportgen.dom.Document.createTemplate

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

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

пример

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.

Примеры

свернуть все

ZIP шаблон myTemplate в zip- файла, называемый myTemplate.htmtx.

zipTemplate('myTemplate');

ZIP шаблон myTemplate в zip- файла, называемый myReportTemplate.htmtx.

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

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

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

Входные параметры

свернуть все

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

Полный путь к заархивированному шаблону 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