sltest.testmanager.TestCaseResult 类

命名空间: sltest.testmanager
超类: sltest.testmanager.TestIterationResult

访问测试用例结果数据

全页展开

描述

sltest.testmanager.TestCaseResult 使您能够访问执行测试用例或测试文件的结果。

sltest.testmanager.TestCaseResult 类是 handle 类。

类属性

HandleCompatible true

有关类属性的信息，请参阅类属性。

创建对象

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 起

在运行测试用例之前应用于模型的变体配置，指定为包含 Name、Description 和 ControlVariables 字段的结构体。

此属性适用于使用 Variant Manager for Simulink 创建变体配置的模型，并且在测试用例对象上指定了 VariantConfiguration 属性。

例如，请参阅Run Tests for Variant Models Using Variant Configurations。

示例: "LinInterExpNoNoise"

属性：

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

数据类型: struct

`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 中推出

全部展开

R2025a: 变体配置的数据类型已更改

VariantConfiguration 属性是一个结构体，包含 Name、Description 和 ControlVariables 字段。

R2024a: 变体配置的新属性

对于变体模型，VariantConfiguration 属性包含测试用例中使用的变体配置的名称。

R2023b: 新的 RoadRunner 测试用例结果属性

已为 RoadRunner 测试用例添加以下属性：

RoadRunnerSetup
RunOnPlatform

另请参阅

sltest.testmanager.TestSuiteResult | sltest.testmanager.TestFileResult

sltest.testmanager.TestCaseResult 类

描述

类属性

创建对象

属性

NumTotalIterations — 测试总数 整数

属性：

NumPassedIterations — 通过测试的数量 整数

属性：

NumFailedIterations — 失败测试次数 整数

属性：

NumDisabledIterations — 禁用测试的数量 整数

属性：

NumIncompleteIterations — 未完成测试的数量 整数

属性：

Outcome — 测试用例结果 enum

属性：

Name — 测试用例名称 字符串

属性：

TestDataPath — 输入数据文件路径 字符串

属性：

TestFilePath — 测试文件路径 字符向量

属性：

TestCasePath — 结果层次路径 字符向量

属性：

TestCaseType — 测试用例类型 'Simulation' | 'Baseline' | 'Equivalence'

属性：

RunOnTarget — 目标指标 元胞数组

属性：

StartTime — 测试用例开始运行的时间 约会时间

属性：

StopTime — 测试用例完成的时间 约会时间

属性：

Duration — 测试用例运行的时长 持续时间

属性：

Requirements — 测试用例需求 字符串数组

属性：

ErrorMessages — 错误消息 结构

属性：

LogMessages — 日志消息 结构

属性：

CauseOfFailure — 测试用例失败的原因 字符串数组

属性：

DisablingReason — 已禁用描述 字符串

属性：

Baseline — 基线文件的名称 字符串

属性：

ExternalInput — 外部输入和外部输入文件的名称 结构

属性：

ParameterSet — 测试用例参数 ParameterSet 对象

属性：

FaultSet — 故障设置信息 结构

属性：

SignalEditorScenario — 信号编辑器场景名称 字符串

属性：

TestSequenceScenario — 测试序列场景 结构

属性：

VariantConfiguration — 测试用例中使用的变体配置 结构

属性：

SimulationMetaData — 仿真的元数据 SimulationMetadata 对象

属性：

Release — 运行测试的版本 字符向量

属性：

Description — 测试用例描述 字符向量

属性：

CoverageResults — 测试覆盖率结果 字符数组

属性：

Tags — 用于过滤测试文件结果的标签 字符串数组

属性：

Parent — 结果对象的父对象 对象

属性：

UserData — 与测试用例结果一起存储的自定义数据 任何数据类型

属性：

RoadRunnerSetup — RoadRunner 设置 结构体

属性：

RunOnPlatform — 测试用例运行的平台 字符串

属性：

方法

公共方法

示例

`NumTotalIterations` — 测试总数
整数

`NumPassedIterations` — 通过测试的数量
整数

`NumFailedIterations` — 失败测试次数
整数

`NumDisabledIterations` — 禁用测试的数量
整数

`NumIncompleteIterations` — 未完成测试的数量
整数

`Outcome` — 测试用例结果
enum

`Name` — 测试用例名称
字符串

`TestDataPath` — 输入数据文件路径
字符串

`TestFilePath` — 测试文件路径
字符向量

`TestCasePath` — 结果层次路径
字符向量

`TestCaseType` — 测试用例类型
`'Simulation'` | `'Baseline'` | `'Equivalence'`

`RunOnTarget` — 目标指标
元胞数组

`StartTime` — 测试用例开始运行的时间
约会时间

`StopTime` — 测试用例完成的时间
约会时间

`Duration` — 测试用例运行的时长
持续时间

`Requirements` — 测试用例需求
字符串数组

`ErrorMessages` — 错误消息
结构

`LogMessages` — 日志消息
结构

`CauseOfFailure` — 测试用例失败的原因
字符串数组

`DisablingReason` — 已禁用描述
字符串

`Baseline` — 基线文件的名称
字符串

`ExternalInput` — 外部输入和外部输入文件的名称
结构

`ParameterSet` — 测试用例参数
`ParameterSet` 对象

`FaultSet` — 故障设置信息
结构

`SignalEditorScenario` — 信号编辑器场景名称
字符串

`TestSequenceScenario` — 测试序列场景
结构

`VariantConfiguration` — 测试用例中使用的变体配置
结构

`SimulationMetaData` — 仿真的元数据
`SimulationMetadata` 对象

`Release` — 运行测试的版本
字符向量

`Description` — 测试用例描述
字符向量

`CoverageResults` — 测试覆盖率结果
字符数组

`Tags` — 用于过滤测试文件结果的标签
字符串数组

`Parent` — 结果对象的父对象
对象

`UserData` — 与测试用例结果一起存储的自定义数据
任何数据类型

`RoadRunnerSetup` — RoadRunner 设置
结构体

`RunOnPlatform` — 测试用例运行的平台
字符串