sltest.testmanager.TestCaseResult 类
命名空间: sltest.testmanager
超类: sltest.testmanager.TestIterationResult
访问测试用例结果数据
描述
sltest.testmanager.TestCaseResult
使您能够访问执行测试用例或测试文件的结果。
sltest.testmanager.TestCaseResult
类是 handle
类。
创建对象
从 tcr
= getTestCaseResults(ResultSet
)ResultSet
返回 tcr
的测试用例结果。
属性
NumTotalIterations
— 测试总数
整数
单个测试用例结果中的测试总数,以整数形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
NumPassedIterations
— 通过测试的数量
整数
单个测试用例结果中通过的测试的数量,以整数形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
NumFailedIterations
— 失败测试次数
整数
单个测试用例结果中失败的测试数,以整数形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
NumDisabledIterations
— 禁用测试的数量
整数
单个测试用例结果中禁用的测试的数量,以整数形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
NumIncompleteIterations
— 未完成测试的数量
整数
单个测试用例结果中未完成测试的数量,以整数形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Outcome
— 测试用例结果
enum
单个测试用例的结果,以枚举值的形式返回。有效值为:
已禁用
失败的
不完整
已通过
跑步
已安排
未经测试
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Name
— 测试用例名称
字符串
测试用例名称,以字符串形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
TestDataPath
— 输入数据文件路径
字符串
输入数据文件的路径,以字符串形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
TestFilePath
— 测试文件路径
字符向量
用于创建测试用例结果的测试文件的路径。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
TestCasePath
— 结果层次路径
字符向量
父结果集中的层次结构路径。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
TestCaseType
— 测试用例类型
'Simulation'
| 'Baseline'
| 'Equivalence'
测试用例的类型来自测试管理器中的三个可用测试用例:仿真、基线和等效性。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
RunOnTarget
— 目标指标
元胞数组
指示仿真是否在目标上运行,以布尔元胞数组形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
StartTime
— 测试用例开始运行的时间
约会时间
测试用例开始运行的时间,以日期时间形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
StopTime
— 测试用例完成的时间
约会时间
测试用例完成的时间,以日期时间形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Duration
— 测试用例运行的时长
持续时间
测试用例运行的时间长度(以秒为单位),以持续时间形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Requirements
— 测试用例需求
字符串数组
与测试用例相关的需求,以字符串数组的形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
ErrorMessages
— 错误消息
结构
测试用例产生的错误消息,以结构形式返回。该结构包含两个字段,TestCase
和 Simulation
。TestCase
字段是一个字符串数组,包含测试用例的名称。Simulation
字段是一个具有两个字段的结构,simulationIndex
和 messages
。messages
字段是一个字符串数组,其中包含错误消息的文本。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
LogMessages
— 日志消息
结构
测试用例生成的日志消息,以结构形式返回。该结构包含两个字段,TestCase
和 Simulation
。TestCase
字段是一个字符串数组,包含测试用例的名称。Simulation
字段是一个具有两个字段的结构,simulationIndex
和 messages
。messages
字段是一个包含日志消息文本的字符串数组。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
CauseOfFailure
— 测试用例失败的原因
字符串数组
测试用例失败的原因,以字符串数组的形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
DisablingReason
— 已禁用描述
字符串
测试用例被禁用的原因的描述文本,以字符串形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Baseline
— 基线文件的名称
字符串
测试用例中使用的基线文件的名称,以字符串形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
ExternalInput
— 外部输入和外部输入文件的名称
结构
外部输入和外部输入文件的名称,以结构形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
ParameterSet
— 测试用例参数
ParameterSet
对象
可以覆盖模型参数的测试用例参数,以包含 sltest.testmanager.ParameterSet
对象的名称、对象路径以及列出参数覆盖的结构体的结构返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
FaultSet
— 故障设置信息
结构
故障集信息,以结构形式返回。该结构体有两个字段:
FaultSetName
— 故障集的名称,以字符向量形式返回。SpecifiedFaults
— 故障集中启用的故障,以结构形式返回。该结构的每个元素都是包含三个字段的结构:ModelElement
— 故障的模型元素路径,以字符向量形式返回。FaultName
— 故障名称,以字符向量形式返回。Trigger
— 故障触发类型,以字符向量形式返回。
有关这些故障属性的更多信息,请参阅 Specify Fault Properties (Simulink Fault Analyzer)。
如果您没有 Simulink® Fault Analyzer™,则此属性为空。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
SignalEditorScenario
— 信号编辑器场景名称
字符串
测试用例中使用的信号编辑器场景的名称,以字符串形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
TestSequenceScenario
— 测试序列场景
结构
测试用例中使用的测试序列场景,以结构体形式返回。该结构包含两个字段,TestSequenceBlock
和 TestSequenceScenario
。TestSequenceBlock
字段是包含该场景的 Test Sequence 模块的路径。TestSequenceScenario
是测试期间运行的场景的名称。仅当测试用例不包含迭代时,才会在 TestCaseResult
对象中返回测试序列信息。如果包含迭代,则 TestSequenceScenario
将在 TestIterationResults
对象中返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
VariantConfiguration
— 测试用例中使用的变体配置
字符串 | 字符向量
自 R2024a 起
运行测试用例之前应用于模型的变体配置,指定为字符串或字符向量。
此属性适用于使用 Simulink 的变体管理器创建的变体配置的模型,并且使用 setProperty
方法在测试用例对象上指定了 VariantConfiguration
属性。
有关示例,请参阅 Run Tests for Variant Models Using Variant Configurations。
示例: "LinInterExpNoNoise"
属性:
GetAccess | public |
SetAccess | private |
Dependent | true |
NonCopyable | true |
数据类型: char
| string
SimulationMetaData
— 仿真的元数据
SimulationMetadata
对象
仿真的元数据,以 Simulink.SimulationMetadata
对象的形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Release
— 运行测试的版本
字符向量
运行测试的版本,以字符向量形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Description
— 测试用例描述
字符向量
测试用例的描述,以字符向量形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
CoverageResults
— 测试覆盖率结果
字符数组
测试覆盖率结果,以字符数组形式返回。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Tags
— 用于过滤测试文件结果的标签
字符串数组
用于过滤测试文件结果的标签。使用标签查看测试结果的子集。查看 标签 以了解更多信息。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
Parent
— 结果对象的父对象
对象
结果的父级。测试用例结果的父级是测试套件结果或结果集对象。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
UserData
— 与测试用例结果一起存储的自定义数据
任何数据类型
与测试用例结果一起存储的自定义数据,指定为任何类型的数据。使用此字段添加自定义信息,例如用于获取结果的设置。
属性:
SetAccess | public |
GetAccess | public |
Dependent | true |
NonCopyable | true |
RoadRunnerSetup
— RoadRunner 设置
结构体
用于产生测试用例结果的 RoadRunner 设置,以包含以下字段的结构体返回:
RoadRunnerProjectPath
— RoadRunner 工程的路径RoadRunnerInstallationPath
— RoadRunner 应用程序的路径RoadRunnerScenarioPath
— RoadRunner 场景的路径RunInConsoleMode
—场景是在控制台还是图形模式下运行TurnOffPacing
—场景运行时是否开启或关闭节奏
此属性仅适用于 RoadRunner 测试用例。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
RunOnPlatform
— 测试用例运行的平台
字符串
运行测试用例的平台,以字符串形式返回此属性仅适用于 RoadRunner 测试用例。
属性:
SetAccess | private |
GetAccess | public |
Dependent | true |
NonCopyable | true |
方法
公共方法
getAssessmentResults | 获取测试用例结果的逻辑与时序评估结果 |
getBaselineRun | 获取测试用例基线数据集 |
getTestCase | 获取产生结果的测试用例 |
getComparisonResult | 获取测试数据比对结果 |
getComparisonRun | 获取测试用例信号比对结果 |
getCoverageResults | 获取覆盖率结果 |
getCustomCriteriaPlots | 根据测试用例自定义准则获取图表 |
getCustomCriteriaResult | 从测试用例结果中获取自定义准则结果 |
getIterationResults | 获取迭代结果 |
getInputRuns | 获取通过测试结果捕获的仿真输入 |
getOutputRuns | 获取测试用例仿真输出结果 |
getSimulationPlots | 从测试用例回调中获取图表 |
getVerifyRuns | 获取测试用例验证语句 |
getTimingInfo | 测试用例结果的计时执行信息 |
示例
从结果集中获取测试用例结果
此示例显示如何从测试管理器运行测试文件并获取结果集。在此示例中,由于未指定模型,因此第一个测试用例的 Outcome
是 Failed
。
创建测试文件、测试套件和测试用例结构体。
tf = sltest.testmanager.TestFile('My Test File'); ts = createTestSuite(tf,'Baseline Test Suite'); tc = createTestCase(ts,'baseline','Baseline Test Case');
运行测试文件并获取输出结果集。
resultset = sltest.testmanager.run;
获取测试文件、测试套件和测试用例结果对象。
tfr = getTestFileResults(resultset); tsr = getTestSuiteResults(tfr); tcr = getTestCaseResults(tsr);
获取测试用例对应的错误消息。
msg = tcr.ErrorMessages; msg.Simulation.messages
ans = "No model specified. Test did not run."
查看第一个测试用例的 Outcome 字段。
tcr(1).Outcome
ans = TestResultOutcomes enumeration Failed
版本历史记录
在 R2015a 中推出R2024a: 变体配置的新属性
对于变体模型,VariantConfiguration
属性包含测试用例中使用的变体配置的名称。
R2023b: 新的 RoadRunner 测试用例结果属性
已为 RoadRunner 测试用例添加以下属性:
RoadRunnerSetup
RunOnPlatform
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)