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

本文內容：

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

1.測試腳本管理

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

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

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

測試腳本管理分級

項目管理

若是如今你只有一個項目叫"小魚遊遊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項目】中進行設置；

測試項目管理

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

回顧前面說的：「若是你要建立並管理 測試項目模塊，測試用例集以及單個測試用例，先去[場景用例]頁面打個照面，稍後再詳細給你叨叨。」

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

經過【新建分組】（以下圖中標記1）建立項目模塊目錄（一般模塊劃分2種：按業務和按界面，你能夠在設計單接口測試腳本時，按界面，在設計場景測試腳本時，按業務），你能夠經過模塊目錄後面的菜單按鈕，建立子分組和子子分組，即子模塊和子子模塊。

建立好模塊目錄後，咱們須要在各個模塊目錄下面建立對應用例集，經過【新建用例】（以下圖中標記2）建立各自的用例集。

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

EOLINER 的用例集有2種類型：

1.普通類型-UI 模式（默認類型）：若是你偏心界面，那你能夠選擇這種模式，你只須要填空就能完成接口測試腳本；

2.高級類型-代碼模式：若是你鐘意擼代碼，若是你又會 Javascript ，這個模式會更加適合你；

新建用例集彈窗

單個測試用例

到此，項目結構已完成，下面就能夠開始編寫測試腳本了。

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

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

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

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

2.編寫測試腳本

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

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

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

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 動態圖說明：

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

2.建立前置用例（如登陸或註冊）

前置用例，即測試用例的前置條件，登陸或數據初始化，目前還不支持遠程鏈接並操做數據庫，不過咱們能夠經過調用接口方式，達到數據初始化的目的。

這裏假設在 API 文檔列表中，已經添加 登陸的接口文檔，這裏我經過【+已有接口】按鈕從 API 文檔列表中 導入登陸接口 來建立前置用例，步驟以下 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. 點【保存】，而後點【返回列表】返回到前置用例集列表頁面。

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

3.建立後置用例（如退出登陸）

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

後置用例和前置用例的建立步驟同樣，這裏就再也不上gif動態圖。

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

這裏不用多說，直接上gif動態圖，圖看不明白的，能夠看下面的動態圖說明（TT，圖錄的好辛苦，要求加雞腿...）。

GIF動態圖說明：

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

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

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

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

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

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

   c. 預期返回參數，通常是開發在API文檔填好的，因此這裏爲空。

   d. 沒有可校驗的返回頭部，因此返回頭部校驗這裏爲空。

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

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

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

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

注：高級類型-代碼模式的用例編寫方法和前面的建立前置用例的方法是同樣，這裏就再也不詳細說明，若是你很是想我寫一篇關於 高級類型-代碼模式的用例編寫的話，請留言，讓領導給我加雞腿!（對，我就是這麼沒出息，我就是要雞腿... ）

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

本文總結

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