slreportgen.report.RptFile class

Пакет: slreportgen.report

Создайте основанный на Report Explorer генератор отчетов

Описание

Используйте RptFile генератор отчетов, чтобы включать содержимое, сгенерированное настройкой Report Explorer (.rpt) файл в отчете API Отчета. Когда добавлено к отчету, RptFile генератор отчетов:

  1. Выполняет заданный файл настройки Report Explorer, чтобы сгенерировать представление XML DocBook отчета Report Explorer

  2. Использует модифицированную версию Report Explorer Docbook-to-DOM шаблон преобразования, чтобы преобразовать XML в набор Объектов DOM (см., Управляют Шаблонами Преобразования Отчета (MATLAB Report Generator)),

  3. Добавляет содержимое DOM к отчету API Отчета.

Примечание

Используйте Цикл Блока, а не компонент Цикла Графика в вашем файле настройки отчета, чтобы сообщить относительно графиков Stateflow®. См. Отчет относительно Диалоговых Снимков состояния Stateflow.

slreportgen.report.RptFile классом является handle класс.

Создание

Описание

пример

reporter = RptFile() создает пустой основанный на Report Explorer RptFile генератор отчетов. Прежде, чем добавить генератор отчетов в отчет, ваша программа отчета должна установить SetupFile генератора отчетов свойство к пути настройки Report Explorer (.rpt) файл. В противном случае ошибка происходит.

По умолчанию, RptFile генератор отчетов использует шаблон преобразования, который является немного модифицированной версией шаблона преобразования Report Explorer по умолчанию для отчета выходной тип. Например, если отчет, выходным типом является PDF, генератор отчетов, использует немного модифицированную версию шаблона по умолчанию для PDF (from template) Report Explorer 'OutputType' .

Можно использовать пользовательский шаблон преобразования, чтобы настроить генератор отчетов выход. Используйте createTemplate генератора отчетов метод, чтобы создать копию одного из выхода генератора отчетов по умолчанию вводит определенные шаблоны преобразования для индивидуальной настройки. Чтобы использовать индивидуально настраиваемый шаблон, установите RptFile TemplateSrc генератора отчетов свойство к пути индивидуально настраиваемого шаблона.

пример

reporter = RptFile(SetupFile) создает RptFile генератор отчетов на основе заданного файла настройки Report Explorer (.rpt файл). Смотрите свойство SetupFile.

reporter = RptFile(Name,Value) свойства наборов с помощью пар "имя-значение". Можно задать несколько аргументов пары "имя-значение" в любом порядке. Заключите каждое имя свойства в одинарные кавычки.

Свойства

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

Путь к файлу настройки Report Explorer в виде символьного массива или строки. Не используйте основанные на форме отчеты в файлах настройки, что вы используете с RptFile генератор отчетов. API Отчета сообщает, к которому добавляется файл настройки, заменяет выходной тип файла настройки.

Атрибуты:

GetAccess
public
SetAccess
public

Типы данных: string | character array

Имя модели в виде символьного массива или строки, модели, для который заданный SetupFile выполняется. Если файл настройки содержит Цикл Модели, RptFile генератор отчетов устанавливает свое значение к значению этого свойства. Ошибка происходит, если файл настройки не содержит Цикл Модели или содержит циклы многоуровневой модели.

Атрибуты:

GetAccess
public
SetAccess
public

Типы данных: character array | string

Системный путь в виде символьного массива, строки или slreportgen.finder.DiagramResult объект. Если файл настройки содержит Системный Цикл, RptFile генератор отчетов устанавливает Системное значение Цикла к значению этого свойства, если это - символ или строка. Если значением является DiagramResult объект, генератор отчетов устанавливает Системный Цикл на значение Path результата свойство. Ошибка происходит, если файл настройки не содержит Системный Цикл или содержит несколько системных циклов.

Атрибуты:

GetAccess
public
SetAccess
public

Типы данных: character array | string | object

Блок path в виде символьного массива или строки, slreportgen.finder.DiagramElementResult объект или slreportgen.finder.BlockResult объект для блока. Если файл настройки содержит Цикл Блока, RptFile генератор отчетов устанавливает значение Цикла Блока к значению этого свойства, если это - символ или строка. Если значением является slreportgen.finder.BlockResult объект, генератор отчетов использует значение BlockPath объекта свойство. Если значением является DiagramElementResult объект, генератор отчетов использует значение DiagramPath объекта и Name свойства определить полный путь. Ошибка происходит, если файл настройки не содержит Цикл Блока или содержит несколько циклов блока.

Примечание

Используйте компонент Цикла Блока в своем файле настройки, чтобы сообщить относительно диаграмм Stateflow. См. Отчет относительно Диалоговых Снимков состояния Stateflow.

Атрибуты:

GetAccess
public
SetAccess
public

Типы данных: character array | string | object

Источник преобразования обрабатывает по шаблону, чтобы использоваться этим генератором отчетов, чтобы преобразовать XML файла настройки выход в Объекты DOM. Пустое значение задает использование шаблона по умолчанию для выходного типа отчета, который будет сгенерирован. Значение строки или символьного массива задает путь настроенной версии шаблона по умолчанию для выходного типа, который будет сгенерирован.

Атрибуты:

GetAccess
public
SetAccess
public

Типы данных: character array | string

Имя шаблона для этого генератора отчетов в виде символьного массива или строки. По умолчанию это свойство задает RptFile, имя шаблона генератора отчетов по умолчанию. Этот шаблон по умолчанию находится в библиотеке шаблонов его шаблона преобразования по умолчанию наряду с другими шаблонами, используемыми, чтобы преобразовать компоненты XML Report Explorer в Объекты DOM. Шаблон генератора отчетов по умолчанию содержит одно отверстие под названием Content быть заполненным содержимым DOM, преобразованным от содержания XML, сгенерированного настройкой. Если вы меняете имя этого шаблона, необходимо установить это свойство на новое имя. Можно изменить сам шаблон, но модифицированный шаблон должен содержать отверстие под названием Содержимое.

Атрибуты:

GetAccess
public
SetAccess
public

Типы данных: character array | string

Цель гиперссылки для этого генератора отчетов в виде строки или символьного массива, который задает ID цели ссылки или mlreportgen.dom.LinkTarget объект. Значение строки или символьного массива преобразовано в LinkTarget объект. Объект цели ссылки сразу предшествует содержимому этого генератора отчетов в выходном отчете.

Атрибуты:

GetAccess
public
SetAccess
public

Типы данных: string | character array | object

Методы

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

Примеры

свернуть все

Создайте RptFile генератор отчетов, не задавая файл настройки. Затем используйте SetupFile свойство задать файл настройки Report Explorer.

reporter = slreportgen.report.RptFile();
reporter.SetupFile = "my_setup_file.rpt" 
 

Используйте RptFile генератор отчетов, чтобы сообщить относительно блока Documentation в sldemo_fuelsys Модель Simulink®.

RptFile генератор отчетов использует файл настройки Report Explorer, чтобы получить информацию о блоке Documentation.

Примечание

Прежде чем вы запустите этот пример, используйте Report Explorer, чтобы создать файл настройки под названием my_setup_file.rpt. Файл настройки для этого примера содержит иерархию Цикла Модели, Системного Цикла, Цикла Блока, Абзаца и компонентов Документации как показано. Выберите компоненты из средней панели.

  • Цикл модели, Системный Цикл и компоненты Цикла Блока находятся в папке Simulink.

  • Компонент абзаца находится в папке Formatting.

  • Компонент блока Documentation находится в папке Simulink Blocks.

Для получения дополнительной информации о подготовке файла настройки для этого примера смотрите, Создают Файл настройки Отчета (MATLAB Report Generator).

Используйте этот скрипт, чтобы сгенерировать отчет, который включает информацию о свойствах блока Sensor Info Documentation в ToController система sldemo_fuelsys модель.

model = "sldemo_fuelsys";
load_system(model)

rpt = slreportgen.report.Report("MyReport","pdf");
chap = mlreportgen.report.Chapter("Report on a DocBlock");
 
rptFile = slreportgen.report.RptFile("my_setup_file.rpt");
rptFile.Model = model;
rptFile.System = "sldemo_fuelsys/To Controller";
rptFile.Block = "sldemo_fuelsys/To Controller/Sensor Info";

add(chap,rptFile);
add(rpt,chap);
 
close(rpt);
rptview(rpt);

Использовать slreportgen.report.RptFile чтобы сообщить относительно диалоговых снимков состояния Stateflow, используйте Цикл Блока в файле настройки Report Explorer.

Используйте Report Explorer, чтобы создать файл настройки под названием my_setup_file.rpt. Файл настройки для этого примера содержит иерархию, состоящую из Цикла Модели, Системного Цикла, Цикла Блока и Диалогового компонента Снимка состояния Stateflow. Выберите компоненты из средней панели.

  • Цикл Модели, Системный Цикл и компоненты Цикла Блока находятся в папке Simulink.

  • Диалоговый компонент Снимка состояния Stateflow находится в папке Stateflow.

Для получения дополнительной информации о подготовке файла настройки смотрите, Создают Файл настройки Отчета (MATLAB Report Generator).

Создайте отчет Simulink.

rpt = slreportgen.report.Report("MyReport","pdf");
open(rpt);

Загрузите модель.

model = "sf_car";
load_system(model);

Создайте главу.

chap = mlreportgen.report.Chapter();
chap.Title = strcat(model,": Stateflow Dialog Snapshots");

Найдите все системы в модели.

sys_finder = slreportgen.finder.SystemDiagramFinder(model);
systems = find(sys_finder);

Найдите все блоки в существующей системе. Используйте файл настройки отчета, чтобы сообщить относительно диалоговых снимков состояния Stateflow.

for system = systems
    blk_finder = slreportgen.finder.BlockFinder(system);
    blocks = find(blk_finder);
    
    for block = blocks
        if slreportgen.utils.isValidSlSystem(block.Object) && ...
                ~isempty(slreportgen.utils.block2chart(block.Object))
            rptFile = slreportgen.report.RptFile("my_setup_file.rpt");
            rptFile.Model = model;
            rptFile.System = system;
            rptFile.Block = block;
            add(chap,rptFile);
        end
    end
end

Добавьте главу в отчет.

add(rpt,chap);

Закройте и просмотрите отчет.

close(rpt);
rptview(rpt);

Введенный в R2019a