FineBI檢查工具

1.1 應用場景

FineBI 5.1升級到6.0。升級前後對範本、資料集進行檢查。

1.2 功能簡介

FineBI檢查工具，可以進行範本檢查和資料集檢查。

• 範本檢查工具：自動預覽BI目錄中的所有範本，截圖並記錄範本中是否有組件報錯。（原理是頁面自動化，控制瀏覽器逐個點選預覽範本。運作速度較慢）

• 資料集檢查工具：自動預覽BI中的所有資料集，包括資料庫表、SQL資料集、Excel資料集、自助資料集。匯出報表中會列出所有預覽異常的表。（原理是webAPI自動化，預設使用多執行緒，運作速度快）

注：工具只支撐在 windows、mac 系統運作，推薦windows。

1）BI工程的「外觀配置>平台主題」設為預設“經典”主題。

2）為了儘量保證範本截圖的效果，建議禁用插件：FineBI小助手插件、BI新手引導插件。

3）保證執行工具的帳號，在工具執行過程中，不會在其他瀏覽器登入。

4）下載FineBI檢查工具：FineBI檢查工具

3.1 Windows（推薦）

下載並解壓zip檔案，找到FineBI檢查工具1.x.x.exe，雙擊運作。

3.1.1 範本檢查工具

主介面預設是範本檢查工具的參數面板：

輸入FineBI工程的URL、帳號、密碼，點選測試連結，可以測試與工程的連結情況。

工具配置介紹：

設定完工具配置，點選「開始運作」。需要設定匯出報表資料夾名稱。如下圖所示：

如果未設定匯出路徑，此處會彈出結果存放路徑。

完成後，可在路徑下查看運作結果。如下圖所示：

設定完存放路徑後。點選「結果對比」可以選擇升級前後的csv檔案進行對比，對比結束會顯示對比結果的存放路徑。如下圖所示：

在路徑下查看報表。如下圖所示：

開啟檔案，可以查看檢查工具升級前後生成的兩個csv檔案有何不同。如下圖所示：

3.1.2 資料集檢查工具

1）點選「資料集檢查工具」可以切換到對應的參數面板。

2）連結工程。輸入 FineBI 工程的 URL、帳號、密碼， 然後點選「測試連結」，連結成功即可。

3）進行工具配置。完成後點選「開始運作」。輸入生成的檢查報表名稱。即可進入檢查。如下圖所示：

4）完成後在對應路徑生成報表。如下圖所示：

生成的報表如下圖所示：

5）對生成的報表資料集檢查.csv進行升級前後對比，點選「結果對比」。操作步驟同 3.1.1 節。

3.2 Mac

Mac 版使用過程比較複雜，體驗較差。建議儘量使用 Windows 版。（只需要能透過網路存取到 BI 工程即可）

操作步驟：

運作檢查工具。工具介面的操作步驟與 3.1 節相同。

注意事項：

1）如果使用「範本檢查工具」，Mac版需要使用使用者自己安裝的Chrome瀏覽器，並且需要使用者手動下載對應版本的chromedriver（建議放到 /usr/local/bin 中）

2）如果使用「範本檢查工具」，啟動 App 需要使用命令行的方式（否則呼叫不到chromedriver）：

sudo FineBI檢查工具1.0.0.app/Contents/MacOS/FineBI檢查工具1.0.0

3）如果只使用「資料集檢查工具」，則以上兩點可以忽略，直接點選開啟app檔案即可。

常見問題：

1）問題：開啟 App 報錯「已損壞」。

解決方案：首先應答系統設定裏的「安全性與隱私」是否開啓了「允許開啟任何來源的App」。

如果沒有開啓，執行命令：

sudo spctl --master-disable

開啟終端執行命令：

sudo xattr -r -d com.apple.quarantine App檔案的路徑

2）問題：使用範本檢查工具報錯「找不到帳號輸入框」。

解決方案：實測 Mac 中無頭模式下可能會遇到此問題，建議嘗試開啓「顯示瀏覽器視窗」。

工具運作結束後生成報表 report.html 和 report.csv 。如下圖所示：

4.1 範本檢查報表

預覽異常的範本會以黃色背景顯示。如下圖所示：

點選截圖可以查看範本具體情況。如下圖所示：

4.2 資料集檢查報表

需要注意的是，資料集檢查報表中只會記錄預覽異常的表，預覽正常的表不會出現在報表中。

預覽表常見的異常資訊。如下表所示：