setProperty
类: sltest.testmanager.TestCase
命名空间: sltest.testmanager
设置测试用例属性
语法
setProperty(tc,Name=Value)
说明
setProperty( 将测试用例 tc,Name=Value)tc 的属性设置为由 Name 指定的值,该属性由 Value 指定.
输入参数
用于设置属性的测试用例,指定为一个 sltest.testmanager.TestCase 对象。
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量之后,但对各个参量对组的顺序没有要求。
在测系统部分中的模型名称,指定为字符向量。
示例: '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
在最后输入的时间点停止仿真,而不是在停止时间模型设置处停止,指定为数字或逻辑 1 (true)或 0 (false)。
数据类型: logical
指示测试用例是否覆盖模型初始状态,指定为数字或逻辑 1 (true) 或 0 (false)。
从工作区变量建模初始状态,指定为字符向量。
在测系统部分中使用的测试框架的名称,指定为字符向量。
测试框架所有者的姓名,指定为字符向量。
要测试的 Model 模块的名称,指定为 Simulink.BlockPath 对象。对于模块路径,包含从顶层模型开始的完整路径。Model 模块可以位于模型或测试框架层次结构中的任何级别。当测试用例运行整个顶层模型或框架时,它会在上下文中测试指定的 Model 模块。但是,覆盖率结果仅包括测试的 Model 模块的结果。
指示测试用例是否覆盖模型并在输入部分使用不同的信号编辑器场景,指定为数字或逻辑 1 (true) 或 0 (false)。
信号编辑器场景名称,指定为字符向量。要返回默认模型设置,请指定一个空字符向量 ''。
是否使用来自外部文件(例如 Excel® 或 MAT 文件)的测试数据来创建测试用例,指定为数字或逻辑 1 (true) 或 0 (false)。如果 isTestDataReferenced 是 true 或 1,则使用 TestDataPath 指定文件的路径。
创建测试用例所引用的外部文件的路径,指定为字符向量。
将 Excel 或 MAT 文件测试数据转换为测试管理器支持的格式的函数,指定为函数句柄。查看 sltest.testmanager.registerTestAdapter 以了解更多信息。
测试用例的仿真数据检查器 (SDI) 视图文件的路径,指定为字符向量。视图文件指定要绘制的信号及其在测试用例结果中的布局。测试管理器不支持 SDI 视图文件中的某些配置,例如时间图之外的轴图布局和 N×M 网格之外的轴布局。然而,如果可能的话,测试管理器会应用类似的配置。您可以为测试文件中的每个测试用例分配不同的视图文件。使用 Simulink.sdi.saveView 创建并保存 SDI 视图文件。有关更多信息,请参阅保存和共享仿真数据检查器数据和视图。
Test Sequence 模块路径,指定为字符向量。指定的模块包含测试用例中要使用的测试序列场景。指定 TestSequenceBlock 和 TestSequenceScenario 来运行活动场景以外的场景。如果没有为 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)。
该属性适用的仿真编号,指定为整数,1 或 2。此设置适用于仿真测试用例。
覆盖配置设置,指定为整数。
1- 无覆盖2- 在模型中使用命名配置集3- 使用文件中指定的配置集
模型中配置设置的名称,指定为字符向量。
配置集文件中的变量名称,指定为字符向量。
配置集的文件名和路径,指定为字符向量。
自 R2024a 起
运行测试用例之前应用于模型的变体配置的名称,指定为字符串或字符向量。
此属性适用于使用变体元素(例如变体模块和变体参数)的模型,并且还具有使用 Variant Manager for Simulink® 为模型创建的变体配置。对于这样的模型,您可以指定一个变体配置,该配置可以在测试运行之前激活跨模型层次结构的特定变体路径。
例如,请参阅Run Tests for Variant Models Using Variant Configurations。
预加载回调脚本,指定为字符向量。
加载后回调脚本,指定为字符向量。
测试用例级清理回调脚本,指定为字符向量。该函数删除任何现有的回调脚本并将其替换为指定的字符向量。
示例: 'clear a % clear value from workspace'
在目标计算机上启动实时应用程序之前评估的字符向量,指定为字符向量。有关实时测试的更多信息,请参阅实时测试模型。
评估迭代脚本以创建测试用例迭代,指定为字符向量。有关测试迭代脚本的更多信息,请参阅测试迭代。
指示测试迭代是否使用快速重启模式运行,指定为数字或逻辑 1 (true) 或 0 (false)。
指示测试用例是否在测试执行后保存测试结果中使用的基线,指定为数字或逻辑 1 (true)或 0 (false)。
启用保存测试结果中使用的外部输入运行,指定为数字或逻辑 1 (true) 或 0 (false)。
启用在输入的最终时间值处停止仿真,指定为数字或逻辑 1 (true) 或 0 (false)。
在仿真完成时启用绘制记录的信号,指定为数字或逻辑 1 (true) 或 0 (false)。
目标计算机的名称,指定为字符向量。此属性仅在实时测试用例中可用。有关实时测试的更多信息,请参阅实时测试模型。
目标应用程序的名称和路径,指定为字符向量。此属性仅在实时测试用例中可用。有关实时测试的更多信息,请参阅实时测试模型。
RoadRunner 应用程序安装文件夹,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。
RoadRunner 工程文件夹,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。
RoadRunner 场景文件的路径,指定为字符串或字符向量。此属性仅适用于 RoadRunner 测试用例。
在控制台模式下运行 RoadRunner 场景的选项,指定为数字或逻辑 1 (true) 或 0 (false)。将此属性设置为 false 或 0 以在图形模式下运行场景,在运行场景时显示 RoadRunner 应用程序。当属性值为 1 或 true 时,RoadRunner 应用程序在后台运行。此属性仅适用于 RoadRunner 测试用例。
设置 RoadRunner 节奏的选项,指定为数字或逻辑 1 (true) 或 0 (false)。当 RoadRunnerTurnOffPacing 是 1 或 true 时,节奏就会停止,场景会以正常速度运行。将此属性设置为 false 或 0 以更改场景运行的速度。此属性仅适用于 RoadRunner 测试用例。
当迭代失败时停止执行测试用例的选项,指定为数字或逻辑 1 (true) 或 0 (false)。当 StopOnFailure 为 0 (false)时,测试管理器会执行 RoadRunner 测试用例中的所有测试迭代。当 StopOnFailure 是 1 (true) 时,测试管理器会在迭代失败时停止执行 RoadRunner 测试用例。测试用例中的任何后续迭代都未经测试,并且测试管理器执行剩余的测试用例。此属性仅适用于 RoadRunner 测试用例,不支持并行执行的测试。
用于覆盖默认 RoadRunner 路径设置的选项,指定为数字或逻辑 1 (true) 或 0 (false)。将此属性设置为 true 或 1 以使用您通过 API 而不是在测试管理器中指定的设置,或者设置为 false 或 0 以使用测试管理器中的设置。此属性仅适用于 RoadRunner 测试用例。
自 R2025a 起
用于在测试执行过程中仿真的序列图,指定为字符串标量或字符向量。此属性适用于基线测试用例和仿真测试用例。当您运行测试时,测试管理器中的结果包含序列图结果。
在测试执行过程中仿真多个序列图,请使用测试迭代。有关详细信息,请参阅 setTestParam。
示例
% 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 中推出使用 SequenceDiagram 属性指定在测试执行过程中要仿真的序列图。您可以为基线测试用例和仿真测试用例设置此属性。
使用 StopOnFailure 属性指定当迭代失败时是否停止 RoadRunner 测试用例的执行。
使用 StopSimAtLastTimePoint 属性在最后一个输入时间点停止仿真,而不是模型停止时间。
使用 OverrideRoadRunnerDefaultSettings 属性来覆盖 RoadRunner 测试的默认文件和文件夹路径。
对于变体模型,使用 VariantConfiguration 属性指定在运行测试之前要应用于模型的变体配置。
为 RoadRunner 测试用例添加了以下属性:
RoadRunnerInstallationFolderRoadRunnerProjectFolderRoadRunnerScenarioPathRoadRunnerRunInConsoleModeRoadRunnerTurnOffPacing
使用 ComponentUnderTestName 属性指定要测试的 Model 模块。Model 模块可以位于模型或测试框架层次结构的任何级别。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- 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)