---
title: SideeX Plugin for Jenkins
tags: Chinese
---
# SideeX Plugin for Jenkins
## 步驟1：安裝[SideeX WebService](https://hackmd.io/@sideex/webservice-zh)

## 步驟2：安裝SideeX Plugin for Jenkins
1. 開啟Jenkins後點選`Manage Plugins`
2. 點選`Manage Plugins`
3. 點選`Available`->`Filter`，搜尋`SideeX`

## 步驟3：建立一個測試工作
1. 點選`New Item`
2. 輸入完Item名稱後選擇`Freestyle project`，並點選`ok`
3. 點選`Build` -> `Add build step` -> `Execute SideeX Web Testing`
4. 輸入`Execute SideeX Web Testing`上欄位值，說明如下：

- `Protocol`：選擇連線至SideeX WebService Server之協定
- 若選擇`HTTPS (Enable certificate checking)`，則須於`Certificate file path`欄位中填入[cert.pem](https://hackmd.io/@sideex/webservice-zh#附錄A---SideeX-WebService-Config-File-Format)檔案的本地絕對路徑或相對路徑
- `SideeX WebService base URL`：SideeX WebService Server的網址，即為[serverconfig.json](https://hackmd.io/@sideex/webservice-zh#附錄A---SideeX-WebService-Config-File-Format)中`webservice`.`publicURL`屬性值
- `Checking report periodically every (ms)`：設定每隔多久自動檢查SideeX WebService是否已完成測試案例執行，例如：輸入`2000`代表2000毫秒。
- `Test case file path`：測試案例檔案路徑。測試案例檔案結構請參閱[SideeX WebService 步驟4](https://hackmd.io/@sideex/webservice-zh#步驟4：準備測試案例檔案)
- 情況1：測試案例已存放在Jenkins伺服器本地端
- 若測試案例為zip檔，則填入此檔案的絕對路徑或相對路徑，例如`<some dir>/testcase.zip`
- 若測試案例為一個目錄(尚未壓縮成zip檔)，則填入此目錄的絕對路徑或相對路徑，例如`<some dir>/testcasedir`
- 情況2：若測試案例是上傳到`git`
- 若測試案例為zip檔，則填入Jenkins Pull下來的檔案位置，例如內定Pull下來位置為`workspace`，則填入`./testcase.zip`
- 若測試案例為一個目錄(尚未壓縮成zip檔)，則填入Jenkins Pull下來的目錄位置，例如內定Pull下來位置為`workspace`，則填入`./testcasedir`

## 步驟4：執行並觀看測試報告
1. 點選`Save` -> `Build Now`

2. 點選`Console Output`
3. 觀看執行狀態

4. 執行完成後，點選`Back to Project`->`SideeX View Report`

5. 觀看測試報告