使用API造数据操作手册

1、技术研发部2015年6月3日使用API造数据操作手册2页 介绍u 框架使用java的URLConnection方法建立与http的通信，通过向服务器发送get或post请求，获得服务器的responseu 提高测试效率通过此方式完成初检通过的交易，执行时间为30秒左右。相比手工执行10分钟，UI自动化执行2分钟更提高了测试效率。QA测试人员使用API用例造数据已累计节省了数百个小时的工作量。u 使用范围我们不止使用API用例造数据，目前还逐步覆盖各个系统的接口测试。通过夜间批量执行用例得到接口用例的测试结果。3页 目录 环境配置（jdk，eclipse等） 工程配置（环境、数据库等） 构造数据

2、 执行4页 环境配置u安装eclipse，jdk，工程等Eclipse和jdk在 svn:/12/pahaoche/QA/02测试代码/自动化测试代码/tools/eclipse-standard-luna-R-win32-x86_64.zipjdk-7u65-windows-x64.exe自动化用例工程可通过svn导入，或者svn下载后导入已存在的工程(如果使用jdk1.6，需要在eclipse中重新执行下使用的jdk) svn:/12/pahaoche/QA/02测试代码/自动化测试代码/APIAutomationu配置环境变量我的电脑（单击

3、右键）-属性-高级（选项卡）-环境变量。在“系统变量”里-新建变量名JAVA_HOME变量值C:Program FilesJavajdk1.7.0_65变量名CLASSPATH变量值%JAVA_HOME%libdt.jar;%JAVA_HOME%libtools.jar;在“系统变量”里-选中Path-编辑变量值最前面加入%JAVA_HOME%bin;确定退出。用cmd新开一个控制台输入javac -vertion即可看到编译器版本5页 目录 环境配置（jdk，eclipse等） 工程配置（环境、数据库等） 构造数据 执行6页 工程配置u配置perties#夜间批量执行用例

4、所配置的需要执行的文件夹，造数据时无视casePath = D:workspaceAPIAutomationcase网站#用例执行的环境配置，这个配置和environment和dbconfig的配置保持一致environment=UAT#用例执行时的循环次数，如设置10，则循环执行10次loopCount = 1#最新检测版本，目前的版本号是8detectionVersion = 8#当需要用到代理时，代理的配置信息。注意当environment的url配置的是域名并且needProxy=y，则会通过代#理访问域名。如果environment的url配置是ip，则不通过代理访问。#推荐使用ip

5、配置url，避免使用代理出现的异常needProxy = yProxyIP = 15ProxyPort = 8080#夜间批量执行用例的是否发邮件的配置，造数据时无视sendMail = n# 执行移动竞价接口用例时用到的版本号，造数据时无视jpVersion=3.3#Proxy List 代理可用的列表信息#15:8080#14:8080#25:8080#24:8080#19:8080#18:8080#17:8080#10.37.84

6、.116:80807页 工程配置u配置Environment.xmlenvironment中就是配置环境的url，用户名，密码等信息。1.可以看到config中的environment配置UAT则读取UAT节点下的配置信息，配置ST1则读取ST1节点下的配置信息。2.门店中需要配置门店的province，city和orgcode，具体可通过以下查询语句：select a.parent_id,a.area_id,b.dept_id from t_ht_area a,t_ht_department b where a.area_id=b.area_id and = 南京市 and a

7、.delflag=0 and b.delflag=0 and b.status=13.检测系统的用户推荐大家使用自己的检测用户来做，如果都使用同一个用户，会出现该设备在其他终端登录的信息，无法继续执行。8页 工程配置u配置dbConfig.xmlDbconfig中就是配置数据库的driver，url，用户名，密码等信息。可以看到config中的environment配置UAT则读取UAT节点下的配置信息，配置ST1则读取ST1节点下的配置信息。9页 工程配置u配置GlobalVariables.xml这里配置的是某些用例中需要的变量中的实际值，比如执行车辆上架的用例，acutionTime中写

8、21:10，则用例会根据这个值把车辆上架到结束时间是这个点的场次中。目前的配置有21:10 场次结束时间，用在车辆上架的用例中。20150525020052 交易号10000 竞拍出价金额10000 重新出售的一口价金额10页 目录 环境配置（jdk，eclipse等） 工程配置（环境、数据库等） 构造数据 执行11页 构造数据u用例组成用例由excel编写Call：可以调用其他用例，比如流程有a，b，c，d，e，f这些操作构成，如果已经有一个API的用例是a，b，c的操作，我可以call这个用例，然后接着写d，e，f的操作。这样这个用例就包括了所有的操作。Transaction：写步骤用到的

9、transaction的文件路径。Transaction中则定义了这一步要执行的url或接口的定义，输入等内容。businessDataKey：所用到参数的名字，这个名字的值从businessDataValue中获得。用在transaction中get或post的数据中businessDataValue：businessDataKey的值，可以指定具体的值，也可以根据提供的函数获得值，目前提供的函数有getRandomData(String wordLength,String wordType)，getSystemDate(String dateFormat)，getMobilePhoneNo

10、()，getLicensePlateNo(String province)， getRandomDataWithPrefix(String wordLength,String wordType,String prefix)等方法checkDataKey：这里是需要校验的内容的名字，名字与在transaction中定义的需要校验的内容的名字一致。checkDataExpectValue：需要校验内容的预期值。Transaction由我们维护，造数据时不用考虑transaction的修改。这里只是简单介绍下。12页 构造数据u造数据用例列表目前QA同事在造数据经常使用的用例如下：case门店_B2

11、B_初检通过.xlsxcase门店_C2B_初检通过.xlsxcaseB2B_车辆上架.xlsxcaseC2B_车辆上架.xlsxcaseB2B_车辆上架_新增发布场次.xlsxcaseC2B_车辆上架_新增发布场次.xlsxcase检测车辆星级 目录下的不同星级不同分数的车辆（状态到初检通过）case检测车辆等级 目录下的不同等级的车辆（状态到初检通过）case竞价B2B_竞拍出价.xlsxcase竞价C2B_竞拍出价.xlsxcase门店重新出售.xlsx下面根据经常使用的这些用例说明一下如何造成自己需要的数据13页 构造数据u编辑用例说明一下经常需要编辑的字段1.配置预约信息为自己的手机

12、号?用例中的mobile，用例中手机号是通过方法help_mobile_getMobilePhoneNo()生成的随机手机号，手机号码都是不在中国手机号段的号码。把这个地方修改成自己的手机号。2.配置B2B预约信息中的4S店名用例中的shopName，目前shopName是random，随机取的名字，如果要指定把random修改成4s店名。3.配置车辆的品牌，车系，生产年份用例中的brandName，vehicleModelName，yearGenerates目前都是随机，指定成具体的名字。4.配置C2B车辆和新增的场次类型用例中的vendueCode 01 常规场 02 快速场 03 TSI

13、场 04 其他。B2B都是05不用修改。5.配置是否可认证用例中的qrCode，Y是可认证，N是不认证6.配置单车时长用例中的perVehicleTime为单车时长，单位为分钟，修改成想要的时间。14页 构造数据u编辑用例7.配置指定的场次时间在车辆上架_新增发布场次用例中，addType是nearest则会自动新建比当前时间晚5分钟的最近的一个在场次列表中的场次。如果addType是specified，则用例中的acutionTime输入想要增加的场次时间。8.配置多辆车上同一场次车辆上架的用例可以设置loopCount，反复执行这个用例，达到多辆车上同一场次。需要在GlobalVariab

14、les.xml中配置21:10，注意这个场次必须是已创建或已开始。如果场次不存在会报错。9.配置竞价的交易号和出价金额场次已发布，可以竞价。如果需要对车辆进行出价，修改GlobalVariables.xml 20150525020052这个是要出价的车辆的交易号10000这个是出价金额如果要多人对车辆进行出价，则修改Environment.xml文件中的Auction节点下的用户名密码再次执行。10.配置一口价的金额重新出售的用例是通过sql语句查找符合条件的可重新出售的交易号进行重新出售到一口价场次中，用例不用特殊修改，配置下GlobalVariables.xml 10000这个是一口价的金

15、额。15页 构造数据u编辑用例11.配置车辆图片用例在执行过程中，用到detection目录下的CERTIFICATE，VEHICLE_FACADE，EVALUATION文件夹的图片作为车辆的行驶证，外观照，损失点的图片。如果想要用自己的图片作为车辆检测报告的图片显示，可以替换这些目录下的图片，但是保证图片名称与原始图片名称一致，否则上传后无法显示图片。12.配置损失点损伤点的配置是根据用例中detectionItemsFilePath指定的文件执行的。在detection目录下DetectionItemsAll.txt为所有损伤点的列表。 DetectionItemsConfig.txt是星

16、级1评分57这个用例所用到的损伤点的配置，每一项损伤项一行，如这项有多处损伤点，则损伤明细用分号隔开16页 目录 环境配置（jdk，eclipse等） 工程配置（环境、数据库等） 构造数据 执行17页 执行u执行用例Eclipse点击Run-Run Configuration，在Java Application中New一个，Project选择APIAutomation，Main class输入com.pahaoche.driver.TestDriver，Arguments中输入debugTC=$selected_resource_loc“然后右键选中要执行的用例，点击Run As-Run Co

17、nfiguration，选择APIAutomation执行。18页 执行u执行用例Eclipse控制台会输入日志，从日志中可以看到执行结果是否成功，成功的交易号信息等。INFO 2015 06 02 10:05:51,137 -Execute Transaction : 综合查询INFO 2015 06 02 10:05:51,137 -Execute step: 综合查询DEBUG 2015 06 02 10:05:51,137 -replace $Stores.url$ to 1:8205DEBUG 2015 06 02 10:05:51,137 -rep

18、lace $SCode$ to 05740031DEBUG 2015 06 02 10:05:51,137 -replace $SCode$ to 05740031DEBUG 2015 06 02 10:05:51,137 -replace !transNo! to 20150602030186DEBUG 2015 06 02 10:05:51,137 -URL is : 1:8205/md/complexInfo.doDEBUG 2015 06 02 10:05:51,137 -PostData is : method=l

19、ist&page=1&rp=20&sortname=&sortorder=&query=name: s_transNo, value: , name: s_plateNo, value: , name: s_agentName, value: , name: s_sellerName, value: , name: s_agentPhone, value: , name: s_sellerPhone, value: , name: s_transStatus, value: , name: s_orgCode, value: 05740031, name

20、: s_beginDate, value: , name: s_endDate, value: , name: s_modifyOrg, value: , name: s_modifyUser, value: , name: s_sellerType, value: 01, name: s_vendueAuctionType, value: &qtype=&s_transNo=20150602030186&s_plateNo=&s_agentName=&s_sellerName=&s_agentPhone=&s_sellerPhone=&s_transStatus=&s_orgCode=05740031&s_beginDate=&s_endDate=&s_modifyOrg=&s_modifyUser=&s_sellerType=&s_vendueAuctionType=DEBUG 2015 06 02 10:05:51,137 -C