mlreportgen.dom. Шаблонный класс

Пакет: mlreportgen.dom
Суперклассы:

Создайте объект шаблона отчета

Описание

Создайте объект шаблона отчета.

Используйте объекты mlreportgen.dom.Template создать шаблоны. Например, можно добавить содержимое DOM (например, Text, Paragraph, Image) объекты и объекты TemplateHole) к объекту Template создать шаблон, содержащий зафиксированное содержимое с дырами для сгенерированного содержимого.

Примечание

Word для Mac не поддерживает дыры создания для шаблонов API DOM. Если необходимо создать шаблон Word для генерации документов Word о Mac, можно создать шаблон с помощью API DOM. Создайте объект Template и используйте mlreportgen.dom.TemplateHole, чтобы добавить дыры. Также используйте Word на Windows®, чтобы создать ваш шаблон и скопировать шаблон в ваш Mac.

Конструкция

templateObj = Template() создает объект шаблона на основе шаблона HTML по умолчанию. Получившийся шаблон находится в текущей папке и использует имя Untitled.htmtx.

Добавьте содержимое и используйте соответствующую команду close, чтобы сгенерировать файл шаблона.

templateObj = Template(templatePath) создает объект шаблона, который выводит файл шаблона в заданном местоположении. Шаблон по умолчанию вводит, если вы не указываете, что расширение является HTML.

templateObj = Template(templatePath,type) создает шаблон заданного типа. Если вы задаете расширение с помощью templatePath, типы должны соответствовать.

Совет

Используйте переменную для аргумента type, чтобы упростить ваш код. Смотрите Создают Шаблон и Добавляют Содержимое для примера.

templateObj = Template(templatePath,type,sourceTemplatePath) создает шаблон на основе шаблона sourceTemplatePath.

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

развернуть все

Полный путь шаблона вы хотите создать, заданный как вектор символов. Можно использовать расширение, чтобы создать шаблон соответствующего типа:

  • .htmtx для HTML (значение по умолчанию)

  • .docx для Word

  • .htmt для однофайлового HTML

  • .pdf для PDF

Тип шаблона, заданного как одно из этих значений:

  • 'html' — Шаблон HTML как заархивированная или разархивированная папка, содержащая текст документа HTML, изображение, таблицу стилей и файлы JavaScript®

  • Шаблон 'docx' — Word

  • 'html-file' — Шаблон HTML, состоящий из одного файла, который содержит текст, таблицы стилей, JavaScript, и отображает для отчета

  • Шаблон .pdf — PDF

Если вы используете расширение с входным параметром templatePath, аргумент type должен соответствовать.

Обработайте по шаблону, который является основанием для нового шаблона, заданного как вектор символов. Исходный тип шаблона должен совпадать с аргументом type.

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

развернуть все

Обработайте по шаблону, чтобы создать, возвращенный как объект mlreportgen.dom.Template.

Свойства

развернуть все

Этот дочерний элемент списков свойств только для чтения элементы этого объекта.

Это свойство только для чтения является ID дыры текущей дыры в этом документе.

Тип текущей дыры шаблона, заданной как 'Inline' или 'Block'.

  • Встроенная дыра для элементов документа, которые может содержать элемент абзаца: Text, Image, LinkTarget, ExternalLink, InternalLink, CharEntity, AutoNumber.

  • Дыра блока может содержать Paragraph, Table, OrderedList, UnorderedList, DocumentPart или Group.

Это свойство применяется к Word и документам в формате PDF. Для документов Word значение является объектом DOCXPageLayout, который задает текущий макет страницы. Для документов в формате PDF значение является объектом PDFPageLayout, если документ в настоящее время задает макет страницы. Для документов HTML значение всегда [].

Установите это свойство на true перезаписывать существующий выходной файл того же имени. Если этим свойством является false, и перезаписываемый файл того же имени существует, пытаясь закрыться (т.е. запись), этот шаблон вызывает ошибку. Если существующий файл только для чтения, закрытие этого документа вызывает ошибку независимо от установки этого свойства.

Типы данных: логический

Пользовательское содержимое для заголовка HTML, заданного как вектор символов.

Типы данных: char

ID для этого элемента документа, указанного как вектор символов. DOM генерирует уникальный идентификатор сеанса, когда он создает элемент документа. Можно задать собственный ID.

Это списки свойств только для чтения открытое состояние этого элемента документа.

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

Для разархивированной выходной упаковки путь задает папку для выходных файлов. Значением по умолчанию является текущая папка.

Упаковка для выходных файлов, сгенерированных, заданных как одно из этих значений:

  • 'zipped' — Применяется только к Word, PDF и многофайловому выводу HTML.

  • 'unzipped' — Применяется только к Word, PDF и многофайловому выводу HTML.

  • 'both' — Применяется только к Word, PDF и многофайловому выводу HTML.

  • 'single-file' — Создает отчет как один файл. Это значение появляется, если вы устанавливаете свойство Type документа на 'html-file'. Вы не можете установить или изменить это значение сами.

Для заархивированной упаковки документ вывел, zip-файл, расположенный в местоположении, заданном свойством OutputPath. Zip-файл имеет расширение, которое совпадает с типом документа: docx для Word вывод, pdftx для PDF вывод или htmtx для вывода HTML. Например, если типом документа является docx, и OutputPath является s:\docs\MyDoc, вывод группирован в zip-файле под названием s:\docs\MyDoc.docx.

Для разархивированной упаковки документ вывел, хранится в папке, имеющей корневое имя файла свойства OutputPath. Например, если OutputPath является s:\docs\MyDoc, выходной папкой является s:\docs\MyDoc.

Если вы устанавливаете PackageType на both, генерирование отчета производит заархивированный и разархивированный вывод.

Типы данных: char

По умолчанию элементы документа хранятся в памяти, пока документ не закрывается. Установите это свойство на true писать элементы документа в диск, когда элементы добавлены к документу.

Типы данных: логический

Пометьте, который идентифицирует этот документ. Тег имеет форму CLASS:ID, где CLASS является классом документов, и ID является значением свойства Id объекта.

Пример причины определения вашего собственного значения тега должен облегчить идентифицировать, где проблема произошла во время генерации документов.

Полный путь к шаблону HTML или Word, чтобы использовать, заданный как вектор символов.

Для документов HTML это свойство задает текст, который появляется в строке заголовка браузера, используемого, чтобы отобразить этот документ. Word и документы в формате PDF игнорируют это свойство.

Установите это свойство прежде, чем открыть документ для вывода.

Тип вывода, заданного как одно из этих значений:

  • 'html' — Вывод HTML как заархивированная или разархивированная папка, содержащая текст документа HTML, изображение, таблицу стилей и файлы JavaScript

  • 'docx' — Word вывод

  • 'html-file' — Вывод HTML, состоящий из одного файла, который содержит текст, таблицы стилей, JavaScript, и отображает для отчета

  • 'pdf' — PDF вывод

Если вы задаете шаблон с помощью свойства TemplatePath, шаблон должен быть сопоставим со свойством Type.

Методы

Используйте методы Template тем же путем, вы используете соответствующие методы Document.

Метод

Цель

append

Добавьте элемент документа к документу.

close

Закройте этот документ. Вы не можете закрыть документ, если он не был открыт или был ранее закрыт.

createTemplate

Создайте шаблон по умолчанию.

fill

Заполните дыру документа.

getCoreProperties

Получите базовые свойства документа.

getImageDirectory

Получите каталог образов для документа.

getImagePrefix

Получите сгенерированный префикс названия картинки для документа.

getMainPartPath

Получите относительный путь основной части выходного документа.

getOPCMainPart

Получите полный путь основной части выходного документа.

moveToNextHole

Переместитесь, чтобы затем обработать дыру по шаблону.

open

Откройте этот документ. Вы не можете открыть документ, если он был ранее открыт или закрыт.

package

Добавьте файл к пакету OPC документа.

setCoreProperties

Установите базовые свойства элемента документа.

Примеры

свернуть все

Этот пример создает шаблон с дырой для заголовка и дырой для автора. Можно изменить значение переменной type, чтобы создать шаблон одного из других типов.

import mlreportgen.dom.*;

type = 'docx';

% Create a template object
t = Template('mytemplate',type);

% Add a title hole to the template and apply the Title style
hole = append(t,TemplateHole('TITLE'));
hole.Description = ('Title Description');
hole.DefaultHoleStyleName = 'Title';

% Add a paragraph with boilerplate text and apply the Subtitle format
% Position the paragraph and preserve white space in the text 
p = Paragraph('Author: ');
p.StyleName = 'Subtitle';
p.Style = {OuterMargin('0','0','1in','1in')};
p.WhiteSpace = 'preserve';

% Append an inline hole to paragraph  
hole = append(p,TemplateHole('AUTHOR'));
append(t,p);

close(t);

Этот пример использует шаблон, чтобы заполнить дыры.

% Create a document TitleAuthor that uses the template mytemplate.
rpt = Document('TitleAuthor',type,'mytemplate');
open(rpt);

% Create a loop to cycle through the holes. 
% Append content to each hole.
while(~strcmp(rpt.CurrentHoleId,'#end#'))
    switch(rpt.CurrentHoleId)
        case 'TITLE'
            append(rpt,Paragraph('This Is My Title'));
        case 'AUTHOR'
            append(rpt,'My Name');
    end
    
    moveToNextHole(rpt);
end

% Generate and view the report.
close(rpt);
rptview(rpt.OutputPath)

Для просмотра документации необходимо авторизоваться на сайте