使用API造數(shù)據(jù)操作手冊

1、技術(shù)研發(fā)部2015年6月3日使用API造數(shù)據(jù)操作手冊2頁 介紹u 框架使用java的URLConnection方法建立與http的通信，通過向服務(wù)器發(fā)送get或post請求，獲得服務(wù)器的responseu 提高測試效率通過此方式完成初檢通過的交易，執(zhí)行時間為30秒左右。相比手工執(zhí)行10分鐘，UI自動化執(zhí)行2分鐘更提高了測試效率。QA測試人員使用API用例造數(shù)據(jù)已累計節(jié)省了數(shù)百個小時的工作量。u 使用范圍我們不止使用API用例造數(shù)據(jù)，目前還逐步覆蓋各個系統(tǒng)的接口測試。通過夜間批量執(zhí)行用例得到接口用例的測試結(jié)果。3頁 目錄 環(huán)境配置（jdk，eclipse等） 工程配置（環(huán)境、數(shù)據(jù)庫等） 構(gòu)造數(shù)據(jù)

2、 執(zhí)行4頁 環(huán)境配置u安裝eclipse，jdk，工程等Eclipse和jdk在 svn:/12/pahaoche/QA/02測試代碼/自動化測試代碼/tools/eclipse-standard-luna-R-win32-x86_64.zipjdk-7u65-windows-x64.exe自動化用例工程可通過svn導(dǎo)入，或者svn下載后導(dǎo)入已存在的工程(如果使用jdk1.6，需要在eclipse中重新執(zhí)行下使用的jdk) svn:/12/pahaoche/QA/02測試代碼/自動化測試代碼/APIAutomationu配置環(huán)境變量我的電腦（單擊

3、右鍵）-屬性-高級（選項卡）-環(huán)境變量。在“系統(tǒng)變量”里-新建變量名JAVA_HOME變量值C:Program FilesJavajdk1.7.0_65變量名CLASSPATH變量值%JAVA_HOME%libdt.jar;%JAVA_HOME%libtools.jar;在“系統(tǒng)變量”里-選中Path-編輯變量值最前面加入%JAVA_HOME%bin;確定退出。用cmd新開一個控制臺輸入javac -vertion即可看到編譯器版本5頁 目錄 環(huán)境配置（jdk，eclipse等） 工程配置（環(huán)境、數(shù)據(jù)庫等） 構(gòu)造數(shù)據(jù) 執(zhí)行6頁 工程配置u配置perties#夜間批量執(zhí)行用例

4、所配置的需要執(zhí)行的文件夾，造數(shù)據(jù)時無視casePath = D:workspaceAPIAutomationcase網(wǎng)站#用例執(zhí)行的環(huán)境配置，這個配置和environment和dbconfig的配置保持一致environment=UAT#用例執(zhí)行時的循環(huán)次數(shù)，如設(shè)置10，則循環(huán)執(zhí)行10次loopCount = 1#最新檢測版本，目前的版本號是8detectionVersion = 8#當(dāng)需要用到代理時，代理的配置信息。注意當(dāng)environment的url配置的是域名并且needProxy=y，則會通過代#理訪問域名。如果environment的url配置是ip，則不通過代理訪問。#推薦使用ip

5、配置url，避免使用代理出現(xiàn)的異常needProxy = yProxyIP = 15ProxyPort = 8080#夜間批量執(zhí)行用例的是否發(fā)郵件的配置，造數(shù)據(jù)時無視sendMail = n# 執(zhí)行移動競價接口用例時用到的版本號，造數(shù)據(jù)時無視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中就是配置環(huán)境的url，用戶名，密碼等信息。1.可以看到config中的environment配置UAT則讀取UAT節(jié)點下的配置信息，配置ST1則讀取ST1節(jié)點下的配置信息。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.檢測系統(tǒng)的用戶推薦大家使用自己的檢測用戶來做，如果都使用同一個用戶，會出現(xiàn)該設(shè)備在其他終端登錄的信息，無法繼續(xù)執(zhí)行。8頁 工程配置u配置dbConfig.xmlDbconfig中就是配置數(shù)據(jù)庫的driver，url，用戶名，密碼等信息?？梢钥吹絚onfig中的environment配置UAT則讀取UAT節(jié)點下的配置信息，配置ST1則讀取ST1節(jié)點下的配置信息。9頁 工程配置u配置GlobalVariables.xml這里配置的是某些用例中需要的變量中的實際值，比如執(zhí)行車輛上架的用例，acutionTime中寫

8、21:10，則用例會根據(jù)這個值把車輛上架到結(jié)束時間是這個點的場次中。目前的配置有21:10 場次結(jié)束時間，用在車輛上架的用例中。20150525020052 交易號10000 競拍出價金額10000 重新出售的一口價金額10頁 目錄 環(huán)境配置（jdk，eclipse等） 工程配置（環(huán)境、數(shù)據(jù)庫等） 構(gòu)造數(shù)據(jù) 執(zhí)行11頁 構(gòu)造數(shù)據(jù)u用例組成用例由excel編寫Call：可以調(diào)用其他用例，比如流程有a，b，c，d，e，f這些操作構(gòu)成，如果已經(jīng)有一個API的用例是a，b，c的操作，我可以call這個用例，然后接著寫d，e，f的操作。這樣這個用例就包括了所有的操作。Transaction：寫步驟用到的

9、transaction的文件路徑。Transaction中則定義了這一步要執(zhí)行的url或接口的定義，輸入等內(nèi)容。businessDataKey：所用到參數(shù)的名字，這個名字的值從businessDataValue中獲得。用在transaction中g(shù)et或post的數(shù)據(jù)中businessDataValue：businessDataKey的值，可以指定具體的值，也可以根據(jù)提供的函數(shù)獲得值，目前提供的函數(shù)有g(shù)etRandomData(String wordLength,String wordType)，getSystemDate(String dateFormat)，getMobilePhoneNo

10、()，getLicensePlateNo(String province)， getRandomDataWithPrefix(String wordLength,String wordType,String prefix)等方法checkDataKey：這里是需要校驗的內(nèi)容的名字，名字與在transaction中定義的需要校驗的內(nèi)容的名字一致。checkDataExpectValue：需要校驗內(nèi)容的預(yù)期值。Transaction由我們維護，造數(shù)據(jù)時不用考慮transaction的修改。這里只是簡單介紹下。12頁 構(gòu)造數(shù)據(jù)u造數(shù)據(jù)用例列表目前QA同事在造數(shù)據(jù)經(jīng)常使用的用例如下：case門店_B2

11、B_初檢通過.xlsxcase門店_C2B_初檢通過.xlsxcaseB2B_車輛上架.xlsxcaseC2B_車輛上架.xlsxcaseB2B_車輛上架_新增發(fā)布場次.xlsxcaseC2B_車輛上架_新增發(fā)布場次.xlsxcase檢測車輛星級 目錄下的不同星級不同分數(shù)的車輛（狀態(tài)到初檢通過）case檢測車輛等級 目錄下的不同等級的車輛（狀態(tài)到初檢通過）case競價B2B_競拍出價.xlsxcase競價C2B_競拍出價.xlsxcase門店重新出售.xlsx下面根據(jù)經(jīng)常使用的這些用例說明一下如何造成自己需要的數(shù)據(jù)13頁 構(gòu)造數(shù)據(jù)u編輯用例說明一下經(jīng)常需要編輯的字段1.配置預(yù)約信息為自己的手機

12、號?用例中的mobile，用例中手機號是通過方法help_mobile_getMobilePhoneNo()生成的隨機手機號，手機號碼都是不在中國手機號段的號碼。把這個地方修改成自己的手機號。2.配置B2B預(yù)約信息中的4S店名用例中的shopName，目前shopName是random，隨機取的名字，如果要指定把random修改成4s店名。3.配置車輛的品牌，車系，生產(chǎn)年份用例中的brandName，vehicleModelName，yearGenerates目前都是隨機，指定成具體的名字。4.配置C2B車輛和新增的場次類型用例中的vendueCode 01 常規(guī)場 02 快速場 03 TSI

13、場 04 其他。B2B都是05不用修改。5.配置是否可認證用例中的qrCode，Y是可認證，N是不認證6.配置單車時長用例中的perVehicleTime為單車時長，單位為分鐘，修改成想要的時間。14頁 構(gòu)造數(shù)據(jù)u編輯用例7.配置指定的場次時間在車輛上架_新增發(fā)布場次用例中，addType是nearest則會自動新建比當(dāng)前時間晚5分鐘的最近的一個在場次列表中的場次。如果addType是specified，則用例中的acutionTime輸入想要增加的場次時間。8.配置多輛車上同一場次車輛上架的用例可以設(shè)置loopCount，反復(fù)執(zhí)行這個用例，達到多輛車上同一場次。需要在GlobalVariab

14、les.xml中配置21:10，注意這個場次必須是已創(chuàng)建或已開始。如果場次不存在會報錯。9.配置競價的交易號和出價金額場次已發(fā)布，可以競價。如果需要對車輛進行出價，修改GlobalVariables.xml 20150525020052這個是要出價的車輛的交易號10000這個是出價金額如果要多人對車輛進行出價，則修改Environment.xml文件中的Auction節(jié)點下的用戶名密碼再次執(zhí)行。10.配置一口價的金額重新出售的用例是通過sql語句查找符合條件的可重新出售的交易號進行重新出售到一口價場次中，用例不用特殊修改，配置下GlobalVariables.xml 10000這個是一口價的金

15、額。15頁 構(gòu)造數(shù)據(jù)u編輯用例11.配置車輛圖片用例在執(zhí)行過程中，用到detection目錄下的CERTIFICATE，VEHICLE_FACADE，EVALUATION文件夾的圖片作為車輛的行駛證，外觀照，損失點的圖片。如果想要用自己的圖片作為車輛檢測報告的圖片顯示，可以替換這些目錄下的圖片，但是保證圖片名稱與原始圖片名稱一致，否則上傳后無法顯示圖片。12.配置損失點損傷點的配置是根據(jù)用例中detectionItemsFilePath指定的文件執(zhí)行的。在detection目錄下DetectionItemsAll.txt為所有損傷點的列表。 DetectionItemsConfig.txt是星

16、級1評分57這個用例所用到的損傷點的配置，每一項損傷項一行，如這項有多處損傷點，則損傷明細用分號隔開16頁 目錄 環(huán)境配置（jdk，eclipse等） 工程配置（環(huán)境、數(shù)據(jù)庫等） 構(gòu)造數(shù)據(jù) 執(zhí)行17頁 執(zhí)行u執(zhí)行用例Eclipse點擊Run-Run Configuration，在Java Application中New一個，Project選擇APIAutomation，Main class輸入com.pahaoche.driver.TestDriver，Arguments中輸入debugTC=$selected_resource_loc“然后右鍵選中要執(zhí)行的用例，點擊Run As-Run Co

17、nfiguration，選擇APIAutomation執(zhí)行。18頁 執(zhí)行u執(zhí)行用例Eclipse控制臺會輸入日志，從日志中可以看到執(zhí)行結(jié)果是否成功，成功的交易號信息等。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