当前位置：首页 > news >正文

XML调用 CAPL Test Function

news 2025/8/7 7:06:54

🍅 我是蚂蚁小兵，专注于车载诊断领域，尤其擅长于对CANoe工具的使用
🍅 寻找组织，答疑解惑，摸鱼聊天，博客源码，点击加入👉【相亲相爱一家人】
🍅 玩转CANoe，博客目录大全，点击跳转👉

📘前言

🍅 在做测试用例开发的时候，我们可能期望在执行测试用例之前，做一些变量初始化，复制，文本处理等前瞻性工作，
🍅 有些小伙伴可能想通过on start 和 on prestart 实现，但这是不理智的，在test units and test modules中on start 是不可用的，而 on prestart 初始化变量等是不可靠的。
🍅 所以如果是XML test modules类型的测试用例，想要完成初始化的一些工作，使用XML调用 CAPL Test Function是一个不错的选择

CANoe中XML编程常用语法

📘前言
🌎CAPL Test Function
🌎测试用例1（preparation标签下的无参数调用）
🌎测试用例2（testcase标签下的带参数调用）
🌎测试用例3（completion标签下的带参数调用）
🌎总结

🌎CAPL Test Function

下图是Call CAPL Test Function的Help解释：

1，XML test module 中的XML文件可以调用CAPL中的Test Function，且只能被XML调用。
2，调用capl中的testfunction用capltestfunction标签，且该标签无法独立使用，需被或或标签包含使用。
3，以最简单的例子 <capltestfunction name="test_01" title="call test function : test_01"></capltestfunction>
name的值必须和CAPL中的testfunction 一致。
title 的值可以任意填写
4，testfunction 的函数是没有返回值的。
5，capltestfunction是可以传参调用的，支持的参数有：float|int|string|signal|envvar|sysvar

在这里插入图片描述

🌎测试用例1（preparation标签下的无参数调用）

1️⃣ 如下图的CAPL界面，创建了一个testfunction test_01()

在这里插入图片描述

2️⃣ 创建的xml文件如下图，通过 capltestfunction 标签调用 capl脚本中创建的 test_01（）函数

在这里插入图片描述

<testmodule title="XML Test Module" version="1.1"><description>XML Test Module</description><preparation><initialize title="Initialize test module" wait="200"><!-- <envvar name="">1</envvar> --></initialize><capltestfunction name="test_01" title="call test function : test_01"></capltestfunction></preparation><testgroup title="UDS">			<capltestcase name="TC_0001" /></testgroup><completion><initialize title="Adding testreport info" wait="500"><!-- <envvar name="">0</envvar> --></initialize></completion>
</testmodule>

2️⃣ 例如，新建一个xml文件，命名为test.xml ,写入如下代码，新建一个XML Test Modele 节点，测试下，观察测试报告的输出

<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>
<testmodule title="testmodel_tag" version="1.13"></testmodule>

3️⃣ 根据输出报告可以看出 title=“testmodel_tag” ，输出的报告名字就是testmodel_tag

在这里插入图片描述

3️⃣ 创建的Test Module测试节点。然后执行测试，根据结果可以看到XML成功调用了函数test_01

🌎测试用例2（testcase标签下的带参数调用）

1️⃣ 如下图的CAPL界面，创建了一个testfunction test_02(int s)

2️⃣通过 testcase 标签调用 capl脚本中创建的 test_02（）函数

<testmodule title="XML Test Module" version="1.1"><description>XML Test Module</description><preparation><initialize title="Initialize test module" wait="200"><!-- <envvar name="">1</envvar> --></initialize><capltestfunction name="test_01" title="preparation标签下的无参数调用"></capltestfunction></preparation><testgroup title="UDS">			<capltestcase name="TC_0001" /><testcase title="TC_0002" ident="TC_0002">	<capltestfunction name="test_02" title="testcase标签下的带参数调用"><caplparam name="para1" type="int">0x01</caplparam></capltestfunction></testcase></testgroup><completion><initialize title="Adding testreport info" wait="500"><!-- <envvar name="">0</envvar> --></initialize></completion>
</testmodule>

3️⃣ 输出结果，根据结果可以看到XML成功调用了函数test_02

🌎测试用例3（completion标签下的带参数调用）

1️⃣ 如下图的CAPL界面，创建了一个testfunction test_03(char s[])

/*@!Encoding:936*/
testfunction test_01()
{write("***************XML调用了 testfunction test_01***************");
}testfunction test_02(int s)
{write("***************XML调用了 testfunction test_02 ，接收参数：%d***************",s);
}testfunction test_03(char s[])
{write("***************XML调用了 testfunction test_03 ，接收参数：%s***************",s);
}testcase TC_0001()
{}

2️⃣通过 completion 标签调用 capl脚本中创建的 test_03（）函数

<testmodule title="XML Test Module" version="1.1"><description>XML Test Module</description><preparation><capltestfunction name="test_01" title="preparation标签下的无参数调用"></capltestfunction></preparation><testgroup title="UDS">			<capltestcase name="TC_0001" /><testcase title="TC_0002" ident="TC_0002">	<capltestfunction name="test_02" title="testcase标签下的带参数调用"><caplparam name="para1" type="int">0x01</caplparam></capltestfunction></testcase></testgroup><completion><capltestfunction name="test_03" title="completion标签下的带参数调用"><caplparam name="para1" type="string">hello</caplparam></capltestfunction></completion>
</testmodule>