sltest.testmanager.TestInput 类

命名空间: sltest.testmanager

添加或修改测试输入

全页展开

描述

sltest.testmanager.TestInput 的实例是信号输入数据集，可以映射以覆盖在测系统中的输入。

sltest.testmanager.TestInput 类是 handle 类。

类属性

HandleCompatible true

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

创建对象

描述

obj = sltest.testmanager.TestCase.addInput 为测试用例对象创建一个 sltest.testmanager.TestInput 对象。

示例

属性

全部展开

`Active` — 已启用指示器
`0` | `1`

指示在测试用例中输入是否设置为覆盖，如果未启用则为 0，如果启用则为 1。

属性：

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

数据类型: logical

`ExcelSpecifications` — Excel 基线文件的工作表和范围信息
1×N 数组

Microsoft^® Excel^® 基线文件的工作表和范围信息，以 1×N 数组返回，其中每行都有一个 Sheet 和 Range 值。按照表所示指定 Range。

指定 Range 的方法描述

指定 `Range` 的方法	描述
`'Corner1:Corner2'` 矩形范围	使用语法 `'Corner1:Corner2'` 指定范围，其中 `Corner1` 和 `Corner2` 是定义区域的两个相对的角。例如，`'D2:H4'` 表示工作表上两个角 `D2` 和 `H4` 之间的 3×5 矩形区域。`'Range'` 名称-值对参量不区分大小写，并使用 Excel A1 引用样式（参阅 Excel 帮助）。示例： `'Range','Corner1:Corner2'`
`''` 未指定或为空	如果未指定，导入函数会自动检测使用的范围。示例： `'Range',''` 注意：使用范围是指电子表格中实际包含数据的矩形部分。导入函数通过修剪不包含数据的前导行和尾随行和列来自动检测使用的范围。仅由空白组成的文本被视为数据，并在使用范围内捕获。
`'Row1:Row2'` 行范围	您可以通过使用 Excel 行指示符指定开始行和结束行来识别范围。然后 `readtable` 会自动检测指定行内使用的列范围。例如，导入函数将范围规范 `'1:7'` 解释为读取第 1 行到第 7 行（包括）中使用的范围内的所有列的指令。示例： `'Range','1:7'`
`'Column1:Column2'` 列范围	您可以通过使用 Excel 列指示符指定开始列和结束列来识别范围。然后 `readtable` 会自动检测指定列中使用的行范围。例如，导入函数将范围规范 `'A:F'` 解释为读取 A 列到 F 列（包括）中所用范围内的所有行的指令。示例： `'Range','A:F'`
`'NamedRange'` Excel 命名范围	在 Excel 中，您可以创建名称来标识电子表格中的范围。例如，您可以选择电子表格的矩形部分并将其命名为 `'myTable'`。如果电子表格中存在这样的命名范围，则导入函数可以使用其名称读取该范围。示例： `'Range','myTable'`

'Corner1:Corner2'

矩形范围

使用语法 'Corner1:Corner2' 指定范围，其中 Corner1 和 Corner2 是定义区域的两个相对的角。例如，'D2:H4' 表示工作表上两个角 D2 和 H4 之间的 3×5 矩形区域。'Range' 名称-值对参量不区分大小写，并使用 Excel A1 引用样式（参阅 Excel 帮助）。

示例： 'Range','Corner1:Corner2'

''

未指定或为空

如果未指定，导入函数会自动检测使用的范围。

示例： 'Range',''

注意：使用范围是指电子表格中实际包含数据的矩形部分。导入函数通过修剪不包含数据的前导行和尾随行和列来自动检测使用的范围。仅由空白组成的文本被视为数据，并在使用范围内捕获。

'Row1:Row2'

行范围

您可以通过使用 Excel 行指示符指定开始行和结束行来识别范围。然后 readtable 会自动检测指定行内使用的列范围。例如，导入函数将范围规范 '1:7' 解释为读取第 1 行到第 7 行（包括）中使用的范围内的所有列的指令。

示例： 'Range','1:7'

'Column1:Column2'

列范围

您可以通过使用 Excel 列指示符指定开始列和结束列来识别范围。然后 readtable 会自动检测指定列中使用的行范围。例如，导入函数将范围规范 'A:F' 解释为读取 A 列到 F 列（包括）中所用范围内的所有行的指令。

示例： 'Range','A:F'

'NamedRange'

Excel 命名范围

在 Excel 中，您可以创建名称来标识电子表格中的范围。例如，您可以选择电子表格的矩形部分并将其命名为 'myTable'。如果电子表格中存在这样的命名范围，则导入函数可以使用其名称读取该范围。

示例： 'Range','myTable'

属性：

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

数据类型: array

`FilePath` — 文件路径
字符向量

测试输入的文件路径，以字符向量形式返回。

示例: 'C:\MATLAB\sltestExampleInputs.xlsx'

属性：

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

数据类型: char

`InputString` — 输入
字符向量

在测试用例执行期间在在测系统的 LoadExternalInput 配置参数中评估的输入，指定为字符向量。

示例: 'Acceleration.getElement(1),Acceleration.getElement(2)'

属性：

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

`Name` — 测试输入名称
字符向量

测试输入的名称，以字符向量形式返回。

示例: 'sltestExampleInputs.xlsx'

属性：

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

数据类型: char

`MappingMode` — 映射测试输入的模式
`0` | `1` | `2` | `3` | `4`

映射测试输入的模式，以与映射模式对应的整数形式返回：

0 - 区模块名称
1 - 模块路径
2 - 信号名称
3 - 端口顺序（索引）
4 - 自定义

有关映射模式的更多信息，请参阅映射根输入端口信号数据。

属性：

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

`MappingStatus` — 输入映射状态
字符向量

映射状态指示输入端口映射是否成功。有关映射状态故障排除的更多信息，请参阅 Understand Mapping Results。

示例: 'Successfully mapped inputs.'

属性：

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

数据类型: char

`CustomFunction` — 自定义映射函数名称
字符向量

用于自定义映射的函数名称，指定为由 'customFunction' 和字符向量组成的逗号分隔的对。如果使用封装好的函数进行自定义映射，则指定名称为 +packageName/functionName，如果路径有多层，则在函数名称上方每层使用加号（例如 +folder/+packageName/functionName）。此参量是可选的，并且仅当 MappingMode 设置为 4 时有效。

示例: 'CustomFunction','mapfcn'

示例: 'CustomFunction','+maps/mapfcn'

`CompileModel` — 用于映射的模型编译
`true` (默认) | `false`

执行输入映射时编译或不编译模型的选项，指定为由 'CompileModel' 和 false 或 true 组成的逗号分隔的对。

示例: 'CompileModel',false

方法

全部展开

公共方法

`addExcelSpecification`	将 Microsoft Excel 表添加到基线准则或测试用例输入
`map`	将测试输入映射到在测系统
`remove`	删除测试输入

示例

全部折叠

添加 Microsoft® Excel® 数据作为输入

此示例使用:

打开实时脚本

此示例显示如何从 Microsoft® Excel® 电子表格添加数据并将其映射到测试用例。仅添加并映射包含数据的两张工作表。

加载示例模型

open_system('slexAutotransRootInportsExample');

创建新的测试文件

tf = sltest.testmanager.TestFile('input_test_file.mldatx');

获取测试套件和测试用例对象

ts = getTestSuites(tf);
tc = getTestCases(ts);

添加示例模型作为在测系统

setProperty(tc,'Model','slexAutotransRootInportsExample');

将 Excel® 数据添加到输入部分并指定要添加的工作表

excelfile = 'sltestExampleInputs.xlsx';
input = addInput(tc,excelfile,'Sheets',["Acceleration","Braking"]);

使用默认映射模式映射工作表的输入信号

map(input(1));
map(input(2));

版本历史记录

在 R2015b 中推出

另请参阅

sltest.testmanager.TestCase | addInput

主题

使用脚本创建并运行测试用例

sltest.testmanager.TestInput 类

描述

类属性

创建对象

描述

属性

Active — 已启用指示器 0 | 1

属性：

ExcelSpecifications — Excel 基线文件的工作表和范围信息 1×N 数组

属性：

FilePath — 文件路径 字符向量

属性：

InputString — 输入 字符向量

属性：

Name — 测试输入名称 字符向量

属性：

MappingMode — 映射测试输入的模式 0 | 1 | 2 | 3 | 4

属性：

MappingStatus — 输入映射状态 字符向量

属性：

CustomFunction — 自定义映射函数名称 字符向量

CompileModel — 用于映射的模型编译 true (默认) | false

方法

公共方法

示例

添加 Microsoft® Excel® 数据作为输入

版本历史记录

另请参阅

主题

`Active` — 已启用指示器
`0` | `1`

`ExcelSpecifications` — Excel 基线文件的工作表和范围信息
1×N 数组

`FilePath` — 文件路径
字符向量

`InputString` — 输入
字符向量

`Name` — 测试输入名称
字符向量

`MappingMode` — 映射测试输入的模式
`0` | `1` | `2` | `3` | `4`

`MappingStatus` — 输入映射状态
字符向量

`CustomFunction` — 自定义映射函数名称
字符向量

`CompileModel` — 用于映射的模型编译
`true` (默认) | `false`