使用 EOLINKER 進行接口測試的最佳路徑 (上)

本文內容:

  1. 測試腳本管理:講述如何在 EOLINKER 上設計測試項目目錄結構。
  2. 編寫測試腳本:講述如何在 EOLINKER 上編寫接口測試腳本。
  3. 測試腳本執行及報告:講述如何在 EOLINKER 上執行接口測試腳本,及如何查看和下載測試報告。
  4. 測試項目人員協作:講述如何在 EOLINKER 上進行多人的測試項目協作。

1.測試腳本管理

在EOLINKER上設計測試項目目錄結構來管理測試腳本;

先來看下EOLINKER的測試腳本管理分級:

項目管理 > 測試項目管理 > 測試項目模塊管理(支持子模塊和子子模塊管理) > 測試用例集 > 單個測試用例

image.png
測試腳本管理分級

項目管理

如果現在你只有一個項目叫"小魚遊遊Web",包含web版/app版/公衆號H5版/小程序版,你可以通過【新建自動化測試】(如下圖中標記1)來創建每個版本的測試項目;

如果現在你有多個項目,如"小魚遊遊Web","小魚遊遊APP",同時每個項目包含web版/app版/公衆號H5版/小程序版,你可以先通過【新建分組】(如下圖中標記2),爲"小魚遊遊Web","小魚遊遊APP"分別創建各自的項目目錄,然後進入各個項目目錄中,通過【新建自動化測試】(如下圖中標記1)來創建每個版本的測試項目;

另外,如果項目已經結案,可以通過項目列表的[歸檔]操作按鈕,項目就會移至【已歸檔項目】(如下圖中標記3)列表中,這裏的歸檔和未歸檔沒有本質上的區別,只是放在不同的文件夾而已。

項目管理頁面
項目管理頁面

通過前面操作,各位已經有了測試項目,大家可以進入項目來一看究竟。

1.如果需要了解測試項目當前的協作人員數/ 項目動態/ 測試用例個數等信息的話,請打開 概況頁面;

2.如果要創建並管理 測試項目模塊,測試用例集以及單個測試用例,您可以先去 場景用例 頁面查看,回頭將爲您詳細講解;

3.如果想指定一批測試用例腳本在你設定的時間自動跑,並把測試結果發送到你指定的郵箱,定時進行查看。這個功能需要大家開通企業版本才能進行使用;而如果你已經擁有企業版本,那你可以打開 定時任務 頁面先看看裏面長什麼樣,後面會和大家進行詳細講解;

4.如果希望自定義一些公共調用的變量或參數,如 http 請求的默認值(host url,請求頭部,body 參數),來 公共資源管理 頁面。

5.如果想對測試腳本進行限權管理,比如只讀/讀寫等,去 協作人員管理 頁面設置;

6.最後,如果你想在導入 API 文檔時,只看小魚遊遊 Web 項目的 API 文檔時,你可以進行 自動化測試管理 裏面的【可引用的API項目】中進行設置;

image.png
測試項目管理

測試項目模塊管理/測試用例集

回顧前面說的:“如果你要創建並管理 測試項目模塊,測試用例集以及單個測試用例,先去[場景用例]頁面打個照面,稍後再詳細給你叨叨。”

點[場景測試],進入測試項目模塊/測試用例集頁面;

通過【新建分組】(如下圖中標記1)創建項目模塊目錄(通常模塊劃分2種:按業務和按界面,你可以在設計單接口測試腳本時,按界面,在設計場景測試腳本時,按業務),你可以通過模塊目錄後面的菜單按鈕,創建子分組和子子分組,即子模塊和子子模塊。

創建好模塊目錄後,我們需要在各個模塊目錄下面創建對應用例集,通過【新建用例】(如下圖中標記2)創建各自的用例集。

image.png
測試項目模塊/測試用例集頁面

EOLINER 的用例集有2種類型:

1.普通類型-UI 模式(默認類型):如果你偏愛界面,那你可以選擇這種模式,你只需要填空就能完成接口測試腳本;

2.高級類型-代碼模式:如果你鐘意擼代碼,如果你又會 Javascript ,這個模式會更加適合你;

image.png
新建用例集彈窗

單個測試用例

到此,項目結構已完成,下面就可以開始編寫測試腳本了。

在測試用例集列表,點選一個普通類型-UI模式用例集,進入單個測試用例 - 普通類型[UI模式]頁面,通過【+已有接口】(如下圖中標記1)從API文檔導入接口基本信息(url/請求方法/請求協議/ 傳參/返回信息),這樣方便我們設計腳本時,只要改動傳參和添加校驗信息,即完成一個用例腳本編寫,具體怎麼做,去下一小節吧;當然如果開發的沒有在EOLINKER的API研發管理模塊中編寫API文檔,那你可以通過【+空白接口】(如下圖中標記2)來編寫測試腳本。

image.png
單個測試用例頁面 - 普通類型[UI模式]

如果你點選是一個高級類型-代碼模式用例集,你將進入單個測試用例 - 高級類型[代碼模式]頁面,界面如下,

image.png
單個測試用例頁面 - 高級類型[代碼模式]

2.編寫測試腳本

上面小節已提到,編寫接口測試腳本有2種方式:

  1. 通過【+已有接口】按鈕,從API文檔列表導入已有的接口文檔(如下圖 - API文檔列表頁面),然後基於接口文檔基本信息,並添加用例名稱和校驗信息(斷言),完善接口測試腳本。(推薦)
  2. 通過【+空白接口】按鈕,填寫空白接口文檔,然後添加用例名稱和校驗信息(斷言),完成接口測試腳本。

截圖進入路徑:API研發與自動化測試 -> API研發管理 -> 小魚遊遊Web(Web開發項目)-> API文檔

image.png

image.png
API文檔列表頁面

如果你現在是在EOLINKER上編寫項目的第一條測試用例腳本,你可以根據下面的步驟去編寫測試腳本:

  1. 創建測試環境並導入到用例集
  2. 創建前置用例(如登錄或註冊)
  3. 創建後置用例(如退出登錄)

說明:步驟2-3放在步驟5後面再做,也是可以的。

  1. 導入API文檔(或添加空白接口)

    a. 在導入的API文檔中,編輯測試用例描述(在EOLINKER上叫接口名稱)

    b. 在導入的API文檔中,編輯請求信息

    c. 在導入的API文檔中,編輯預期返回信息(這裏是填寫返回頭部和返回參數,如果這部分開發已經填寫,可以跳過這一步)

    d. 在導入的API文檔中,添加返回頭部校驗

    e. 在導入的API文檔中,添加返回結果校驗

    f. 在導入的API文檔中,添加高級設置

  2. 點保存,完成測試腳本編寫。

說明:後面添加新的用例,基本就是重複4-5的操作,還是挺便捷的嘛!

1.創建測試環境並導入到用例集

在測試環境中,我們可以自定義公共URL(接口所在的主機名)自定義全局變量、自定義添加公共請求參數、自定義添加公共請求頭部標籤、自定義添加公共鑑權方式。

創建測試環境並導入到用例集操作步驟如下gif動態圖:

創建測試環境.gif
創建測試環境並導入到用例集

GIF 動態圖說明:

第一個頁面爲測試項目列表頁面。
第二個頁面爲測試項目的公共資源管理-測試環境頁面,在這裏創建測試環境。
第三個頁面爲測試項目的場景用例頁面,在這裏導入剛纔創建測試環境。

2.創建前置用例(如登錄或註冊)

前置用例,即測試用例的前置條件,登錄或數據初始化,目前還不支持遠程連接並操作數據庫,不過我們可以通過調用接口方式,達到數據初始化的目的。

這裏假設在 API 文檔列表中,已經添加 登錄的接口文檔,這裏我通過【+已有接口】按鈕從 API 文檔列表中 導入登錄接口 來創建前置用例,步驟如下 GIF  動態圖:

前置用例(1).gif

前置用例(2).gif

前置用例(3).gif

前置用例(4).gif

GIF動態圖說明:

  1. 第一個頁面爲測試項目的場景用例頁面,在這裏,點【前置用例】,進入前置用例集列表頁面,然後點【新建前置用例】,創建一個名爲 登錄的用例集,點這個新建的用例集進入前置用例編輯頁面。
  2. 第二個頁面爲前置用例編輯頁面,(注:在新建用例或導入API前,先清除掉編輯窗口中的示例代碼),在這裏,

    a. 點【+已有接口】按鈕,此時會進入 API文檔列表選擇頁面,勾選登錄接口,點【確定】按鈕,完成API導入。

    b. 編輯導入的API文檔,因爲這裏的登錄接口有3個必填傳參,所以我定義3個變量,變量的值,需要自己去構造,每個公司的登錄參數都不一樣,有的是時間戳+隨機字符串+密鑰,有的是md5等等,這一部分eolinker都有封裝好的md5和sha方法,可直接調用,你也可以自己通過 在通用函數構造自定義的函數,如下圖爲通用函數編輯頁面,我覺得這塊比jmeter好用太多,jmeter那邊你需要用java寫個jar包,然後在jmeter的測試計劃中導入,然後調用的時候,還要寫beanshell腳本,真的太麻煩了。

另外,還寫了個斷言,用於測試前置用例是否正確,其中"result_api_1.response"是獲取接口返回信息,這個信息是string類型,所以後面用JSON.parse(),將其轉化爲json對象,用於後面response.statusCode獲取返回信息中的statusCode字段的值。

c. 編輯完API文檔,即寫好前置用例,可以點測試按鈕,看是否登陸成功,我這裏測試結果是測試失敗,是因爲我的3個傳參我給的是空的。

d. 點【保存】,然後點【返回列表】返回到前置用例集列表頁面。

image.png

3.第三個頁面爲前置用例集列表頁面。

3.創建後置用例(如退出登錄)

後置用例,即爲後期處理,返回參數加工、資源清除或數據清除。

後置用例和前置用例的創建步驟一樣,這裏就不再上gif動態圖。

4.導入API文檔並完成測試腳本編寫

這裏不用多說,直接上gif動態圖,圖看不明白的,可以看下面的動態圖說明(TT,圖錄的好辛苦,要求加雞腿...)。

導入API文檔上(1).gif

導入API文檔下.gif

GIF動態圖說明:

  1. 第一個頁面爲測試項目的場景用例頁面,在這裏,點之前創建好的 測試項目模塊目錄【通用接口】,進入用例集列表頁面,然後點【新建用例】,創建一個名爲 獲取公司列表的用例集,點這個新建的用例集進入用例編輯頁面。
  2. 第二個頁面爲單例列表頁面,在這裏,

    a. 點【+已有接口】,此時會進入 API文檔列表選擇頁面,勾選登錄接口,點【確定】按鈕,完成API導入。

    b. 點剛導入的API文檔後面的【編輯】操作按鈕進入用例編輯頁面。

  3. 第三個頁面爲用例編輯頁面,

    a. 編輯接口名稱,即用例名稱。

    b. 訪問此接口時不用傳參,所以請求信息這裏爲空。

    c. 預期返回參數,一般是開發在API文檔填好的,所以這裏爲空。

    d. 沒有可校驗的返回頭部,所以返回頭部校驗這裏爲空。

    e. 返回結果校驗,這裏我用的是JSON檢驗方式,這裏有個【同步返回參數】按鈕,XML檢驗方式也有,如果開發已經寫好預期返回參數,點此按鈕後,所有的返回參數都會自動導入到校驗字段列表中。

    f. 高級設置,我勾選了 【該用例校驗爲失敗時,依然執行下一個用例】,如果沒勾選的話,此用例測試失敗時,後面的用例就不會被執行;其中【當某一校驗規則判斷爲失敗時,依然判斷其餘規則】是默認勾選,表示如果校驗字段列表中某個字段校驗失敗,仍校驗其他還沒校驗的字段;超時限制,默認5000ms,即5秒,表示 測試超時將會自動判斷爲測試失敗。

點【保存】,返回到單例列表頁面,即完成用例編寫。

4.第四個頁面爲單例列表頁面,在這裏點【+前置用例】按鈕,在彈窗中選擇要添加的用例,因爲成功調用這個 [獲取公司列表]通用接口需要登錄的,這裏就需要添加 登錄前置用例。

注:高級類型-代碼模式的用例編寫方法和前面的創建前置用例的方法是一樣,這裏就不再詳細說明,如果你非常想我寫一篇關於 高級類型-代碼模式的用例編寫的話,請留言,讓領導給我加雞腿!(對,我就是這麼沒出息,我就是要雞腿... )

到此,測試用例編寫的正確方式,也就介紹完了。

本文總結

本文主要是引導大家怎麼用 EOLINKER 設計接口測試項目架構,其中包含如何項目目錄結構,如何編寫接口測試腳本,如何執行測試腳本和如何獲取測試報告,以及如何進行多人的協作。其中後兩部分的內容,我們在下篇文章介紹!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章