sltest.testmanager.TestResultReport class

Package:sltest.testmanager

Customize generated results report

expand all in page

Description

sltest.testmanager.TestResultReportis a class that enables you to customize report generation of result from the Test Manager. You can derive the class and override various methods to customize your report. By customizing the methods, you can change the report title, plots, tables, headers, icons, and more.

For more information and examples on customizing reports, seeCustomize Test Results Reports.

Thesltest.testmanager.TestResultReportclass is ahandleclass.

Class Attributes

HandleCompatible true

For information on class attributes, seeClass Attributes.

Creation

Obj= sltest.testmanager.TestResultReport(resultObjects,reportFilePath)creates a report generation object.

要使用这个类,必须继承自该类. Use the following code as the first lines in your class definition code to inherit from the class.

% class definitionclassdefCustomReport < sltest.testmanager.TestResultReport%% Report customization code here%end

Input Arguments

expand all

`resultObjects`—Results set object
object

Results set object to get results from, specified as ansltest.testmanager.ResultSetobject.

`reportFilePath`—File name and path of the generated report
character vector

File name and path of the generated report. File path must have file extension of pdf, docx, or zip, which are the only supported file types.

Example:'C:\MATLAB\Report.pdf'

Properties

expand all

`AuthorName`—Author name
empty character vector(default)

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`BodyFontColor`—Body paragraph font color
`'Black'`(default) |character vector

Body paragraph text font color, specified as a character vector.

Example:'Red'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`BodyFontName`—Body paragraph font style name
`'Arial'`(default) |character vector

Body paragraph text font-style name, specified as a character vector.

Example:'Times New Roman'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`BodyFontSize`—Body paragraph font size
`'12pt'`(default) |character vector

Body paragraph text font size, specified in points as a character vector.

Example:'14pt'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`ChapterIndent`—First level indentation width
`'3mm'`(default) |character vector

First level section indentation width, specified in millimeters as a character vector.

Example:'5mm'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`ChapterIndentL2`—Second level indentation width
`'6mm'`(default) |character vector

Second level section indentation width, specified in millimeters as a character vector.

Example:'8mm'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`ChapterIndentL3`—Third level indentation width
`'8mm'`(default) |character vector

Third level section indentation width, specified in millimeters as a character vector.

Example:'10mm'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`CustomTemplateFile`—Template file name and path
empty character vector(default)

The file name and path to aMicrosoft^®Wordtemplate file for report customization, specified as a character vector. For more information about using template files, seeGenerate Reports Using Templates. The use of this argument is valid only available if you have aMATLAB^®Report Generator™license.

Example:'C:\MATLAB\CustomReportTemplate.dotx'

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`HeadingFontColor`—Section heading font color
`'Black'`(default) |character vector

Section heading text font color, specified as a character vector.

Example:'Blue'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`HeadingFontName`—Section heading font style name
`'Arial'`(default) |character vector

Section heading text font-style name, specified as a character vector.

Example:'Times New Roman'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`HeadingFontSize`—Section heading font size
`'14pt'`(default) |character vector

Section heading text font color, specified in points as a character vector.

Example:'16pt'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileOutcomeDisabled`—Disabled test result icon
empty character vector(default)

File name and path of an icon image for a disabled test result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\disabled_test_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileOutcomeFailed`—Failed test result icon
empty character vector(default)

File name and path of an icon image for a failed test result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\failed_test_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileOutcomeIncomplete`—Incomplete test result icon
empty character vector(default)

File name and path of an icon image for an incomplete test result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\incomplete_test_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileOutcomeMisaligned`—Misaligned test result icon
empty character vector(default)

File name and path of an icon image for a misaligned test result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:MATLAB的C: \ \ misaligned_test_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileOutcomePassed`—Passed test result icon
empty character vector(default)

File name and path of an icon image for a passed test result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\passed_test_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileTestCaseResult`—Test case result icon
empty character vector(default)

File name and path of an icon image for a test case result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\test_case_result_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileTestFileResult`—Test file result icon
empty character vector(default)

File name and path of an icon image for a test file result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\test_file_result_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileTestIterationResult`—Iteration result icon
empty character vector(default)

File name and path of an icon image for an iteration result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\iteration_result_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconFileTestSuiteResult`—Test suite result icon
empty character vector(default)

File name and path of an icon image for a test suite result, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\test_suite_result_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconModelReference`—模型参考图标
empty character vector(default)

File name and path of an icon image for a model reference in the coverage report, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\model_reference_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IconTopLevelModel`—Top-level model icon
empty character vector(default)

File name and path of an icon image for a top-level model in the coverage report, specified as a character vector. The icon file specified replaces the default icon image. The icon image is reduced to 16x16 pixels.

Example:'C:\MATLAB\top_level_model_icon.png'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IncludeComparisonSignalPlots`—Include comparison signal plots
`false`(default) |`true`

Include the signal comparison plots in the report, specified astrueorfalse.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IncludeCoverageResult`—Include coverage results
`false`(default) |`true`

Include the coverage results in the report, specified astrueorfalse.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IncludeErrorMessages`—Include error messages
`true`(default) |`false`

包括报告错误信息,指定为trueorfalse.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IncludeMWVersion`—Include MATLAB version
`true`(default) |`false`

Include the version of MATLAB used to run the tests in the report, specified astrueorfalse.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IncludeSimulationMetaData`—Include simulation metadata
`false`(default) |`true`

Include simulation metadata in the report, specified astrueorfalse. The metadata includes: Simulink^®version, model version, model author, date, model user ID, model path, machine name, solver name, solver type, fixed step size, simulation start time, simulation stop time, and platform.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IncludeSimulationSignalPlots`—Include simulation signal plots
`false`(default) |`true`

Include the simulation signal output plots in the report, specified astrueorfalse.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IncludeTestRequirement`—Include test requirement
`true`(default) |`false`

Include the test requirements linked to the test file, test suite, or test case in the report, specified astrueorfalse.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`IncludeTestResults`—Include all or subset of test results
`2`(default) |`0`|`1`

Include all or a subset of test results in the report. You can select all passed and failed results, specified as the value0, select only passed results, specified as the value1, or select only failed results, specified as the value2.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`LaunchReport`—Open report at completion
`true`(default) |`false`

Open the report when it is finished generating, specified as a boolean value,trueor to not open the report,false.

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`ReportTitle`—Report title
empty character vector(default)

Title of the report, specified as a character vector

Example:'Test Case Report'

Attributes:

`SetAccess`	`public`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`SectionSpacing`—Spacing between sections
`'2mm'`(default) |character vector

Spacing between sections, specified in millimeters as a character vector.

Example:'5mm'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`SignalPlotHeight`—Plot height
`'600px'`(default) |character vector

Plot height, specified in pixels as a character vector.

Example:'500px'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`SignalPlotWidth`—Plot width
`'500px'`(default) |character vector

Plot width, specified in pixels as a character vector.

Example:'400px'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TableFontColor`—Table font color
`'Black'`(default) |character vector

Table font color, specified as a character vector.

Example:'Blue'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TableFontName`—Table font style name
`'Arial'`(default) |character vector

Table font-style name, specified as a character vector.

Example:'Times New Roman'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TableFontSize`—Table font size
`'7.5pt'`(default) |character vector

Table font size, specified in points as a character vector.

Example:'10pt'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TitleFontColor`—Title font color
`'Black'`(default) |character vector

Title font color, specified as a character vector.

Example:'Blue'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TitleFontName`—Title font style name
`'Arial'`(default) |character vector

Title font-style name, specified as a character vector.

Example:'Times New Roman'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

`TitleFontSize`—Title font size
`'16pt'`(default) |character vector

Title font size, specified in points as a character vector.

Example:'20pt'

Attributes:

`SetAccess`	`protected`
`GetAccess`	`public`
`Dependent`	`true`
`NonCopyable`	`true`

Methods

expand all

Public Methods

`genTableRowsForResultMetaInfo`	Generate test result metadata table
`addReportBody`	Add main report body
`addReportTOC`	Add report table of contents
`addTitlePage`	Add report title page
`genBaselineInfoTable`	Generate baseline dataset information table
`genCoverageTable`	Generate coverage collection table
`genHyperLinkToToC`	Generate link to table of contents
`genIterationSettingTable`	Generate iteration settings table
`genMetadataBlockForTestResult`	Generate result metadata section
`genParameterOverridesTable`	Generate test case parameter overrides table
`genRequirementLinksTable`	Generate requirement links table
`genResultSetBlock`	Generate results set section
`genRunBlockForTestCaseResult`	Generate test case configuration and results section
`genSignalSummaryTable`	Generate signal output and comparison data
`genSimulationConfigurationTable`	Generate test case simulation configuration table
`genTableRowsForResultMetaInfo`	Generate test result metadata table
`genTestCaseResultBlock`	Generate test case result section
`genTestSuiteResultBlock`	Generate test suite result section
`layoutReport`	Incorporates parts of report into one document
`plotOneSignalToFile`	Save signal plot to file

Examples

collapse all

Inherit Class and Customize a Report

% class definitionclassdefCustomReport < sltest.testmanager.TestResultReport% This custom class used by Test Manager% adds a custom message in the title page% Class constructormethodsfunctionthis = CustomReport(resultObjects, reportFilePath) this@sltest.testmanager.TestResultReport...(resultObjects,reportFilePath);endendmethods(Access=protected)functionaddTitlePage(obj) importmlreportgen.dom.*;% Call the superclass method to get the default behavioraddTitlePage@sltest.testmanager.TestResultReport(obj);% Add a custom messagelabel = Text('Some custom content can be added here'); append(obj.TitlePart,label);endendend

Use Custom Report Class to Generate Report

% import existing results or use sltest.testmanager.run to run tests% and collect resultsresult = sltest.testmanager.importResults('testResults.mldatx'); filePath ='testreport.zip'; sltest.testmanager.report(result,filePath,...'Author','User',...'Title','Test',...'IncludeMLVersion',true,...'IncludeTestResults',int32(0),...'CustomReportClass','CustomReport',...'LaunchReport',true);

Version History

Introduced in R2016a

sltest.testmanager.TestResultReport class

Description

Class Attributes

Creation

Input Arguments

resultObjects—Results set objectobject

reportFilePath—File name and path of the generated reportcharacter vector

Properties

AuthorName—Author nameempty character vector(default)

Attributes:

BodyFontColor—Body paragraph font color'Black'(default) |character vector

Attributes:

BodyFontName—Body paragraph font style name'Arial'(default) |character vector

Attributes:

BodyFontSize—Body paragraph font size'12pt'(default) |character vector

Attributes:

ChapterIndent—First level indentation width'3mm'(default) |character vector

Attributes:

ChapterIndentL2—Second level indentation width'6mm'(default) |character vector

Attributes:

ChapterIndentL3—Third level indentation width'8mm'(default) |character vector

Attributes:

CustomTemplateFile—Template file name and pathempty character vector(default)

Attributes:

HeadingFontColor—Section heading font color'Black'(default) |character vector

Attributes:

HeadingFontName—Section heading font style name'Arial'(default) |character vector

Attributes:

HeadingFontSize—Section heading font size'14pt'(default) |character vector

Attributes:

IconFileOutcomeDisabled—Disabled test result iconempty character vector(default)

Attributes:

IconFileOutcomeFailed—Failed test result iconempty character vector(default)

Attributes:

IconFileOutcomeIncomplete—Incomplete test result iconempty character vector(default)

Attributes:

IconFileOutcomeMisaligned—Misaligned test result iconempty character vector(default)

Attributes:

IconFileOutcomePassed—Passed test result iconempty character vector(default)

Attributes:

IconFileTestCaseResult—Test case result iconempty character vector(default)

Attributes:

IconFileTestFileResult—Test file result iconempty character vector(default)

Attributes:

IconFileTestIterationResult—Iteration result iconempty character vector(default)

Attributes:

IconFileTestSuiteResult—Test suite result iconempty character vector(default)

Attributes:

IconModelReference—模型参考图标empty character vector(default)

Attributes:

IconTopLevelModel—Top-level model iconempty character vector(default)

Attributes:

IncludeComparisonSignalPlots—Include comparison signal plotsfalse(default) |true

Attributes:

IncludeCoverageResult—Include coverage resultsfalse(default) |true

Attributes:

IncludeErrorMessages—Include error messagestrue(default) |false

Attributes:

IncludeMWVersion—Include MATLAB versiontrue(default) |false

Attributes:

IncludeSimulationMetaData—Include simulation metadatafalse(default) |true

Attributes:

IncludeSimulationSignalPlots—Include simulation signal plotsfalse(default) |true

Attributes:

IncludeTestRequirement—Include test requirementtrue(default) |false

Attributes:

IncludeTestResults—Include all or subset of test results2(default) |0|1

Attributes:

LaunchReport—Open report at completiontrue(default) |false

Attributes:

ReportTitle—Report titleempty character vector(default)

Attributes:

SectionSpacing—Spacing between sections'2mm'(default) |character vector

Attributes:

SignalPlotHeight—Plot height'600px'(default) |character vector

Attributes:

SignalPlotWidth—Plot width'500px'(default) |character vector

Attributes:

TableFontColor—Table font color'Black'(default) |character vector

Attributes:

`resultObjects`—Results set object
object

`reportFilePath`—File name and path of the generated report
character vector

`AuthorName`—Author name
empty character vector(default)

`BodyFontColor`—Body paragraph font color
`'Black'`(default) |character vector

`BodyFontName`—Body paragraph font style name
`'Arial'`(default) |character vector

`BodyFontSize`—Body paragraph font size
`'12pt'`(default) |character vector

`ChapterIndent`—First level indentation width
`'3mm'`(default) |character vector

`ChapterIndentL2`—Second level indentation width
`'6mm'`(default) |character vector

`ChapterIndentL3`—Third level indentation width
`'8mm'`(default) |character vector

`CustomTemplateFile`—Template file name and path
empty character vector(default)

`HeadingFontColor`—Section heading font color
`'Black'`(default) |character vector

`HeadingFontName`—Section heading font style name
`'Arial'`(default) |character vector

`HeadingFontSize`—Section heading font size
`'14pt'`(default) |character vector

`IconFileOutcomeDisabled`—Disabled test result icon
empty character vector(default)

`IconFileOutcomeFailed`—Failed test result icon
empty character vector(default)

`IconFileOutcomeIncomplete`—Incomplete test result icon
empty character vector(default)

`IconFileOutcomeMisaligned`—Misaligned test result icon
empty character vector(default)

`IconFileOutcomePassed`—Passed test result icon
empty character vector(default)

`IconFileTestCaseResult`—Test case result icon
empty character vector(default)

`IconFileTestFileResult`—Test file result icon
empty character vector(default)

`IconFileTestIterationResult`—Iteration result icon
empty character vector(default)

`IconFileTestSuiteResult`—Test suite result icon
empty character vector(default)

`IconModelReference`—模型参考图标
empty character vector(default)

`IconTopLevelModel`—Top-level model icon
empty character vector(default)

`IncludeComparisonSignalPlots`—Include comparison signal plots
`false`(default) |`true`

`IncludeCoverageResult`—Include coverage results
`false`(default) |`true`

`IncludeErrorMessages`—Include error messages
`true`(default) |`false`

`IncludeMWVersion`—Include MATLAB version
`true`(default) |`false`

`IncludeSimulationMetaData`—Include simulation metadata
`false`(default) |`true`

`IncludeSimulationSignalPlots`—Include simulation signal plots
`false`(default) |`true`

`IncludeTestRequirement`—Include test requirement
`true`(default) |`false`

`IncludeTestResults`—Include all or subset of test results
`2`(default) |`0`|`1`

`LaunchReport`—Open report at completion
`true`(default) |`false`

`ReportTitle`—Report title
empty character vector(default)

`SectionSpacing`—Spacing between sections
`'2mm'`(default) |character vector

`SignalPlotHeight`—Plot height
`'600px'`(default) |character vector

`SignalPlotWidth`—Plot width
`'500px'`(default) |character vector

`TableFontColor`—Table font color
`'Black'`(default) |character vector

`TableFontName`—Table font style name
`'Arial'`(default) |character vector

`TableFontSize`—Table font size
`'7.5pt'`(default) |character vector

`TitleFontColor`—Title font color
`'Black'`(default) |character vector

`TitleFontName`—Title font style name
`'Arial'`(default) |character vector

`TitleFontSize`—Title font size
`'16pt'`(default) |character vector