slreportgen.report.Report class

Package: slreportgen.report
Superclasses:

Report container

Description

slreportgen.report.Report is a container for a report based on Simulink^® reporters and DOM objects. Use this object to generate an HTML, PDF, or Word report based on templates in a template library.

Note

Use objects of this type, instead of mlreportgen.report.Report, to create Simulink reports, which are reports that use Simulink reporters to generate content. You can also use MATLAB^® reporters and DOM objects to generate Simulink report content.

Construction

report = slreportgen.report.Report() returns a report object report with the default report type (PDF) and a default file name (untitled.pdf).

report = slreportgen.report.Report(path) uses the specified output path for the report.

report = slreportgen.report.Report(path,type) creates the specified type of report.

report = slreportgen.report.Report(path,type,template) uses the specified template.

report = slreportgen.report.Report(Name,Value) sets properties using name-value pairs. You can specify multiple name-value pair arguments in any order. Enclose each property name in single quotes.

Input Arguments

path — Report output path

untitled.pdf (default) | string | character array

See the OutputPath property.

type — Report output type

'pdf' (default) | 'html' | 'html-file' | 'docx'

See the Type property.

template — Report template

string | character array

See the TemplatePath property.

Properties

OutputPath — Report document output path

string | character array

Report document output path, specified as a string or character array. The path is the location in the file system where the report output document is stored. The path can be a full path or a path relative to the current MATLAB folder, for example, 'C:/myreports/reportA.docx' or 'reportA'. If the file name does not have a file extension corresponding to the Type property, the appropriate file extension is added.

Note

Generating a PDF report on a cloud drive, such as MATLAB Drive™, can result in an error that is caused by file contention between the report generation software and the cloud drive synchronization software. To avoid this error, generate reports on a local drive that does not synchronize with the cloud. Consider writing a script that generates a report on a local drive and then copies the report to the cloud drive.

Type — Output type

string | character vector | 'docx' | 'pdf'

Output type, specified as one of these values.

• 'HTML' — HTML report packaged as a zipped file containing the HTML file, images, style sheet, and JavaScript^® files of the report.

• 'HTML-FILE' — HTML report as a single HTML file containing the text, style sheet, JavaScript, and base64-encoded images of the report

• 'PDF' — PDF file

• 'DOCX' — Microsoft^® Word document

If you specify a template using the TemplatePath property, the value for Type must match the template type.

Layout — Page layout options

mlreportgen.report.ReportLayout object

Page layout options for this report, specified as a report layout object. See mlreportgen.report.ReportLayout.

Locale — Locale or language

[] (default) | string | character array

Locale or language, specified as the ISO 639-1 two-letter language code of the locale for which this report is to be generated. The default [] specifies the language of the system locale, for example, English on an English system. The Report API uses the language code to translate chapter title prefixes to the language of the specified locale. Translations are provided for the following locales: af, ca, cs, da, de, el, en, es, et, eu, fi, fr, hu, id, it, ja, ko, nl, nn, no, pl, pt, ro, ru, sk, sl, sr, sv, tr, uk, xh, and zh. If you specify an unsupported locale, the English version is used. See ISO 639-1 codes.

TemplatePath — Location of template

string | character array

Location of template used to format the report, specified as a string or character array. Use this property to specify a custom template for this report.

Document — Underlying DOM document object

DOM document object

This read-only property is an mlreportgen.dom.Document that is used to generate the content of the report.

Context — Container for keys and values

map object

This read-only property is a containers.Map object that contains information for generating the report, such as the hierarchical level of the current report section.

Debug — Debug mode

false (default) | true

Debug mode, specified as a logical. If you set Debug to true, the temporary files for the report are stored in a subfolder of the report folder. In debug mode, these files are not deleted when the report is closed.

CompileModelBeforeReporting — Compile Simulink model

true (default) | false

Whether to compile the Simulink model before reporting, specified as a logical. If this property is true and the model is not already compiled, it compiles when you add a reporter that reports on that model to this report. If the model cannot be compiled, report generation terminates. If this property is false, report generation proceeds without compiling the model.

Methods

This class uses the same methods as the MATLAB version. Instead of using mlreportgen in the class name, use slreportgen. See mlreportgen.report.Report for a list of methods.

Copy Semantics

Handle. To learn how handle classes affect copy operations, see Copying Objects.

Compatibility Considerations

add method is not recommended

Starting in R2020b, use the append method instead of the add method to add content to objects of these Report API classes:

• slreportgen.report.Report

• mlreportgen.report.Chapter

• mlreportgen.report.Section

To add content to a DOM API object, such as an mlreportgen.dom.Paragraph object, continue to use the append method of the DOM object. The advantage of using append to add content to Report API objects is that you use the same method name as you use to add content to DOM API objects.

There are no plans to remove the add methods of the Report, Chapter, or Section classes. Report API programs that use the add methods will continue to run.

To update existing code, replace the method name add with append as shown by the examples in the table.

Not Recommended	Recommended
import mlreportgen.report.* import mlreportgen.dom.* rpt = slreportgen.report.Report("myrpt","pdf"); ch = Chapter("My Chapter"); sect = Section("My Section"); para = Paragraph("My Content "); append(para,"more Content"); add(sect,para); add(ch,sect); add(rpt,ch); close(rpt); rptview(rpt);	import mlreportgen.report.* import mlreportgen.dom.* rpt = slreportgen.report.Report("myrpt","pdf"); ch = Chapter("My Chapter"); sect = Section("My Section"); para = Paragraph("My Content "); append(para,"more Content"); append(sect,para); append(ch,sect); append(rpt,ch); close(rpt); rptview(rpt);