В этом примере показано, как включить содержимое блоков 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);
DocBlock | slreportgen.finder.BlockFinder
| slreportgen.finder.BlockResult
| slreportgen.finder.SystemDiagramFinder
| slreportgen.report.DocBlock