setProperty
类: sltest.testmanager.TestCase
命名空间: sltest.testmanager
设置测试用例属性
语法
setProperty(tc,Name,Value)
说明
setProperty(
设置测试用例属性。tc
,Name,Value
)
输入参数
tc
— 测试用例
sltest.testmanager.TestCase
对象
测试用例设置属性,指定为 sltest.testmanager.TestCase
对象。
名称-值参数
将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN
,其中 Name
是参量名称,Value
是对应的值。名称-值参量必须出现在其他参量后,但参量对组的顺序无关紧要。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: 'StopTime',100
Model
— 在测系统模型名称
''
(默认)
在测系统部分中的模型名称,指定为字符向量。
示例: 'sldemo_absbrake'
SimulationMode
— 仿真模式
空特征向量 (默认) | 'Normal'
| 'Accelerator'
| 'Rapid Accelerator'
| 'Software-in-the-Loop (SIL)'
| 'Processor-in-the-Loop (PIL)'
模型或框架的仿真模式,指定为字符向量。要返回默认模型设置,请指定一个空字符向量 ''
。
示例: 'SimulationMode','Rapid Accelerator'
OverrideSILPILMode
— 覆盖 SIL 或 PIL 模式
false
或 0
(默认) | true
或 1
将模型的 SIL/PIL 仿真模式覆盖为普通仿真模式,指定为数字或逻辑 1
(true
) 或 0
(false
)。如果此属性为 true
或 1,则测试管理器的仿真设置覆盖部分中的相关复选框被选中。
OverrideStartTime
— 覆盖模型开始时间
false
或 0
(默认) | true
或 1
指示测试用例是否覆盖模型开始时间,指定为数字或逻辑 1
(true
) 或 0
(false
)。
StartTime
— 模型开始时间
0
(默认) | 标量
模型开始时间,指定为标量值。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
OverrideStopTime
— 覆盖模型停止时间
false
或 0
(默认) | true
或 1
指示测试用例是否覆盖模型停止时间,指定为数字或逻辑 1
(true
) 或 0
(false
)。
StopTime
— 模型停止时间
10
(默认) | 标量
模型停止时间,指定为标量值。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
StopSimAtLastTimePoint
— 在最后输入的时间点停止仿真
false
或 0
(默认) | true
或 1
在最后输入的时间点停止仿真,而不是在停止时间模型设置处停止,指定为数字或逻辑 1
(true
)或 0
(false
)。
数据类型: logical
OverrideInitialState
— 覆盖模型初始状态
false
或 0
(默认) | true
或 1
指示测试用例是否覆盖模型初始状态,指定为数字或逻辑 1
(true
) 或 0
(false
)。
InitialState
— 模型初始状态
空特征向量 (默认)
从工作区变量建模初始状态,指定为字符向量。
HarnessName
— 测试框架名称
空特征向量 (默认)
在测系统部分中使用的测试框架的名称,指定为字符向量。
HarnessOwner
— 测试框架所有者姓名
空特征向量 (默认)
测试框架所有者的姓名,指定为字符向量。
ComponentUnderTestName
— 要测试的 Model 模块的名称
Simulink.BlockPath
对象
要测试的 Model 模块的名称,指定为 Simulink.BlockPath
对象。对于模块路径,包含从顶层模型开始的完整路径。Model 模块可以位于模型或测试框架层次结构中的任何级别。当测试用例运行整个顶层模型或框架时,它会在上下文中测试指定的 Model 模块。但是,覆盖率结果仅包括测试的 Model 模块的结果。
UseSignalEditorScenarios
— 覆盖信号编辑器场景
false
或 0
(默认) | true
或 1
指示测试用例是否覆盖模型并在输入部分使用不同的信号编辑器场景,指定为数字或逻辑 1
(true
) 或 0
(false
)。
SignalEditorScenario
— 信号编辑器场景名称
空特征向量 (默认)
信号编辑器场景名称,指定为字符向量。要返回默认模型设置,请指定一个空字符向量 ''
。
IsTestDataReferenced
— 使用外部文件创建测试用例
false
或 0
(默认) | true
或 1
是否使用来自外部文件(例如 Excel® 或 MAT 文件)的测试数据来创建测试用例,指定为数字或逻辑 1
(true
) 或 0
(false
)。如果 isTestDataReferenced
是 true
或 1
,则使用 TestDataPath
指定文件的路径。
TestDataPath
— 测试用例的外部文件路径
字符向量
创建测试用例所引用的外部文件的路径,指定为字符向量。
Adapter
— 转换 Excel 或 MAT 文件测试数据的函数
函数句柄
将 Excel 或 MAT 文件测试数据转换为测试管理器支持的格式的函数,指定为函数句柄。查看 sltest.testmanager.registerTestAdapter
以了解更多信息。
SDIViewFile
— 测试用例的仿真数据检查器视图文件的路径
字符向量
测试用例的仿真数据检查器 (SDI) 视图文件的路径,指定为字符向量。视图文件指定要绘制的信号及其在测试用例结果中的布局。测试管理器不支持 SDI 视图文件中的某些配置,例如时间图之外的轴图布局和 N-by-M 网格之外的轴布局。然而,如果可能的话,测试管理器会应用类似的配置。您可以为测试文件中的每个测试用例分配不同的视图文件。使用 Simulink.sdi.saveView
创建并保存 SDI 视图文件。有关更多信息,请参阅 保存和共享仿真数据检查器数据和视图。
TestSequenceBlock
— Test Sequence 模块路径
字符向量
Test Sequence 模块路径,指定为字符向量。指定的模块包含测试用例中要使用的测试序列场景。指定 TestSequenceBlock
和 TestSequenceScenario
来运行活动场景以外的场景。如果没有为 TestSequenceScenario
指定值,则测试将运行 Test Sequence 模块中的活动场景。如果您的 Test Sequence 模块没有场景,则测试将运行模块中的单个测试序列。
TestSequenceScenario
— 测试序列场景名称
字符向量
测试序列场景名称,指定为字符向量。指定的测试序列场景将代替活动场景运行,或者,如果您使用迭代,则该场景将作为所有迭代的默认场景运行。使用 setTestParam
为迭代分配不同的场景。您必须指定 TestSequenceBlock
才能使用 TestSequenceScenario
。
Release
— 运行测试用例的版本
Current
(默认) | string
| character vector
| cell array
| string array
运行测试用例的版本,指定为字符串、字符向量或元胞数组。对于等效性检验,您只能为每个仿真索引指定一个版本,例如 ('Release',releaseNames{1},'SimulationIndex',1)
。对于其他测试类型,您可以将多个版本指定为元胞或字符串数组,例如 ('Release',releaseNames)
,其中 releaseNames
是一个元胞数组,例如 {'Current','R2020a'}
。
OverrideModelOutputSettings
— 覆盖模型输出设置
false
或 0
(默认) | true
或 1
指示测试用例是否覆盖输出部分下的模型设置,指定为数字或逻辑 1
(true
) 或 0
(false
)。
SaveOutput
— 覆盖保存输出
false
或 0
(默认) | true
或 1
指示测试用例是否覆盖保存模型输出,指定为数字或逻辑 1
(true
) 或 0
(false
)。
SaveState
— 保存输出状态值
false
或 0
(默认) | true
或 1
指示测试用例是否设置为保存输出状态值,指定为数字或逻辑 1
(true
) 或 0
(false
)。
SignalLogging
— 记录信号
true
或 1
(默认) | false
或 0
指示测试用例是否设置为记录模型中标记为记录的信号,指定为数字或逻辑 1
(true
) 或 0
(false
)。
DSMLogging
— 记录数据存储变量
true
或 1
(默认) | false
或 0
指示测试用例是否设置为记录数据存储变量,指定为数字或逻辑 1
(true
) 或 0
(false
)。
SaveFinalState
— 保存最终状态
false
或 0
(默认) | true
或 1
指示测试用例是否设置为存储最终状态值,指定为数字或逻辑 1
(true
) 或 0
(false
)。
SimulationIndex
— 等效性测试用例仿真
1
(默认) | 2
该属性适用的仿真编号,指定为整数,1
或 2
。此设置适用于仿真测试用例。
ConfigSetOverrideSetting
— 配置设置覆盖
1
(默认) | 2
| 3
覆盖配置设置,指定为整数。
1
— 无覆盖2
— 在模型中使用命名配置集3
— 使用文件中指定的配置集
ConfigSetName
— 配置集名称
空特征向量 (默认)
模型中配置设置的名称,指定为字符向量。
ConfigSetVarName
— 配置集变量名称
空特征向量 (默认)
配置集文件中的变量名称,指定为字符向量。
ConfigSetFileLocation
— 配置集文件路径
空特征向量 (默认)
配置集的文件名和路径,指定为字符向量。
PreloadCallback
— 预加载回调脚本
字符向量
预加载回调脚本,指定为字符向量。
PostloadCallback
— 加载后回调脚本
字符向量
加载后回调脚本,指定为字符向量。
CleanupCallback
— 清理回调脚本
字符向量
测试用例级清理回调脚本,指定为字符向量。该函数删除任何现有的回调脚本并将其替换为指定的字符向量。
示例: 'clear a % clear value from workspace'
PreStartRealTimeApplicationCallback
— 实时启动前回调
字符向量
在目标计算机上启动实时应用程序之前评估的字符向量,指定为字符向量。有关实时测试的更多信息,请参阅实时测试模型。
IterationScript
— 迭代脚本
字符向量
评估迭代脚本以创建测试用例迭代,指定为字符向量。有关测试迭代脚本的更多信息,请参阅测试迭代。
FastRestart
— 使用快速重启运行迭代
false
或 0
(默认) | true
或 1
指示测试迭代是否使用快速重启模式运行,指定为数字或逻辑 1
(true
) 或 0
(false
)。
SaveBaselineRunInTestResult
— 在测试结果中保存基线
false
(默认) | true
指示测试用例是否在测试执行后保存测试结果中使用的基线,指定为数字或逻辑 1
(true
)或 0
(false
)。
SaveInputRunInTestResult
— 保存测试结果中的输入
false
或 0
(默认) | true
或 1
启用保存测试结果中使用的外部输入运行,指定为数字或逻辑 1
(true
) 或 0
(false
)。
StopSimAtLastTimePoint
— 在最后输入的时间停止仿真
false
或 0
(默认) | true
或 1
启用在输入的最终时间值处停止仿真,指定为数字或逻辑 1
(true
) 或 0
(false
)。
LoadAppFrom
— 应用程序位置
1
(默认) | 2
| 3
TargetComputer
— 目标计算机名称
字符向量
目标计算机的名称,指定为字符向量。此属性仅在实时测试用例中可用。有关实时测试的更多信息,请参阅实时测试模型。
TargetApplication
— 目标应用程序名称和路径
字符向量
目标应用程序的名称和路径,指定为字符向量。此属性仅在实时测试用例中可用。有关实时测试的更多信息,请参阅实时测试模型。
VariantConfiguration
— 变体配置名称
字符串 | 字符向量
自 R2024a 起
运行测试用例之前应用于模型的变体配置的名称,指定为字符串或字符向量。
此属性适用于使用变体元素(例如变体模块和变体参数)的模型,并且还具有使用 Variant Manager for Simulink® 为模型创建的变体配置。对于这样的模型,您可以指定一个变体配置,该配置可以在测试运行之前激活跨模型层次结构的特定变体路径。
有关示例,请参阅 Run Tests for Variant Models Using Variant Configurations。
示例: "LinInterExpNoNoise"
数据类型: char
| string
RoadRunnerInstallationFolder
— RoadRunner 应用程序安装文件夹
字符串 | 字符向量
RoadRunner 应用程序安装文件夹,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。
RoadRunnerProjectFolder
— RoadRunner 工程文件夹
字符串 | 字符向量
RoadRunner 工程文件夹,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。
RoadRunnerScenarioPath
— RoadRunner 场景文件的路径
字符串 | 字符向量
RoadRunner 场景文件的路径,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。
RoadRunnerRunInConsoleMode
— 在控制台模式下运行 RoadRunner 场景的选项
true
或 1
(默认) | false
或 0
在控制台模式下运行 RoadRunner 场景的选项,指定为数字或逻辑 1
(true
) 或 0
(false
)。将此属性设置为 false
或 0
以在图形模式下运行场景,在运行场景时显示 RoadRunner 应用程序。当属性值为 1
或 true
时,RoadRunner 应用程序在后台运行。此属性仅适用于 RoadRunner 测试用例。
RoadRunnerTurnOffPacing
— 设置 RoadRunner 节奏的选项
true
或 1
(默认) | false
或 0
设置 RoadRunner 节奏的选项,指定为数字或逻辑 1
(true
) 或 0
(false
)。当 RoadRunnerTurnOffPacing
是 1
或 true
时,节奏就会停止,场景会以正常速度运行。将此属性设置为 false
或 0
以更改场景运行的速度。此属性仅适用于 RoadRunner 测试用例。
StopOnFailure
— 当迭代失败时停止执行测试用例的选项
false
或 0
(默认) | true
或 1
当迭代失败时停止执行测试用例的选项,指定为数字或逻辑 1
(true
) 或 0
(false
)。当 StopOnFailure
为 0
(false
)时,测试管理器会执行 RoadRunner 测试用例中的所有测试迭代。当 StopOnFailure
是 1
(true
) 时,测试管理器会在迭代失败时停止执行 RoadRunner 测试用例。测试用例中的任何后续迭代都未经测试,并且测试管理器执行剩余的测试用例。此属性仅适用于 RoadRunner 测试用例。
OverrideRoadRunnerDefaultSettings
— 覆盖默认 RoadRunner 设置的选项
true
或 1
(默认) | false
或 0
用于覆盖默认 RoadRunner 路径设置的选项,指定为数字或逻辑 1
(true
) 或 0
(false
)。将此属性设置为 true
或 1
以使用您通过 API 而不是在测试管理器中指定的设置,或者设置为 false
或 0
以使用测试管理器中的设置。此属性仅适用于 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 中推出R2024a: 控制 RoadRunner 测试用例的执行
使用 StopOnFailure
属性指定当迭代失败时是否停止 RoadRunner 测试用例的执行。
R2024a: 覆盖模型停止时间
使用 StopSimAtLastTimePoint
属性在最后一个输入时间点停止仿真,而不是模型停止时间。
R2024a: 覆盖 RoadRunner 默认路径设置
使用 OverrideRoadRunnerDefaultSettings
属性来覆盖 RoadRunner 测试的默认文件和文件夹路径。
R2024a: 变体配置的新属性
对于变体模型,使用 VariantConfiguration
属性指定在运行测试之前要应用于模型的变体配置。
R2023b: 设置 RoadRunner 测试用例的属性
为 RoadRunner 测试用例添加了以下属性:
RoadRunnerInstallationFolder
RoadRunnerProjectFolder
RoadRunnerScenarioPath
RoadRunnerRunInConsoleMode
RoadRunnerTurnOffPacing
R2023a: Model 模块名称的新属性
使用 ComponentUnderTestName
属性指定要测试的 Model 模块。Model 模块可以位于模型或测试框架层次结构的任何级别。
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)