1. 概述
1.1 應用場景
FineBI 5.1升級到6.0。升級前後對範本、資料集進行檢查。
1.2 功能簡介
FineBI檢查工具,可以進行範本檢查和資料集檢查。
範本檢查工具:自動預覽BI目錄中的所有範本,截圖並記錄範本中是否有組件報錯。(原理是頁面自動化,控制瀏覽器逐個點選預覽範本。運作速度較慢)
資料集檢查工具:自動預覽BI中的所有資料集,包括資料庫表、SQL資料集、Excel資料集、自助資料集。匯出報表中會列出所有預覽異常的表。(原理是webAPI自動化,預設使用多執行緒,運作速度快)
注:工具只支撐在 windows系統運作。
2. 準備工作
1)BI工程的「外觀配置>平台主題」設為預設“經典”主題。
2)為了儘量保證範本截圖的效果,建議禁用插件:FineBI小助手插件、BI新手引導插件。
3)保證執行工具的帳號,在工具執行程式中,不會在其他瀏覽器登入。
4)下載FineBI檢查工具:FineBI檢查工具
3. 運作升級報表
3.1 Windows(推薦)
下載並解壓zip檔案,找到FineBI檢查工具1.x.x.exe,雙擊運作。
3.1.1 範本檢查工具
主介面預設是範本檢查工具的參數面板:
輸入FineBI工程的URL、帳號、密碼,點選測試連結,可以測試與工程的連結情況。
工具配置介紹:
設定項 | 說明 |
---|---|
匯出路徑 | 匯出結果的存放路徑 |
預覽模式 | 隱藏或展示範本遍歷程式 |
開始序號 | 從第N張範本開始預覽 |
終止序號 | 到第N張範本結束預覽 |
設定完工具配置,點選「開始運作」。需要設定匯出報表資料夾名稱。如下圖所示:
如果未設定匯出路徑,此處會彈出結果存放路徑。
完成後,可在路徑下查看運作結果。如下圖所示:
設定完存放路徑後。點選「結果對比」可以選擇升級前後的csv檔案進行對比,對比結束會顯示對比結果的存放路徑。如下圖所示:
在路徑下查看報表。如下圖所示:
開啟檔案,可以查看檢查工具升級前後生成的兩個csv檔案有何不同。如下圖所示:
3.1.2 資料集檢查工具
1)點選「資料集檢查工具」可以切換到對應的參數面板。
2)連結工程。輸入 FineBI 工程的 URL、帳號、密碼, 然後點選「測試連結」,連結成功即可。
3)進行工具配置。完成後點選「開始運作」。輸入生成的檢查報表名稱。即可進入檢查。如下圖所示:
注:如工具配置介面有「血緣分析」、「忽略子表」、「更新資訊」、「自助資料集詳細步驟篩選」等按鈕,請勿勾選,會導致檢查失敗。
4)完成後在對應路徑生成報表。如下圖所示:
生成的報表如下圖所示:
5)對生成的報表資料集檢查.csv進行升級前後對比,點選「結果對比」。操作步驟同 3.1.1 節。
4. 查看報表
工具運作結束後生成報表 report.html 和 report.csv 。如下圖所示:
4.1 範本檢查報表
預覽異常的範本會以黃色背景顯示。如下圖所示:
點選截圖可以查看範本具體情況。如下圖所示:
4.2 資料集檢查報表
需要注意的是,資料集檢查報表中只會記錄預覽異常的表,預覽正常的表不會出現在報表中。
預覽表常見的異常資訊。如下表所示:
異常資訊 | 含義 |
計算結果為空 | 預覽顯示"計算結果為空" |
標紅 | BI中標紅顯示的表 |
更新失敗 | 表更新失敗 |
HTTPConnectionPool: Read timed out. (read timeout=30) | 回應逾時。可能是表傳回結果太慢,也可能是網路原因,需要實際預覽一下看看 |
errorMsg:資料集:cs 未抽取資料(分佈式表[T_84617B]不存在), 請先抽取資料 | 預覽失敗,點選"詳細資訊"看到的結果 |
errorCode: 61300424 | 傳回的錯誤碼 |