自動(dòng)化測(cè)試平臺(tái)操作手冊(cè)

1.接口自動(dòng)化

接口自動(dòng)化包含接口管理、報(bào)文管理、測(cè)試集管理、測(cè)試執(zhí)行、測(cè)試報(bào)告幾個(gè)模塊，用

戶通過(guò)創(chuàng)建接口。創(chuàng)建接口下報(bào)文->創(chuàng)建報(bào)文場(chǎng)景->配置場(chǎng)景數(shù)據(jù)。建立測(cè)試集。執(zhí)行測(cè)試

來(lái)完成接口自動(dòng)化整個(gè)測(cè)試管理流程，并通過(guò)測(cè)試報(bào)告模塊來(lái)查看測(cè)試結(jié)果詳情。

1.1.接口管理

接口管理主要用于接口的創(chuàng)建、修改、刪除，并且可以管理接口下的所有入?yún)⒐?jié)點(diǎn)。

1.1.1.接口添加

通過(guò)點(diǎn)擊“添加接口”按鈕來(lái)打開(kāi)接口添加窗口：

輸入完整接口信息，點(diǎn)擊提交即可保存。

1.1.2.入?yún)⒐芾?/p>

點(diǎn)擊接口列表頁(yè)面的入?yún)⒐芾戆粹o打開(kāi)對(duì)應(yīng)接口的人參管理頁(yè)面：

接口入?yún)⒖蓡螚l添加，同時(shí)也能通過(guò)導(dǎo)入入?yún)?bào)文的json串來(lái)批量添加：

1.2.報(bào)文管理

報(bào)文管理主要對(duì)接口下屬各種不同格式類型的報(bào)文進(jìn)行管理，同時(shí)也能管理對(duì)應(yīng)報(bào)文的

各種測(cè)試場(chǎng)景、配置測(cè)試場(chǎng)景的測(cè)試數(shù)據(jù)、返回報(bào)文的參數(shù)驗(yàn)證規(guī)則編輯以及執(zhí)行單次測(cè)試

等

通過(guò)點(diǎn)擊添加報(bào)又按鈕來(lái)打開(kāi)添加窗口：

選擇報(bào)文對(duì)應(yīng)的接口，輸入報(bào)文名稱（類似如〃根據(jù)userid查詢用戶基本信息〃或者〃根據(jù)

custid查詢用戶基本信息〃），填入該報(bào)文對(duì)應(yīng)的請(qǐng)求入?yún)son,點(diǎn)擊驗(yàn)證按鈕，系統(tǒng)將會(huì)判

斷該json報(bào)文中包含的入?yún)⒐?jié)點(diǎn)是否都存在與對(duì)應(yīng)接口的參數(shù)庫(kù)中，驗(yàn)證成功即可提交保存。

測(cè)試場(chǎng)景是根據(jù)報(bào)文下入?yún)⒌牟煌瑺顟B(tài)或者不同類型的數(shù)據(jù)來(lái)細(xì)分出來(lái)的，例如〃正常用

戶根據(jù)id查詢用戶信息〃和〃欠費(fèi)用戶根據(jù)id查詢用戶信息〃。

添加場(chǎng)景只需要輸入場(chǎng)景名稱和備注即可。

對(duì)應(yīng)每個(gè)測(cè)試場(chǎng)景可進(jìn)行上圖中的操作，從左到右分別表示：驗(yàn)證規(guī)則編輯、場(chǎng)景測(cè)試、

測(cè)試數(shù)據(jù)編輯、刪除等操作。具體詳見(jiàn)下方說(shuō)明：

1.2.2.1測(cè)試數(shù)據(jù)

添加場(chǎng)景的測(cè)試數(shù)據(jù)需要輸入數(shù)據(jù)的標(biāo)示，該標(biāo)示應(yīng)該可以簡(jiǎn)明直接的表示各數(shù)據(jù)間的

差異，例如場(chǎng)景對(duì)應(yīng)的報(bào)文名為〃根據(jù)userid查詢用戶信息〃，那么該場(chǎng)景的數(shù)據(jù)標(biāo)示應(yīng)該填

入對(duì)應(yīng)的userido

受理類接口下的場(chǎng)景數(shù)據(jù)在使用完一次之后就會(huì)打上已使用標(biāo)志，無(wú)法再次使用；查詢

類接口下的場(chǎng)景數(shù)據(jù)可以無(wú)限次使用，使用標(biāo)志不會(huì)被更改。

.驗(yàn)證規(guī)則

驗(yàn)證規(guī)則主要用于驗(yàn)證返回報(bào)文的正確性，分為：全局驗(yàn)證、全文驗(yàn)證、節(jié)點(diǎn)驗(yàn)證。

默認(rèn)為全局驗(yàn)證。

全局驗(yàn)證：該規(guī)則在測(cè)試設(shè)置中統(tǒng)一設(shè)置，對(duì)返回報(bào)文進(jìn)行解析，判斷報(bào)文中有無(wú)ReturnCode

節(jié)點(diǎn)，并取出該值同預(yù)設(shè)置的返回值進(jìn)行比對(duì)，判斷返回是否正確。

全文驗(yàn)證：對(duì)返回報(bào)文的全文進(jìn)行匹配驗(yàn)證，判斷是否符合要求。

節(jié)點(diǎn)驗(yàn)證：按照配置的規(guī)則對(duì)返回報(bào)文中每個(gè)節(jié)點(diǎn)進(jìn)行正確性驗(yàn)證。

備注：節(jié)點(diǎn)驗(yàn)證的配置規(guī)則詳解

復(fù)雜節(jié)點(diǎn)路徑.

獲最驗(yàn)端值方式：何種方式來(lái)獲取用于比對(duì)返回報(bào)文該節(jié)點(diǎn)值的數(shù)據(jù)。目前提供以下三

種：①字符串②入?yún)⒐?jié)點(diǎn)（從入?yún)⒅蝎@?。蹟?shù)據(jù)庫(kù)（從指定數(shù)據(jù)庫(kù)中獲?。?/p>

參數(shù)比對(duì)值：根據(jù)獲取險(xiǎn)證佰方式的不同需要填入不同的內(nèi)容：

①字符串：填入普通字符串值②入?yún)⒐?jié)點(diǎn)（從入?yún)⒅蝎@?。禾钊肴?yún)⒐?jié)點(diǎn)名稱③數(shù)據(jù)

庫(kù)（從指定數(shù)據(jù)庫(kù)中獲?。翰樵冇玫腟QL語(yǔ)句

下圖展示了對(duì)返回報(bào)文中的id/name/age三個(gè)節(jié)點(diǎn)進(jìn)行正確性驗(yàn)證的規(guī)則。

場(chǎng)景測(cè)試

場(chǎng)景測(cè)試可用于對(duì)創(chuàng)建的場(chǎng)景進(jìn)行單次測(cè)試調(diào)試，可以自行選擇測(cè)試地址和測(cè)試數(shù)據(jù)。

1.3.測(cè)試集管理

測(cè)試集管理用于管理由不同測(cè)試場(chǎng)景組合成的測(cè)試集合。點(diǎn)擊添加按鈕輸入測(cè)試集名稱

即可創(chuàng)建新的測(cè)試集。

點(diǎn)擊對(duì)應(yīng)測(cè)試集下的測(cè)試場(chǎng)景數(shù)量按鈕可對(duì)該測(cè)試集下的測(cè)試場(chǎng)景進(jìn)行進(jìn)行管理，自行

添加或者減少該測(cè)試集下的測(cè)試場(chǎng)景。

1.4.測(cè)試執(zhí)行

測(cè)試執(zhí)行用于配置全局的測(cè)試設(shè)置和進(jìn)行測(cè)試集測(cè)試或者全局測(cè)試。

可進(jìn)行配置的選項(xiàng)說(shuō)明：

①接口地址選擇：默認(rèn)選擇（按優(yōu)先級(jí)選取測(cè)試地址：報(bào)文中設(shè)置的地址＞接口中設(shè)置的

mock地址》接口中設(shè)置的real地址）、優(yōu)先使用接口中定義的mock地址、優(yōu)先使用接

口中定義的real地址

②連接超時(shí)：與請(qǐng)求地址建立連接的最大超時(shí)時(shí)間，單位ms

⑥讀取超時(shí)：從己建立的連接中讀取返回報(bào)文的最大超時(shí)時(shí)間，單位ms

④請(qǐng)求方式；GET、POST

⑤返回值確認(rèn)：對(duì)返回報(bào)文的正確性驗(yàn)證的全局設(shè)置，嘗試獲取返回報(bào)文中的

RetumCode節(jié)點(diǎn)的值，同此設(shè)置的值列表進(jìn)行匹配驗(yàn)證，多個(gè)值用英文逗號(hào)分隔

⑥測(cè)試前檢查數(shù)據(jù)：測(cè)試之前是否需要自動(dòng)檢查該場(chǎng)景是否擁有足夠的數(shù)據(jù)進(jìn)行本次測(cè)

試。

⑦后臺(tái)執(zhí)行：后臺(tái)執(zhí)行的結(jié)果會(huì)通過(guò)站內(nèi)信通知用戶。

測(cè)試集測(cè)試：選擇當(dāng)前用戶創(chuàng)建的指定測(cè)試集來(lái)進(jìn)行測(cè)試

全局測(cè)試：測(cè)試當(dāng)前所有的測(cè)試場(chǎng)景，該操作需要指定權(quán)限。

1.5.測(cè)試報(bào)告

展示詳細(xì)的測(cè)試集測(cè)試或者全員測(cè)試的測(cè)試報(bào)告。

通過(guò)點(diǎn)擊測(cè)試成功數(shù)、測(cè)試失敗數(shù)、測(cè)試異常數(shù)連接按鈕打開(kāi)詳情頁(yè)查看指定的測(cè)試場(chǎng)

景在本次測(cè)試中的入?yún)?、出參等情況。

在測(cè)試報(bào)告列表頁(yè)的操作選項(xiàng)欄，可以點(diǎn)擊打開(kāi)詳細(xì)測(cè)試報(bào)告總覽。

1.6.接口Mock

通過(guò)此功能可以在本系統(tǒng)中創(chuàng)建一個(gè)對(duì)外提供測(cè)試的模擬接口。

打開(kāi)測(cè)試工具模塊，點(diǎn)擊接口Mock,點(diǎn)擊頁(yè)面"+增加Mock接口”按鈕，打開(kāi)增加頁(yè)

面。按照提示輸入對(duì)應(yīng)的內(nèi)容，點(diǎn)擊保存即可。

備注：“是否需要驗(yàn)證入?yún)⒑戏ㄐ浴边x項(xiàng)設(shè)置了該接口在接收他方調(diào)用的時(shí)候，是否驗(yàn)證參

數(shù)的合法性，主要驗(yàn)證傳入的參數(shù)是否都存在于設(shè)定的接口入?yún)⒅小?/p>

調(diào)用mock接口

打開(kāi)mock接口列表頁(yè)面，復(fù)制需要調(diào)用接口的接口地址。

由于該mock接口設(shè)置了臉證入?yún)ⅲ?/p>

更改選項(xiàng)為不驗(yàn)證并重新調(diào)用：

2.Web功能自動(dòng)化

Web功能自動(dòng)化集成了Selenium-java測(cè)試框架，并將相關(guān)常用方法進(jìn)行進(jìn)一步的封裝,

用戶在Web頁(yè)面通過(guò)頁(yè)面提示創(chuàng)建測(cè)試用例、測(cè)試對(duì)象等來(lái)間接的編寫(xiě)測(cè)試腳本，并通過(guò)

本地測(cè)試客戶端來(lái)進(jìn)行本地調(diào)試。

2.1.測(cè)試流程

通過(guò)創(chuàng)建一個(gè)測(cè)試百度搜索功能的測(cè)試用例來(lái)展示如何通過(guò)本工具來(lái)執(zhí)行Web自動(dòng)化

的基本流程。

打開(kāi)用例管理模塊，點(diǎn)擊”+增加新的測(cè)試用例”打開(kāi)增加頁(yè)面。輸入內(nèi)容提交即可創(chuàng)建

一個(gè)新的測(cè)試用例。

創(chuàng)建測(cè)試對(duì)象

在進(jìn)一步完善測(cè)試用例之前我們還需要?jiǎng)?chuàng)建對(duì)應(yīng)用例下所用到的測(cè)試對(duì)象（測(cè)試對(duì)象即

各種頁(yè)面上的html元素或者類似iframe層、對(duì)話框等），

打開(kāi)測(cè)試對(duì)象模塊，按照頁(yè)面提示先創(chuàng)建對(duì)應(yīng)節(jié)點(diǎn)：

可創(chuàng)建的節(jié)點(diǎn)類型包括：website-網(wǎng)站（比如百度）、module-模塊（比如用戶管理）、feature-

功能（比如增加用戶）、頁(yè)面。

創(chuàng)建好節(jié)點(diǎn)之后，點(diǎn)擊對(duì)應(yīng)的頁(yè)面。增加新的測(cè)試對(duì)象打開(kāi)測(cè)試對(duì)象增加頁(yè)面。

相關(guān)屬性說(shuō)明：

1、對(duì)象類型：即為html頁(yè)面上對(duì)應(yīng)的元素名，比如button指頁(yè)而上的按鈕、text_field

指頁(yè)面上輸入框、link指頁(yè)面上的網(wǎng)址鏈接等。如果創(chuàng)建的測(cè)試對(duì)象不用和hrnl匚的元

素對(duì)應(yīng)起來(lái)，請(qǐng)選擇

2、對(duì)象獲取方式：對(duì)應(yīng)的html元素如何獲取到。提供的方法有：根據(jù)id獲?。ㄍ扑]）、

根據(jù)name查找、根據(jù)元素標(biāo)簽查找等。其中LinkText只能查找link元素、XPath可以查

找所有的元素，需注意。

3、查找順序；如果通過(guò)指定的查找方法查找出的元素不止一個(gè)，那么就可以通過(guò)此值來(lái)

指定需要的元素在查找列表的順序。默認(rèn)為0。

4、關(guān)鍵字：此值在不同的對(duì)象類型和不同的對(duì)象獲取方式下所表示的含義不同：比如對(duì)

象類型為url,獲取方式為則該值就為url的值：比如對(duì)象類型為text_field,獲取方

式為XPath,則該值為該元素對(duì)象在該頁(yè)面上的XPath路徑。

打開(kāi)Chrome瀏覽器的開(kāi)發(fā)者工具臺(tái)，查找本次測(cè)試需要用到的元素（具體使用方法可以

參考Selenium使用教程），分別創(chuàng)建以下兒個(gè)測(cè)試對(duì)象：

點(diǎn)擊測(cè)試用例列表的指定用例下測(cè)試步驟個(gè)數(shù)打開(kāi)測(cè)試步驟頁(yè)面，點(diǎn)擊”+增加新的測(cè)試

步驟”，選擇“創(chuàng)建新的測(cè)試步驟”即可打開(kāi)創(chuàng)建頁(yè)面。

根據(jù)用例設(shè)“，我們可以創(chuàng)建以下幾個(gè)測(cè)試步驟：打開(kāi)百度首頁(yè)-＞輸入搜索條件-＞點(diǎn)擊

搜索按鈕。驗(yàn)證是否搜索正確。

相關(guān)屬性說(shuō)明：

1、執(zhí)行方式：

執(zhí)行-普通執(zhí)行，執(zhí)行完此步驟將會(huì)自動(dòng)執(zhí)行下一個(gè)步驟或者用例執(zhí)行成功；

驗(yàn)證■將本次操作得到的返回值和預(yù)先設(shè)置值進(jìn)行比對(duì)，比對(duì)成功則該測(cè)試用例執(zhí)

行成功或者繼續(xù)執(zhí)行下一個(gè)步驟，比對(duì)不成功或者沒(méi)有比對(duì)值此步驟將會(huì)被標(biāo)記

成Fail。此步驟需要一個(gè)比對(duì)參數(shù)（必要參數(shù)），該參數(shù)支持自定義值、之前步驟的

接收參數(shù)值和指定數(shù)據(jù)庫(kù)查詢值；

取值-此步驟獲取的值可供后續(xù)步驟使用。需要一個(gè)接收參數(shù)（必要參數(shù)），輸入的

參數(shù)值將會(huì)作為該次步驟獲取的值的key。

2、調(diào)用方法：本步驟需要執(zhí)行的調(diào)用方法，請(qǐng)根據(jù)對(duì)象類型和頁(yè)面提示來(lái)選擇。

3、測(cè)試對(duì)象：調(diào)用方法可能需要用到的測(cè)試對(duì)象。某些調(diào)用方法可能不需要此值,

比如getTitle（獲取打開(kāi)的窗口名）、toDefaultFrame（返回到主Frame）＞dismissDialog

（關(guān)閉當(dāng)前對(duì)話框）等。

4、調(diào)用方法參數(shù)：調(diào)用方法可能需要用到的參數(shù)，比如sendKeys（發(fā)送或者填寫(xiě)字符串

內(nèi)容到對(duì)象元素）需要輸入指定字符串、toFrame（切換到指定的Frame層）需要對(duì)應(yīng)Frame層的Id

或者Name、getAttribute（獲取對(duì)象元素的屬性值）需要屬性名稱等，請(qǐng)根據(jù)調(diào)用方法的說(shuō)明來(lái)填寫(xiě)該值。

5、步驟方法參數(shù)：不同的步驟執(zhí)行方法可能需要一些參數(shù)：

執(zhí)行步驟：不需要；

驗(yàn)證步驟：不同的預(yù)期驗(yàn)證數(shù)據(jù)獲取方式，步驟方法參數(shù)需要填入的內(nèi)容也不相

同：字符串（直接輸入需要同結(jié)果進(jìn)行驗(yàn)證的字符串值）、取值參數(shù)（之前通過(guò)

取值步驟取到的參數(shù)名稱）、數(shù)據(jù)庫(kù)（杳找驗(yàn)證數(shù)據(jù)用到的SQL語(yǔ)句）；

取值步驟：需要輸入一個(gè)參數(shù)名來(lái)接收本次步驟的取值內(nèi)容，格式為“＜接收參

數(shù)名

6、是否截圖：執(zhí)行完該步驟是否需要進(jìn)行截圖操作。

2.1.4.執(zhí)行測(cè)試

點(diǎn)擊指定測(cè)試用例的執(zhí)行按鈕，提示需要到測(cè)試客戶端進(jìn)行執(zhí)行操作。

打開(kāi)木地測(cè)試客戶端（方法可.參見(jiàn)2.5.本地測(cè)試客戶端），選擇指定的提交待測(cè)試的任務(wù),

點(diǎn)擊下方執(zhí)行測(cè)試按鈕，客戶端會(huì)根據(jù)測(cè)試用例中設(shè)置的瀏覽器類型來(lái)打開(kāi)本地的瀏覽器開(kāi)

始進(jìn)行自動(dòng)化測(cè)試，測(cè)試完成關(guān)閉瀏覽器并提示。

打開(kāi)測(cè)試報(bào)告管理頁(yè)面，選擇本次測(cè)試的測(cè)試結(jié)果。

點(diǎn)擊執(zhí)行步驟將會(huì)打開(kāi)詳細(xì)的測(cè)試報(bào)告，包括每個(gè)步驟的執(zhí)行結(jié)果、截圖、執(zhí)行時(shí)間、

備注等。

點(diǎn)擊操作欄中的報(bào)告生成按鈕將會(huì)打開(kāi)本次測(cè)試報(bào)告總覽。

22.公共步驟庫(kù)

公共｝驟中保存著一些常用的測(cè)試步驟，比如登錄、固定的驗(yàn)證等。

打開(kāi)某個(gè)測(cè)試用例的測(cè)試步驟列表，點(diǎn)擊上方工具欄的“推薦我的測(cè)試步驟”按鈕打開(kāi)

公共測(cè)試步驟創(chuàng)建頁(yè)面。

選擇需要加入的指定步驟（至少需要一個(gè)步驟），填寫(xiě)相關(guān)說(shuō)明設(shè)置，點(diǎn)擊“推薦審核”

即可。

用戶可以在步驟列表頁(yè)面查看自己推薦的公共步驟審核情況。

庫(kù)

審核查看公共步驟庫(kù)需要管理員權(quán)限，打開(kāi)審核頁(yè)面可以查看用戶推薦的公共步驟，點(diǎn)

擊測(cè)試步驟可以查看包含的測(cè)試步驟并且可以進(jìn)行修改（此修改不會(huì)影響用戶自己測(cè)試用例

中測(cè)試步驟）。

點(diǎn)擊當(dāng)前狀態(tài)可進(jìn)行審核，審核通過(guò)可以在公共步驟庫(kù)列表查看。

如需要使用公共步驟，在創(chuàng)建測(cè)試步驟的時(shí)候選擇“從公共步驟庫(kù)中選擇”即可。選擇

的公共步驟會(huì)被復(fù)制并加入到當(dāng)前測(cè)試用例中的測(cè)試步驟，通過(guò)“測(cè)試步驟排序”功能可對(duì)

步驟順序進(jìn)行調(diào)整。

2.3.測(cè)試用例集

測(cè)試用例集包含多個(gè)測(cè)試用例，由管理員創(chuàng)建和維護(hù)，用戶添加測(cè)試用例，管理員進(jìn)行

審核。

測(cè)試用例集執(zhí)行在服務(wù)器端。所以必須保證服務(wù)端為Windowserver服務(wù)器并且配置好各

種扳本的瀏覽器和驅(qū)動(dòng)程序。

打開(kāi)測(cè)試用例集模塊，點(diǎn)擊“+增加新的測(cè)試用例集”，輸入創(chuàng)建的測(cè)試用例集名稱即可。

點(diǎn)擊測(cè)試用例集編輯按鈕，打開(kāi)測(cè)試用例集詳情。點(diǎn)擊“編輯測(cè)試集詳情”可對(duì)該用例

集進(jìn)行詳細(xì)修改。

添加測(cè)試用例

用戶通過(guò)點(diǎn)擊測(cè)試用例操作欄中的“添加到測(cè)試集"按鈕圖標(biāo)打開(kāi)可添加到的測(cè)試用例

集列表。

點(diǎn)擊添加按鈕添加該測(cè)試用例到指定的測(cè)試用例。

用戶可以在用例列表頁(yè)面查看審核情況。

管理員用戶可在測(cè)試用例詳情頁(yè)面處理添加請(qǐng)求。

只有管理員才能執(zhí)行測(cè)試用例集，點(diǎn)擊狀態(tài)為“可用”的測(cè)試集的執(zhí)行按鈕，即可在服

務(wù)端開(kāi)始執(zhí)行自動(dòng)化測(cè)試。測(cè)試完成之后系統(tǒng)發(fā)送站內(nèi)郵件通知管理員查看測(cè)試報(bào)告。

2.4.測(cè)試配置

說(shuō)明：

等待元素出現(xiàn)最大時(shí)間：為獲取頁(yè)面上指定元素而等待其出現(xiàn)的最大超時(shí)時(shí)間，默

認(rèn)為5000ms；

等待獲取結(jié)果時(shí)間：在取值或者驗(yàn)證的測(cè)試步驟中，為獲取指定結(jié)果而等待的最大

超時(shí)時(shí)間，默認(rèn)為3000ms：

瀏覽器啟動(dòng)路徑：用戶個(gè)人電腦上各類型瀏覽器的啟動(dòng)路徑（.exe文件絕對(duì)路徑），不

填則為默認(rèn)路徑：

瀏覽器大小：執(zhí)行測(cè)試時(shí)，瀏覽器的大小，默認(rèn)為最大化，可選最小化或者默認(rèn)大

??；

出錯(cuò)執(zhí)行：執(zhí)行測(cè)試時(shí)出現(xiàn)錯(cuò)誤時(shí)的處理方法，默認(rèn)為出現(xiàn)錯(cuò)誤將