写完前两步测试步骤,现在就该写验证查询的核心代码了。我们先整理整理思路,思考下面两个问题:
1. 数据是否全面?首先打开数据集文件TCTIMES-1.xls,这是我们提前准备好的,其实到了这步再做第二个sheet里的数据集也可以。文件里面有4个员工,其中3个有工时表,Tester Four没有。之所以这样设计数据集文件就是要把没有返回结果的情况也考虑进去;
2. 这里的查询需要有几个检查点呢?我觉得应该是两个。第一个是有没有返回结果;第二个是如果有返回结果,结果是否正确。
这两个问题都得到答案后,开始动手。还是老方法,先写查询的函数,然后把函数放到test case里调用。打开RIDE,右击Pages -> Timesheet.html -> New UserKeyword新建函数,起名Search Timesheet By Employee Name,接受员工姓,员工名,以及期望结果总共三个参数 - ${first},${last},和${expectedTimesheetNum}。先别管${expectedTimesheetNum},看前两个参数。TCTIMES-1.xls文件里员工姓和名是分开的。但是,我搜索的时候是姓和名一起敲进框框里的,后面的验证中也是验证整个名字存不存在,不会把姓和名单独考虑。所以当它们分别传入到函数中时,我先要把俩字符串合成一个:
连接两个字符串的关键字是Catenate,它属于RF自带的类库,有以下几种使用方法:
默认情况下接受两个参数,得到的是“${first} ${last}”,也就是中间会有一个空格。如果加一个参数SEPERATOR就可以自定义中间分隔符。很显然我们这里用的是默认方法,不过一会儿我们就会用到另外的方法。姓和名组成一个字符串后被赋给一个叫${searchkeyword}的变量,我把它定义成了局部变量,没声明在ObjRepository -> timesheet.html里,因为除了这个函数再没有别的地方会用到它了:
有了名字就好办了,接下来在按下图把输入名字的操作写在第二行,把点击查询按钮的操作写在第三行:
可以看到,现在输入到搜索框的内容已经是姓名的整个字符串。注意,在第四行要有一个等待过程,为网页搜索留出时间。有时候网速太慢或内容太多导致搜索时间很长,如果搜索还没完成就开始验证势必会影响结果。
做完这步之后我们开始验证第一个检查点–看有没有返回结果。输入字符串以后如果有匹配的话就应该返回结果了,比如Tester One。我们在火狐浏览器里打开Firebug来看看工时表的xpath有什么变化:
只有关于员工Tester One的两条工时记录代码段还显示出来,别的都不存在了。这样题目就容易了,在输入姓名后,我们让程序检查员工工时代码段的数目和预期结果是不是一样不就得了么?换句话说,就是比较含有该姓名的xpath数量和预期的值是否一样。我们之前已经把预期结果写到了TCTIMES-1.xls的employee sheet里,现在可以用到了。对于Tester One来说,有2条就证明和预期结果一样,测试通过。代码如下第4步到第8步:
第4步没什么可说的,一个小注释,没必要显示在最后报告里,因为我只想告诉自己现在开始执行第一个检查点看看有没有返回结果,仅此而已。
第5步和第6步里出现了三次${locTSTable_Records_EmployeeName},它代表员工工时的xpath。我们先在ObjRepository -> Timesheet.html里创建出来,值是//table/tbody/tr/td[contains(text(),'||EMPLOYEE NAME||')]:
这个变量看起来有点特殊,||EMPLOYEE NAME||不是个定值,是个可替换的字符串,大家可以像理解函数一样理解这个变量,||EMPLOYEE NAME||就相当于变量中的参数。这么写的原因是我们的测试数据里有4位员工,每个员工的工时xpath都不一样,而不一样的地方就是姓名。比如Tester One的xpath是//table/tbody/tr/td[contains(text(),'Tester One')],Tester Two的xpath是//table/tbody/tr/td[contains(text(),'Tester Two')],以此类推。所以我们不能把这个变量写死,要让程序每次执行时都临时把||EMPLOYEE NAME||替换成我们在搜索框中输入的员工姓名。第5步就是在执行替换过程,用到的关键字是Replace String。它接受三个参数 – 要被替换的元素位置,被替换的是什么,以及替换成什么。
替换完了我们就可以数一数总共有多少个了,第6步里使用Get Matching Xpath Count,这是个非常重要的语句,就不说三遍了。它在很多验证的步骤里都出现过,得到的就是在当前页面中有多少个可见的xpath,再赋给另一个局部变量${timesheetCount}。这个关键字接受一个参数,就是某个xpath,直截了当。
写到这里我们应该意识到,在我们的例子中,对于Tester One来说${timesheetCount}应该等于2,而对于Tester Four来说${timesheetCount}应该是0,也就是没有返回任何工时记录。第7步就是执行比较的过程,用到的语句是Should be Equal as Strings。它默认让两个字符串参数进行比较,${timesheetCount}虽然代表一个数量,但其数据类型是字符串。参数${expectedTimesheetsNum}也是个字符串,这就解释了为什么之前我要在数据集中把期望结果那列转换成字符串格式,就是方便在此进行比较。如果你之前写成了numbers的格式那对不起了,您还得在这儿转成字符串格式,否则字符串和numbers强行比较肯定会失败。Should be Equal as Strings返回的是一个true或false的布尔值,如果true就代表测试通过。
测试通过后,第8步在报告里写一个log,告知测试完毕,如果测试通过了这条log会显示出来。这样,第一个检查点的函数我们就写完了。
这篇文章的源代码在[Test9](https://github.com/cslm/cslm.robotframework/tree/master/Test9)中。