测试步骤

测试步骤(test step)是一种简单操作,通常只执行一条指令。例如,测试步骤可以是读取或写入某个值,也可以执行计算或比较。所有测试步骤均在 Action window(操作窗口) 章节中说明。

期望

在 ecu.test 中,可以为读取测试步骤、计算测试步骤以及作业调用定义期望。

可通过勾选 Expectation(期望) 前的复选框来实现。这样会额外显示两个选项卡 Expectation 和 Options。前者用于指定期望,例如结果应为 0。随后该测试步骤会根据期望是否满足给出 SUCCESS 或 FAILED 评定。

首先必须选择数据类型。支持的数据类型包括 string 和 numeric。此外,还有两个特殊值“signal present”(~Present~)和“signal not present”(~Not Present~)。

说明

并非所有接口都支持这两个特殊值。

在下方的选择字段中,选择一个关系运算符,用于确定读取值与期望值的比较方式。

必须在文本框中输入期望值,其类型必须与所选数据类型一致。

如果将“==”用作关系运算符,还可以为期望值额外指定容差。在容差值下方的选择框中,可以指定容差值应按百分比解释、按绝对值解释,或在比较前将两个值按小数位数进行舍入。随后在相邻字段中输入不带单位的容差值。

如果将选择框从 supported 切换为 manual,或者将数据类型设置为 unspecific,则可以在文本输入字段中使用 Python 表达式指定期望。读取值通过关键字 value 引用。

以下示例有助于理解手动输入:

示例 1: 读取值应大于 5:

value > 5

读取值与期望值进行比较。

示例 2: 读取值应等于 10;另外指定绝对容差 +/-1。

10-1<=value<=10+1

此示例包含容差。系统会计算可能的最小值和最大值。读取值必须大于或等于最小值,并且小于或等于最大值。

示例 3: 读取值应等于 100;另外指定 10% 的容差。

(1-10/100.0)*100<=value<=(1+10/100.0)*100

这里同样会计算最小值和最大值用于比较,但计算时还会考虑容差以百分比给出的事实。

示例 4: 读取值(100.002345)应等于 100.002;仅考虑 3 位小数。

round(value,3) == round(100.002,3)

读取值和参考值都会按指定的小数位进行舍入后再比较。

时间选项

通过时间选项,可以将测试步骤的期望与时间条件结合起来。

../../../_images/Zeitoptionen.png

Wait until true 选项的作用是持续求值指定表达式(字段 Expression),直到其结果符合指定期望。必须在关联文本字段中输入超时值;如果在超时发生前仍未达到期望值,则停止后续处理。在这种情况下,计算测试步骤会给出“FAILED”判定。

True for at least 选项同样会持续重新求值指定表达式。与其他时间选项不同的是,它会检查计算结果在指定时间段内是否始终符合期望值。如果计算结果不符合期望值,则取消处理,并且计算测试步骤给出“FAILED”判定。时间段可在关联文本字段中输入。请注意,给定时间段的处理区间原则上从计算测试步骤启动时开始。

True for at least … within … 选项是前两个时间选项的组合,因此需要两个时间段。其作用是检查计算结果是否在第二个时间段(timeout)内的某个时刻起,至少在第一个时间段(minimum duration)内持续符合期望值。符合状态在超时间隔中的哪个时刻开始并不重要,也不关心此前是否出现过更短的符合时段。表达式在与期望值比较之前会始终重新求值。一旦计算结果已在指定的最短持续时间内保持符合期望值,处理就会停止,并给出“SUCCESS”判定。如果计算结果不符合期望值,且距离超时的剩余时间短于最短持续时间,则处理也会停止,但给出“FAILED”判定。

Only synchronization (no SUCCESS/FAILED) 选项的行为与 Wait until true 完全相同,但不会对测试步骤进行判定。使用该选项,可以优化等待期望出现的时间,而后续可根据该期望是否出现来决定是否需要执行其他测试步骤。

Execute all n iterations 选项仅适用于读取测试步骤和计算测试步骤。此外,只有当该测试步骤位于 Multi-Check(Multi-Check) 测试步骤中时才能启用。可以通过标记为 n 的文本字段定义某个测试步骤仅在特定迭代中求值。例如,这里填写 2,则表示“仅在 Multi-Check 的每第二次迭代中求值该测试步骤”。

说明

如果测试用例(test case)以实时方式执行,则不会解释 Execute all n iterations 选项。在实时模式下,Multi-Check 中的每个测试步骤都会在模型的每一步中求值。

Polling Cycle 设置会影响时间选项 Wait until true、True for at least、True for at least … within … 和 Only synchronisation 的执行。如果启用该选项,则指定的时间段决定表达式求值以及将结果与期望进行比较的时间间隔。如果求值耗时长于指定周期时间,或者未指定周期时间,则会尽可能快速地重复求值。轮询周期的默认值可在测试配置的 Execution 选项卡中,通过 Waiting time after every I/O test step 进行设置,参见 Access test quantities(访问测试量) 一节。

内部 API

在所有使用变量的测试步骤中,都可以访问某些 ecu.test 内部函数。因此,可以查询前一个测试步骤是否被评定为 SUCCESS 或 FAILED,也可以获取当前测试报告文件夹的名称。在测试步骤中通过关键字 api 访问 Internal API。输入该关键字并在后面加上点号后,会弹出一个对话框,提供更多可用项。以下示例中,IF-THEN-ELSE 条件用于判断前一个测试步骤的评定结果:

../../../_images/Packageeditor_Package_1.png

说明

一组 API 命令位于 ecu.test 安装目录中的 Help/api/INTERNAL-API/index.html(Help/api/INTERNAL-API/index.html)。

用户定义的 Python 函数

对于某些测试用例(test case),可能有必要使用自行创建的 Python 脚本。为了方便集成和管理这些脚本,ecu.test 提供了相应接口,参见 User Python library(用户 Python 库) 一节,以及 Extensions(扩展) 章节。