Main Content

本页采用了机器翻译。点击此处可查看英文原文。

setProperty

类: sltest.testmanager.TestCase
命名空间: sltest.testmanager

设置测试用例属性

语法

setProperty(tc,Name,Value)

说明

setProperty(tc,Name,Value) 设置测试用例属性。

输入参数

全部展开

测试用例设置属性,指定为 sltest.testmanager.TestCase 对象。

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量后,但参量对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来

示例: 'StopTime',100

在测系统部分中的模型名称,指定为字符向量。

示例: 'sldemo_absbrake'

模型或框架的仿真模式,指定为字符向量。要返回默认模型设置,请指定一个空字符向量 ''

示例: 'SimulationMode','Rapid Accelerator'

将模型的 SIL/PIL 仿真模式覆盖为普通仿真模式,指定为数字或逻辑 1 (true) 或 0 (false)。如果此属性为 true 或 1,则测试管理器的仿真设置覆盖部分中的相关复选框被选中。

指示测试用例是否覆盖模型开始时间,指定为数字或逻辑 1 (true) 或 0 (false)。

模型开始时间,指定为标量值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

指示测试用例是否覆盖模型停止时间,指定为数字或逻辑 1 (true) 或 0 (false)。

模型停止时间,指定为标量值。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

在最后输入的时间点停止仿真,而不是在停止时间模型设置处停止,指定为数字或逻辑 1true)或 0false)。

数据类型: logical

指示测试用例是否覆盖模型初始状态,指定为数字或逻辑 1 (true) 或 0 (false)。

从工作区变量建模初始状态,指定为字符向量。

在测系统部分中使用的测试框架的名称,指定为字符向量。

测试框架所有者的姓名,指定为字符向量。

要测试的 Model 模块的名称,指定为 Simulink.BlockPath 对象。对于模块路径,包含从顶层模型开始的完整路径。Model 模块可以位于模型或测试框架层次结构中的任何级别。当测试用例运行整个顶层模型或框架时,它会在上下文中测试指定的 Model 模块。但是,覆盖率结果仅包括测试的 Model 模块的结果。

指示测试用例是否覆盖模型并在输入部分使用不同的信号编辑器场景,指定为数字或逻辑 1 (true) 或 0 (false)。

信号编辑器场景名称,指定为字符向量。要返回默认模型设置,请指定一个空字符向量 ''

是否使用来自外部文件(例如 Excel® 或 MAT 文件)的测试数据来创建测试用例,指定为数字或逻辑 1 (true) 或 0 (false)。如果 isTestDataReferencedtrue1,则使用 TestDataPath 指定文件的路径。

创建测试用例所引用的外部文件的路径,指定为字符向量。

将 Excel 或 MAT 文件测试数据转换为测试管理器支持的格式的函数,指定为函数句柄。查看 sltest.testmanager.registerTestAdapter 以了解更多信息。

测试用例的仿真数据检查器 (SDI) 视图文件的路径,指定为字符向量。视图文件指定要绘制的信号及其在测试用例结果中的布局。测试管理器不支持 SDI 视图文件中的某些配置,例如时间图之外的轴图布局和 N-by-M 网格之外的轴布局。然而,如果可能的话,测试管理器会应用类似的配置。您可以为测试文件中的每个测试用例分配不同的视图文件。使用 Simulink.sdi.saveView 创建并保存 SDI 视图文件。有关更多信息,请参阅 保存和共享仿真数据检查器数据和视图

Test Sequence 模块路径,指定为字符向量。指定的模块包含测试用例中要使用的测试序列场景。指定 TestSequenceBlockTestSequenceScenario 来运行活动场景以外的场景。如果没有为 TestSequenceScenario 指定值,则测试将运行 Test Sequence 模块中的活动场景。如果您的 Test Sequence 模块没有场景,则测试将运行模块中的单个测试序列。

测试序列场景名称,指定为字符向量。指定的测试序列场景将代替活动场景运行,或者,如果您使用迭代,则该场景将作为所有迭代的默认场景运行。使用 setTestParam 为迭代分配不同的场景。您必须指定 TestSequenceBlock 才能使用 TestSequenceScenario

运行测试用例的版本,指定为字符串、字符向量或元胞数组。对于等效性检验,您只能为每个仿真索引指定一个版本,例如 ('Release',releaseNames{1},'SimulationIndex',1)。对于其他测试类型,您可以将多个版本指定为元胞或字符串数组,例如 ('Release',releaseNames),其中 releaseNames 是一个元胞数组,例如 {'Current','R2020a'}

指示测试用例是否覆盖输出部分下的模型设置,指定为数字或逻辑 1 (true) 或 0 (false)。

指示测试用例是否覆盖保存模型输出,指定为数字或逻辑 1 (true) 或 0 (false)。

指示测试用例是否设置为保存输出状态值,指定为数字或逻辑 1 (true) 或 0 (false)。

指示测试用例是否设置为记录模型中标记为记录的信号,指定为数字或逻辑 1 (true) 或 0 (false)。

指示测试用例是否设置为记录数据存储变量,指定为数字或逻辑 1 (true) 或 0 (false)。

指示测试用例是否设置为存储最终状态值,指定为数字或逻辑 1 (true) 或 0 (false)。

该属性适用的仿真编号,指定为整数,12。此设置适用于仿真测试用例。

覆盖配置设置,指定为整数。

  • 1 — 无覆盖

  • 2 — 在模型中使用命名配置集

  • 3 — 使用文件中指定的配置集

模型中配置设置的名称,指定为字符向量。

配置集文件中的变量名称,指定为字符向量。

配置集的文件名和路径,指定为字符向量。

预加载回调脚本,指定为字符向量。

加载后回调脚本,指定为字符向量。

测试用例级清理回调脚本,指定为字符向量。该函数删除任何现有的回调脚本并将其替换为指定的字符向量。

示例: 'clear a % clear value from workspace'

在目标计算机上启动实时应用程序之前评估的字符向量,指定为字符向量。有关实时测试的更多信息,请参阅实时测试模型

评估迭代脚本以创建测试用例迭代,指定为字符向量。有关测试迭代脚本的更多信息,请参阅测试迭代

指示测试迭代是否使用快速重启模式运行,指定为数字或逻辑 1 (true) 或 0 (false)。

指示测试用例是否在测试执行后保存测试结果中使用的基线,指定为数字或逻辑 1true)或 0false)。

启用保存测试结果中使用的外部输入运行,指定为数字或逻辑 1 (true) 或 0 (false)。

启用在输入的最终时间值处停止仿真,指定为数字或逻辑 1 (true) 或 0 (false)。

加载应用程序的位置,指定为整数。此属性仅在实时测试用例中可用。

  • 1 — 模型

  • 2 — 目标应用程序

  • 3 — 目标计算机

有关实时测试的更多信息,请参阅实时测试模型

目标计算机的名称,指定为字符向量。此属性仅在实时测试用例中可用。有关实时测试的更多信息,请参阅实时测试模型

目标应用程序的名称和路径,指定为字符向量。此属性仅在实时测试用例中可用。有关实时测试的更多信息,请参阅实时测试模型

自 R2024a 起

运行测试用例之前应用于模型的变体配置的名称,指定为字符串或字符向量。

此属性适用于使用变体元素(例如变体模块和变体参数)的模型,并且还具有使用 Variant Manager for Simulink® 为模型创建的变体配置。对于这样的模型,您可以指定一个变体配置,该配置可以在测试运行之前激活跨模型层次结构的特定变体路径。

有关示例,请参阅 Run Tests for Variant Models Using Variant Configurations

示例: "LinInterExpNoNoise"

数据类型: char | string

RoadRunner 应用程序安装文件夹,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。

RoadRunner 工程文件夹,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。

RoadRunner 场景文件的路径,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。

在控制台模式下运行 RoadRunner 场景的选项,指定为数字或逻辑 1 (true) 或 0 (false)。将此属性设置为 false0 以在图形模式下运行场景,在运行场景时显示 RoadRunner 应用程序。当属性值为 1true 时,RoadRunner 应用程序在后台运行。此属性仅适用于 RoadRunner 测试用例。

设置 RoadRunner 节奏的选项,指定为数字或逻辑 1 (true) 或 0 (false)。当 RoadRunnerTurnOffPacing1true 时,节奏就会停止,场景会以正常速度运行。将此属性设置为 false0 以更改场景运行的速度。此属性仅适用于 RoadRunner 测试用例。

当迭代失败时停止执行测试用例的选项,指定为数字或逻辑 1 (true) 或 0 (false)。当 StopOnFailure0false)时,测试管理器会执行 RoadRunner 测试用例中的所有测试迭代。当 StopOnFailure1 (true) 时,测试管理器会在迭代失败时停止执行 RoadRunner 测试用例。测试用例中的任何后续迭代都未经测试,并且测试管理器执行剩余的测试用例。此属性仅适用于 RoadRunner 测试用例。

用于覆盖默认 RoadRunner 路径设置的选项,指定为数字或逻辑 1 (true) 或 0 (false)。将此属性设置为 true1 以使用您通过 API 而不是在测试管理器中指定的设置,或者设置为 false0 以使用测试管理器中的设置。此属性仅适用于 RoadRunner 测试用例。

示例

全部展开

% Create the test file, test suite, and test case structure
tf = sltest.testmanager.TestFile('API Test File');
ts = createTestSuite(tf,'API Test Suite');
tc = createTestCase(ts,'baseline','Baseline API Test Case');

% Remove the default test suite
tsDel = getTestSuiteByName(tf,'New Test Suite 1');
remove(tsDel);

% Assign the system under test to the test case
setProperty(tc,'Model','sldemo_absbrake');

版本历史记录

在 R2015b 中推出

全部展开