Создание отчетов по блокам DocBlock

В этом примере показано, как включить содержимое блоков Simulink DocBlock в отчет Microsoft ® Word, сгенерированный Report API. Модель примера, slreportgen_demo_docblock, содержит только блоки DocBlock с одним блоком для каждого типа документа DocBlock:

  • RTF

  • HTML

  • Текст

В сгенерированном отчете содержимое блоков DocBlock выглядит следующим образом:

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

import mlreportgen.report.*
import slreportgen.report.*
import slreportgen.finder.*
import mlreportgen.dom.*

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

model = 'slreportgen_demo_docblock';
load_system(model);

Создайте контейнер для хранения содержимого отчета. Чтобы избежать ошибки компиляции из-за модели, содержащей только виртуальные блоки, установите CompileModelBeforeReporting свойство объекта отчета, чтобы false.

rpt = slreportgen.report.Report('ModelDoc', 'docx');
rpt.CompileModelBeforeReporting = false;

Добавьте заголовка страницу и таблицу содержимого.

add(rpt,TitlePage('Title',sprintf('%s Model Documentation',model)));
add(rpt,TableOfContents);

Найдите и закольцуйте все системы в модели.

finder = SystemDiagramFinder(model);
for system = find(finder)

Составьте главу для каждой системы. Включите имя системы в заголовок главы. Эта глава используется для создания отчетов о содержимом DocBlock в системе.

    ch = Chapter('Title',sprintf('System %s', system.Name));

Найдите все блоки DocBlock в текущей системе. Каждый результат возвращает репортера DocBlock для найденного DocBlock. The add метод вызывает репортер DocBlock.

    docBlockFinder = BlockFinder(system);
    docBlockFinder.Properties = {'MaskType', 'DocBlock'}';
    results = find(docBlockFinder);
    if ~isempty(results)
        add(ch, results);
        else
        add(ch, "This system does not have documentation.");
    end
    add(rpt,ch)
end 

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

close(rpt);
close_system(model);
rptview(rpt);

См. также

| | | |

Похожие темы

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