sltest.testmanager.report

Generate report of test results

Syntax

sltest.testmanager.report(resultObj,filePath,Name,Value)

Description

sltest.testmanager.report(resultObj,filePath,Name,Value) generates a report of the specified results in resultObj and saves the report to the filePath location.

Examples

Generate a Test Report

Generate a report that includes the test author, test title, and the MATLAB^® version used to run the test case. The report includes only failed results.

filePath = 'test.pdf';
sltest.testmanager.report(resultObj,filePath,...
	'Author','TestAuthor',...
	'Title','Test',...
	'IncludeMLVersion',true,...
	'IncludeTestResults',2);

Use Custom Report Class to Generate Report

If you create a custom class to customize how the report is generated using the sltest.testmanager.TestResultReport class, then generate the report using:

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

Input Arguments

resultObj — Results set object

object

Results set object to get results from, specified as an sltest.testmanager.ResultSet, sltest.testmanager.TestFileResult, sltest.testmanager.TestSuiteResult, sltest.testmanager.TestCaseResult, or sltest.testmanager.TestIterationResult object.

filePath — Filename and path of the generated report

character vector

Filename and path of the generated report, specified as a character vector. File path must have file extension of pdf, docx, or zip, which are the only supported file types.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'IncludeTestRequirement',true

Author — Report author

empty character vector (default)

Name of the report author, specified as a character vector.

Example: 'Test Engineer'

Title — Report title

'Test' (default) | character vector

Title of the report, specified as a character vector.

Example: 'Test_Report_1'

IncludeMLVersion — Include the MATLAB version

true (default) | false

Choose to include the version of MATLAB used to run the test cases, specified as a Boolean value, true or false.

IncludeTestRequirement — Include the test requirement

true (default) | false

Choose to include the test requirement link defined under Requirements in the test case, specified as a Boolean value, true or false.

IncludeSimulationSignalPlots — Include the simulation output plots

false (default) | true

Choose to include the simulation output plots of each signal, specified as a Boolean value, true or false.

NumPlotRowsPerPage — Number of rows of plots to include on report pages

2 (default)

Number of rows of plots to include on report pages, specified as an integer from 1 to 4. This property is used only if the IncludeSimulationSignalPlots property is true.

NumPlotColumnsPerPage — Number of columns of plots to include on report pages

1 (default)

Number of columns of plots to include on report pages, specified as an integer from 1 to 4. This property is used only if the IncludeSimulationSignalPlots property is true.

IncludeComparisonSignalPlots — Include the comparison plots

false (default) | true

Choose to include the signal comparison plots defined under baseline criteria, equivalence criteria, or assessments using the verify operator in the test case, specified as a Boolean value, true or false.

IncludeMATLABFigures — Option to include figures

false (default) | true

Option to include the figures opened from a callback script, custom criteria, or by the model in the report, specified as true or false.

IncludeErrorMessages — Include error messages

true (default) | false

Choose to include error messages from the test case simulations, specified as a Boolean value, true or false.

IncludeTestResults — Include all or subset of test results

2 (default) | 0 | 1

Option to include all or a subset of test results in the report. You can select passed and failed results, specified as the integer value 0, select only passed results, specified as the value 1, or select only failed results, specified as the value 2.

LaunchReport — Open report at completion

true (default) | false

Open the report when it is finished generating, specified as a Boolean value, true or to not open the report, false.

CustomTemplateFile — Path to document template

character vector

Name and path for a Microsoft^® Word template file to use for report generation, specified as a character vector. This is an optional argument that is only available if you have a MATLAB Report Generator™ license.

CustomReportClass — Class name for customized report

character vector

Name of the class used for report customization, specified as a character vector. This is an optional argument that is only available if you have a MATLAB Report Generator license.

IncludeCoverageResult — Include coverage result metrics

false (default) | true

Choose to include coverage metrics that are collected at test execution, specified as a Boolean value, true or false. For more information about collecting coverage, see Collect Coverage in Tests.

IncludeSimulationMetadata — Include simulation metadata

false (default) | true

Choose to include simulation metadata for each test case or iteration, specified as a Boolean value, true or false. 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.

Version History

Introduced in R2015a