在测试管理器中指定测试属性

测试用例、测试套件和测试文件部分摘要

当您在测试管理器中打开测试用例、测试套件或测试文件时，测试设置将分组到几个部分。测试用例、测试套件和测试文件有不同的部分和设置。点击测试浏览器窗格中的测试用例、测试套件或测试文件以查看其设置。

如果您不想看到所有可用的测试部分，您可以使用测试管理器预设项来隐藏部分：

无论预设项设置如何，已修改的部分都会出现在测试管理器中。

要以编程方式设置这些属性，请参阅 sltest.testmanager.getpref 和 sltest.testmanager.setpref。

从外部文件创建测试用例

要使用受支持的 Simulink^® Test™ 格式的现有 Excel^® 文件创建测试用例，请选择从外部文件创建测试用例。然后，输入文件的路径。对应的 API 属性是 IsTestDataReferenced 和 TestDataPath，它们在 sltest.testmanager.TestCase 的 setProperty 方法中描述。

要了解如何格式化 Excel 文件，请参阅 Microsoft Excel 导入、导出和记录格式 和 创建用于测试用例的外部数据文件。

要使用不受支持格式的现有 Excel，请编写一个适配器函数，以便可以在测试管理器中使用该文件。然后，使用 sltest.testmanager.registerTestAdapter 函数注册该文件。如果您已经注册了一个适配器，当您选择从外部文件创建测试用例时，测试管理器会显示两个字段，一个用于 Excel 文件的路径，一个用于适配器功能名称。请参阅 sltest.testmanager.registerTestAdapter 了解信息和示例。

标签

用分类标记您的测试文件、测试套件或测试用例，例如 safety、logged-data 或 burn-in。执行测试或查看结果时使用这些标签过滤测试。请参阅过滤测试执行、结果和覆盖率。

对于相应的 API，分别请参阅 sltest.testmanager.TestFile、sltest.testmanager.TestSuite 或 sltest.testmanager.TestCase 的 Tags 属性。

描述

向您的测试用例、测试套件或测试文件添加描述性文本。

对于相应的 API，分别请参阅 sltest.testmanager.TestFile、sltest.testmanager.TestSuite 或 sltest.testmanager.TestCase 的 Description 属性。

需求

如果您安装了 Requirements Toolbox™，您可以通过将测试文件、测试套件或测试用例链接到需求来建立可追溯性。有关更多信息，请参阅将测试用例链接到需求 (Requirements Toolbox)。有关如何将迭代或评估链接到需求的更多信息，请参阅将 Simulink Test 项与需求关联 (Requirements Toolbox)。

要将测试用例、测试套件或测试文件链接到需求：

对于相应的 API，分别请参阅 sltest.testmanager.TestFile、sltest.testmanager.TestSuite 或 sltest.testmanager.TestCase 的 Requirements 属性。

RoadRunner

本节仅适用于 RoadRunner 自动驾驶测试用例。

控制台模式 - 控制台模式是否打开或关闭。如果选中该复选框，则控制台模式将打开，并且仿真运行时不会显示 RoadRunner 用户界面。使用控制台模式在非图形环境中运行 RoadRunner 测试，或者如果您不需要在运行时查看仿真。

强制关闭调速 - 步调是否开启。清除此复选框可以打开节奏，让您可以更改 RoadRunner 场景仿真运行的速度。如果选中该复选框，则会关闭步调，并且您将无法控制 RoadRunner 仿真的速度。

RoadRunner 场景 - 预配置的 RoadRunner 场景文件的完整路径。该文件通常存储在 RoadRunner 工程文件夹中的 Scenarios 文件夹中。

覆盖 RoadRunner 设置 - RoadRunner 测试用例是否在测试执行期间覆盖首选路径设置，或者使用使用 roadrunnerSetup (RoadRunner) 定义的首选路径设置。选中此复选框可以覆盖首选路径设置。

RoadRunner 工程文件夹 - RoadRunner 工程文件夹的完整路径。当您选择覆盖 RoadRunner 设置时会出现此字段。

RoadRunner 安装文件夹 - 安装 RoadRunner 应用程序可执行文件的文件夹的完整路径。当您选择覆盖 RoadRunner 设置时会出现此字段。

在测系统

在在测系统部分中指定您想要测试的模型。要使用当前活动的 Simulink 窗口中打开的模型，点击使用当前模型按钮 。

在在测系统部分中指定新模型可能会导致模型信息过时。要更新模型测试框架、Signal Editor 场景和可用配置集，点击刷新按钮 。

对于 RoadRunner 测试用例，您可以在测系统部分指定模型，该模型设置为正在测试的 RoadRunner 场景中参与者的行为。

对于相应的 API，请参阅 setProperty 的 Model 名称-参量对。

仿真 1 和仿真 2

这些部分出现在等效性测试用例中。使用它们来指定您想要比较的两个仿真的详细信息。在仿真 1 下输入在测系统、测试框架（如果适用）和仿真设置覆盖。然后，您可以点击仿真 2 下的从仿真 1 复制设置以使用第二组仿真设置的起点。您不能在单个等效性测试用例中比较两个以上的模型。

为了通过测试，仿真 1 和仿真 2 必须记录相同的信号。

使用这些部分与等效性准则部分来定义测试用例的前提。有关等价性测试的示例，请参阅 背对背等效性测试。

对于相应的 API，请参阅 setProperty 的 SimulationIndex 名称-参量对。

参数覆盖

在测试用例中指定参数值以覆盖模型工作区、数据字典、基础工作区或模型引用层次结构中的参数值。参数被分组为集合。使用集合或参数旁边的复选框来打开或关闭参数集和单个参数覆盖。要复制单个参数或参数集并将其粘贴到另一个参数集中，请选择该参数并右键点击以从上下文菜单中使用复制和粘贴。

有关使用参数覆盖的示例，请参阅 在测试用例中覆盖模型参数。有关相应的 API，请参阅 sltest.testmanager.ParameterOverride 类以及 setProperty 方法的 OverrideStartTime、OverrideStopTime、OverrideInitialState、OverrideModelOutputSettings 和 ConfigSetOverrideSetting 名称-参量对。

回调

输入

测试用例可以使用来自以下来源的输入数据：

要将输入数据包含在测试结果集中，请选择在测试结果中包含输入数据。

如果您输入数据的时间区间短于模型仿真时间，您可以通过选择在最后一个时间点停止仿真将仿真限制在输入数据指定的时间内。

有关测试输入的更多信息，请参阅 Test 创作：输入页面。

仿真输出

使用仿真输出部分将信号输出添加到您的测试结果中。将模型或测试框架中记录的信号添加为仿真输出后，它们就会出现在结果中。然后您就可以绘制它们了。添加单个信号来记录和绘制或者添加信号集。

记录的信号 - 在记录的信号子部分中，点击添加。按照用户界面进行操作。

要将记录的信号集复制到同一测试文件或不同测试文件中的另一个测试用例，请选择记录的信号中的信号集，右键点击以显示上下文菜单，然后点击复制。然后，在目标测试用例中，选择记录的信号中的信号集，右键点击该信号，然后点击粘贴。您可以一次复制并粘贴多个记录信号集。

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

其他输出 - 使用其他输出子部分中的选项将状态、最终状态、模型输出值、数据存储变量和信号记录值添加到测试结果中。要选择其中一个或多个选项，点击覆盖模型设置。

有关更多信息，请参阅在测试用例中捕获仿真数据。对于相应的 API，请参阅 setProperty 的 OverrideModelOutputSettings 名称-参量对。

输出触发 - 使用输出触发子部分指定何时根据条件或持续时间开始和停止信号记录。请注意，如果测试在触发时通过，则测试通过，即使测试在触发时间之外失败。

开始记录选项包括：

停止记录选项包括：

将时间归零 - 将记录开始时间移至零。例如，如果记录从时间 2 开始，则选择此选项会将所有时间向后移动 2 秒。

符号 - 点击添加将模型中的信号映射到符号名称。您可以在触发条件中使用该符号。有关使用和映射符号的信息，请参阅 使用时序评估来评估时序逻辑

配置设置覆盖

对于测试用例，您可以指定与模型中的设置不同的配置设置。通过在测试用例中设置配置设置，您可以尝试测试用例的不同配置，而无需修改模型。配置设置覆盖选项包括：

对于相应的 API，请参阅 setProperty 的 ConfigSetOverrideSetting、ConfigSetName、ConfigSetVarName、ConfigSetFileLocation 和 ConfigSetOverrideSetting 名称-参量对。

故障设置

如果您有 Simulink Fault Analyzer™，请使用此部分将故障添加到测试用例中并将其注入到您的模型中，创建故障集，从被测模型中检索故障，并指定用于仿真的活动故障。有关更多信息，请参阅使用 Simulink 测试管理器编写并运行注入故障的测试。要了解有关使用 Simulink Fault Analyzer 向模型添加故障的更多信息，请参阅 Define and Model Faults (Simulink Fault Analyzer)。

有关相应的 API，请参阅 sltest.testmanager.FaultSet 和 sltest.testmanager.SpecifiedFault 类、sltest.testmanager.TestCase 类的 addFaultSet 和 getFaultSets 方法、sltest.testmanager.refreshFaults 函数以及 sltest.testmanager.TestIterationResult 类的 FaultSet 属性。

序列图评估

自 R2025a 起

使用此部分向仿真或基线测试中添加序列图。当您在测试中添加序列图时，该序列图会在测试执行过程中进行仿真。要在测试用例中添加序列图，请在序列图评估部分中选择一个序列图。有关序列图的更多信息，请参阅 Describe System Behavior Using Sequence Diagrams (System Composer)。

您可以通过测试管理器的在测系统部分选择一个架构模型或带有定义序列图的测试框架。请参阅在测系统。

要程序化地将序列图添加到测试用例中，请使用 setProperty 方法的 sltest.testmanager.TestCase，并将 SequenceDiagram 属性设置为序列图。

基线准则

基线准则部分出现在基线测试用例中。当执行基线测试用例时，测试管理器会从模型中标记为记录的信号中捕获信号数据，并将其与基线数据进行比较。为了比较多个模型的测试结果，可以将各个模型的测试结果与相同的基线数据进行比较。

等效性准则

本节出现在等效性测试用例中。等效性准则是在仿真 1 和仿真 2 中进行比较的一组信号数据。指定容差来规范测试的通过-失败准则。您可以指定信号的绝对、相对、超前和滞后容差。

要指定容差，首先点击捕获以在仿真 1 中运行在测系统，并将标记为记录的信号添加到表中。在表中指定容差。

捕获信号后，您可以从表中选择信号来缩小结果范围。如果您没有选择等效性准则下的信号，运行测试用例会比较仿真 1 和仿真 2 中记录的所有信号。

有关等价性测试用例的示例，请参阅 背对背等效性测试。

对应 API 请参阅 captureEquivalenceCriteria 方法。

迭代

使用迭代来重复具有不同参数值、配置集、变体配置或输入数据的测试。

要从定义的参数集、信号编辑器场景、测试序列场景、外部数据文件或使用配置集或变体配置的迭代创建迭代，请使用表迭代。您可以在表的列中选择每次迭代要使用的配置。

要从可用的测试用例元素创建一组自定义迭代，请向测试用例添加 MATLAB 脚本迭代。

要运行迭代而不为每次迭代重新编译模型，请启用在快速重启模式下运行测试迭代。选中后，此选项可减少仿真时间。

有关测试迭代的更多信息，包括在脚本迭代中使用预定义变量，请参阅 测试迭代。有关快速重启的更多信息，请参阅 How Fast Restart Improves Iterative Simulations。

有关相应的 API，请参阅 sltest.testmanager.TestIteration。

逻辑和时序评估

使用基于表单的编辑器创建时序评估，该编辑器会提示您输入条件、事件、信号值、延迟和响应。当您折叠各个元素时，编辑器会显示一个可读的声明来总结评估。有关更多信息，请参阅 使用时序评估来评估时序逻辑 和 逻辑和时序评估语法。

要复制和粘贴评估或符号，请选择评估或符号并右键点击以显示上下文菜单。您可以选择单个评估或符号，也可以选择多个评估或符号。或者，要复制或粘贴选定的评估或符号，请使用 Ctrl+C 或 Ctrl+V。粘贴评估会将其添加到当前测试用例中评估列表的末尾。您也可以粘贴到不同的测试用例。评估及其符号名称将更改为粘贴的评估中的默认名称。您还可以使用上下文菜单删除评估。要删除符号，请使用删除按钮。如果您删除评估或符号，则即使在删除之前复制了它，也无法粘贴它。

自定义准则

本节包含一个嵌入式 MATLAB 编辑器，用于定义测试的自定义通过/失败准则。选择 function customCriteria(test)以在编辑器中启用准则脚本。展开对测试结果执行自定义准则分析以查看可用的预定义变量列表。自定义准则在模型运行时间之外运行；脚本在模型仿真后进行评估。

自定义准则的常见用途包括验证信号特性或验证测试条件。MATLAB 单元测试资格为验证准则提供了一个框架。例如，此自定义准则脚本获取信号 PhiRef 的最后一个值并验证它是否等于 0：

% Get the last value of PhiRef from the dataset Signals_Req1_3
lastValue = test.sltest_simout.get('Signals_Req1_3').get('PhiRef').Values.Data(end);

% Verify that the last value equals 0
test.verifyEqual(lastValue,0);

请参阅使用自定义脚本处理测试结果。有关 MATLAB 单元测试资格的列表，请参阅 验证、断言及其他鉴定一览表。

您还可以在自定义准则部分定义图。请参阅创建、存储和打开 MATLAB 图形。

有关相应的 API，请参阅 sltest.testmanager.CustomCriteria。

覆盖率设置

使用此部分来配置测试文件的覆盖率收集。这些设置从测试文件传播到测试文件中的测试套件和测试用例。您可以关闭测试套件或测试用例的覆盖率收集或一个或多个覆盖率度量，除非您的测试是基于 MATLAB 的 Simulink 测试。

对于基于 MATLAB 的 Simulink 测试，您只能在测试文件级别更改覆盖率设置。如果您更改测试管理器中的覆盖率设置，则更改不会保存到基于 MATLAB 的 Simulink 测试脚本文件中。如果您还在基于 MATLAB 的 Simulink 测试脚本 (sltest.plugins.ModelCoveragePlugin) 文件中或在命令行中使用 .m 覆盖率，则测试管理器将使用测试脚本中的覆盖率设置，而不是测试管理器覆盖率设置。

SIL 或 PIL 模块不支持覆盖率分析。

覆盖率收集选项包括：

有关收集覆盖率的更多信息，请参阅 收集测试覆盖率。有关相应的 API，请参阅 sltest.testmanager.CoverageSettings。

有关覆盖率度量选项的信息，请参阅 模型覆盖率类型 (Simulink Coverage)。

有关基于 MATLAB 的 Simulink 测试的信息，请参阅 在测试管理器中使用基于 MATLAB 的 Simulink 测试。

测试文件选项

测试文件内容

对于基于 MATLAB 的 Simulink 测试，显示定义测试的 M 文件的内容。仅当您打开或创建新的基于 MATLAB 的 Simulink 测试时才会出现此部分。请参阅在测试管理器中使用基于 MATLAB 的 Simulink 测试。