第5章Postman工具之collection集合
5.1創建集合
5.2共享集合
5.3導入/導出文件
5.4集合運行
5.5使用數據文件
5.6集合運行結果排錯
5.1創建集合
可以理解成請求的總和或合集。使用集合是Postman工具實現自動化測試的必要條件。Postman集合允許分組保存請求,用戶還可以在集合下面創建文件夾,還可以對集合下的請求再次分組。
(1)打開側邊欄“collection”選項卡
(2)單機下方圖片中的“New Collection”圖標
(3)輸入集合名稱和描述信息(創建各種選項內涵深挖)
如圖,為一個CRM系統的一個接口集合,總共有11個請求。
此方法的好處:
(1)將請求保存到集合和文件夾中,能夠更結構化地保存請求,方便再次使用。
(2)方便后續構建集成測試套件。
(3)方便使用腳本在API請求之間傳遞數據,並構建能夠反映實際用例的工流。
添加集合文件夾中的請求:
(1)在Builder中新建一個請求,單擊“Save”,選擇“松勤CRM系統接口”,那么就可以保存到此文件夾中。
(2)從“History”選項卡中保存請求到集合
文件夾的一些基本操作:
點擊文件夾后面“...”圖標,或者在文件夾位置右鍵單機,出現菜單欄,如圖:
·Share Collection:分享集合
·Manage Role
·Rename:集合重命名
·Edit:編輯集合
·Add Request:增加一個請求
·Add Folder:增加一個子文件夾
·Duplicate:復制此集合
·Export:導出集合(以JSON格式保存)
·Delete:刪除此集合
5.2共享集合
要想分享集合,必須要登錄Postman賬號。點擊集合旁邊的“...”圖標,選擇“Share
5.3導入/導出文件
Postman可以通過文件的方式導出和導入Collection、Environments、Globals和Header Presets。
(1)導出Collection文件
單擊“Collection”選項卡下的“...”圖標,在彈出的列表中選擇“Export”選項,導出集合文件,如圖。
Postman可以導出3種格式的集合,Collection v1、Collection v2、Collection v2.1,其中Collection v2.1是官方推薦格式。
(2)導出/導入Environments文件
單擊右上角“Manage Environments”圖標,出現下圖。
下載按鈕可以導出環境變量文件,import按鈕可以導入環境變量文件。
(3)導出Globals文件
點擊上圖中的“Globals”按鈕,進入下圖全局變量界面,單擊“Download as JSON”按鈕,可以將Globals導出成JSON文件。
(4)導入、導出Postman數據
點擊右上角的“SETING”進入settings設置界面。選擇”Data”選項卡,Postman允許打包所有Collections、Environments、Globals和Header Presets,並導出一個JSON文件,如下圖。
“Download”可以導出我們要的數據,也可以利用“Import data”下的“選擇文件”按鈕,選擇一個JSON文件,導入Postman數據。還可以通過工具欄中的“Import”按鈕,導入一個Collections、Environments、Globals等文件,如下圖。
5.4集合運行
單個請求可以直接點擊“send”發送,但是集合需要在Collection Runner集合運行器窗口,如下圖:
點擊“run”,打開Collection Runner集合運行器窗口,下圖:
(1)Choose a collection or folder
選擇要運行的集合或文件夾,當運行一個集合時,集合中的所有請求都按照它們在Postman中出現的順序發送,這意味着每個文件夾和文件夾中的請求都是按順序執行的。可以通過在Tests里設置setNextRequest()方法更改請求發送的順序以反映工作流程。如上圖選擇“CRM系統接口”集合文件,右側區域顯示具體的接口請求。
(2)Environment
設置環境變量。
(3)Iterations
設置集合運行的次數,圖為1次。
(4)Delay
設置發送每個請求之間的時間間隔(ms),比如設置為100,意思是發送完一個請求,等待100ms才發送下一個請求。圖為0。
(5)Log Responses
設置集合運行時所記錄的日志級別,默認情況下,記錄所有Requests的響應日志。日志包含3個級別:
·For all requests:記錄所有請求的響應日志。
·For failed requests:只記錄至少一個失敗測試請求的響應日志。
·For no requests:不會記錄響應日志
(6)Data
為集合提供運行的數據文件。(JSON和CSV)
(7)Keep variable value
勾選此選項,在集合運行當中,環境變量或者全局變量中的變量可能會發生改變。
點擊“Run”,結果如下圖,全部PASS。
5.5使用數據文件
數據文件是用不同的數據來測試API,以檢查他們在各種情況下是否正常運行。下面以“CRM系統接口”中的“新增客戶”接口為例。名字和號碼用變量{{name}}和{{phone}}表示
(1)使用CSV格式參數
准備了新增客戶.csv文件,有名字和號碼三組CSV參數(比如手機號的位數,號段,就可以這么參數化)
打開Collection Runner集合運行器窗口,如圖設置:
Environment選擇“CRM”環境
Iterations設置3次,因為准備了3組數據,所以需要迭代3次
Data數據中,點擊“Select File”選擇“新增客戶.CSV”,點擊Preview,可以看到每個變量在各次迭代中的值:
點擊”Run”,結果如下圖,“新增客戶”循環3次,PASS
(2)使用JSON格式參數
同樣准備name和phone 3組參數
打開Collection Runner集合運行器窗口,如圖設置:
再次點擊“Run”,結果如下圖,同樣迭代3次,全部PASS
5.6集合運行結果排錯
使用“5.使用數據文件”中的例子,再一次點擊“Run”,結果如下:
可以看到PASS 3條,fail3條。首先對此界面的一些功能進行介紹。
·過濾器:可以看到左側邊欄包含3個紅綠圖標,用來篩選通過或失敗的測試,點擊紅色圖標,篩選出失敗測試。
·Run Summary:調試多次迭代,方便查看迭代結果,循環了3次,3次都失敗了。
接下來介紹2種排錯方式:
(1)通過請求體和響應體來排錯
點擊“新增客戶”,會出現浮動窗口,可以單擊列表行來查看對應的內容,如下圖:
單擊“Response Body”,查看響應體的內容,如下圖:
可以看出響應體中顯示“該客戶手機號已存在”(因為請求參數是第二次應用),符合邏輯。
(2)通過Postman的Console
在Postman窗口左下角,點擊下方圖標,再次在Collection Runner集合運行器中,運行上方的集合。
此時再次查看“Postman Console”窗口,如下圖:
“Postman Console”窗口將記錄所有請求並將它們都顯示在列表中,找到“新增客戶”請求,然后觀察“Response Body”,顯示“該客戶手機號碼已存在”,2種方法結果一致。