我们都知道实现自动化能够提高测试效率，这是无可争议的，但是实现自动化后如何将结果更好的呈现给执行人员呢？那当然是测试报告了，但是我们怎么样才能将测试过程、测试结果很好的呈现在测试报告中呢？一个好的测试报告对于所有查看测试结果的人来说都是福音，今天我们来介绍下CAPL中常用的测试报告中描述测试过程和结果的函数。
如果你只是想要了解这些函数的用法，直接参考最下面的代码即可；如果你是想详细了解下这块的内容，那你就仔细阅读一下；不过参数存在重复看一个即可，主要区分函数的不同功能。
TestStep
功能：在测试报告中描述测试过程的函数，与测试结果无关
LevelOfDetail：可以用数字来识别此测试步骤的重要性。在测试报告中，可能只显示达到一定重要性的测试步骤。0表示“非常重要”，数字越大表示重要性越低。通常我们使用level 0 - level 3几个级别；当然我们也会使用step1 - step n来描述测试用例的步骤；使用场景不同而已。
Identifier：测试用例步骤
Description：在报告中的详细描述信息，如果需要换行，则可以再描述内容中的任意位置插入“\n”即可，这样在HTML报告中也会进行响应的换行显示；同时该描述中也可以包含类似于print打印信息类似的变量内容，使用方法与C类似，后面会有示例，格式与前面的write使用方法一致。
TestStepPass
功能：在测试报告中描述测试结果的函数，并且只是测试结果为pass，绿色高亮显示在html中
LevelOfDetail：可以用数字来识别此测试步骤的重要性。在测试报告中，可能只显示达到一定重要性的测试步骤。0表示“非常重要”，数字越大表示重要性越低。通常我们使用level 0 - level 3几个级别；当然我们也会使用step1 - step n来描述测试用例的步骤；使用场景不同而已。
Identifier：测试用例步骤
Description：在报告中的详细描述信息，如果需要换行，则可以再描述内容中的任意位置插入“\n”即可，这样在HTML报告中也会进行响应的换行显示；同时该描述中也可以包含类似于print打印信息类似的变量内容，使用方法与C类似，后面会有示例，格式与前面的write使用方法一致。
TestStepFail
功能：在测试报告中描述测试结果的函数，并且只是测试结果为fail，红色高亮显示在html中
LevelOfDetail：可以用数字来识别此测试步骤的重要性。在测试报告中，可能只显示达到一定重要性的测试步骤。0表示“非常重要”，数字越大表示重要性越低。通常我们使用level 0 - level 3几个级别；当然我们也会使用step1 - step n来描述测试用例的步骤；使用场景不同而已。
Identifier：测试用例步骤
Description：在报告中的详细描述信息，如果需要换行，则可以再描述内容中的任意位置插入“\n”即可，这样在HTML报告中也会进行响应的换行显示；同时该描述中也可以包含类似于print打印信息类似的变量内容，使用方法与C类似，后面会有示例，格式与前面的write使用方法一致。
TestStepWarning
功能：在测试报告中描述测试结果的函数，并且只是测试结果为warning，黄色高亮显示在html中
LevelOfDetail：可以用数字来识别此测试步骤的重要性。在测试报告中，可能只显示达到一定重要性的测试步骤。0表示“非常重要”，数字越大表示重要性越低。通常我们使用level 0 - level 3几个级别；当然我们也会使用step1 - step n来描述测试用例的步骤；使用场景不同而已。
Identifier：测试用例步骤
Description：在报告中的详细描述信息，如果需要换行，则可以再描述内容中的任意位置插入“\n”即可，这样在HTML报告中也会进行响应的换行显示；同时该描述中也可以包含类似于print打印信息类似的变量内容，使用方法与C类似，后面会有示例，格式与前面的write使用方法一致。
TestStepInconclusive
功能：描述了一个无法明确标记为通过或失败的测试步骤。这也相应地显示在测试报告中。测试用例的判决在此自动设置为不确定。不常用，大家根据实际需求使用。
LevelOfDetail：可以用数字来识别此测试步骤的重要性。在测试报告中，可能只显示达到一定重要性的测试步骤。0表示“非常重要”，数字越大表示重要性越低。通常我们使用level 0 - level 3几个级别；当然我们也会使用step1 - step n来描述测试用例的步骤；使用场景不同而已。
Identifier：测试用例步骤
Description：在报告中的详细描述信息，如果需要换行，则可以再描述内容中的任意位置插入“\n”即可，这样在HTML报告中也会进行响应的换行显示；同时该描述中也可以包含类似于print打印信息类似的变量内容，使用方法与C类似，后面会有示例，格式与前面的write使用方法一致。
TestStepErrorInTestSystem
功能：描述了在测试系统中导致错误的测试步骤。这也相应地显示在测试报告中。测试用例的判决在此自动设置为测试系统中的错误。不常用，大家根据实际需求使用。
LevelOfDetail：可以用数字来识别此测试步骤的重要性。在测试报告中，可能只显示达到一定重要性的测试步骤。0表示“非常重要”，数字越大表示重要性越低。通常我们使用level 0 - level 3几个级别；当然我们也会使用step1 - step n来描述测试用例的步骤；使用场景不同而已。
Identifier：测试用例步骤
Description：在报告中的详细描述信息，如果需要换行，则可以再描述内容中的任意位置插入“\n”即可，这样在HTML报告中也会进行响应的换行显示；同时该描述中也可以包含类似于print打印信息类似的变量内容，使用方法与C类似，后面会有示例，格式与前面的write使用方法一致。
testcaseConfigure_Testmode()
{
//将测试用例标识设置为“TC 3.12”，并将测试用例标题从
//将“Configure_Testmode”设置为“测试模式配置”
TestCaseTitle("TC 3.12", "Test Mode Configuration");
// add a description text to test case
TestCaseDescription("Test case is used to check the ability of the SUT to switch ");
TestCaseDescription("into the build-in diagnostic and test mode. The test case does ");
TestCaseDescription("not change test settings within the device. ");
TestStep("1.0", "Communication prepared"); // create neutral entry in report file
TestStepPass("2.0", "Request sent to the SUT, sig = 1"); // reporting of passed action
switch(lRet)
{
case 0: // 测试超时, 报告中显示红色fail
TestStepFail("3.1", "WaitForResponse: Expected message did not occur. Timeout.");
break;
case 1: // 测试OK, 报告中高亮显示绿色pass
TestStepPass("3.0", "WaitForResponse: Received message ok.");
break;
default : // 未知错误, 测试用例fail
TestStepFail("3.2", "WaitForResponse: Unknown error occurred.");
break;
}
}
总结起来就是：
TestStep报告一个对结果没有影响的测试步骤。
TestStepPass报告按预期执行的测试步骤。这将相应地显示在测试报告中。
TestStepFail描述了导致错误的测试步骤。这也相应地显示在测试报告中。测试用例的判决在此自动设置为失败。
TestStepWarning描述了一个测试用例，该用例执行时没有出现错误，但其结果可能会在以后导致问题。这在测试报告中得到了适当的表示。
TestStepInconclusive描述了一个无法明确标记为通过或失败的测试步骤。这也相应地显示在测试报告中。测试用例的判决在此自动设置为不确定。
TestStepErrorInTestSystem描述了在测试系统中导致错误的测试步骤。这也相应地显示在测试报告中。测试用例的判决在此自动设置为测试系统中的错误。