檔案資料集常見問題

本文主要介紹了檔案資料集在使用中經常出現的問題以及解決方案。

1.1 排查思路

檔案資料集在遇到問題時的常見排查思路如下圖所示：

2.1 檔案上傳讀取異常

「資料決策系統>伺服器資料集」中，可以將用戶端本地的檔案上傳到伺服器的 reportlets/excel、reportlets/xml、reportlets/txt 資料夾下。

1）伺服器網路上傳受限：

網路問題會影響用戶端檔案上傳到伺服器，常見的是nginx上傳檔案大小的限制，需要調整 nginx.conf 檔案配置。

2）資料夾沒有讀寫權限

如果伺服器資料夾沒有讀寫權限，檔案會上傳失敗，這時需要給伺服器資料夾賦讀寫權限。

2.2 取數失敗

1）檔案加密

檔案資料集如果進行了加密處理，FineReport 將無法載入資料進而導致預覽空白，同時日誌會報錯：Package should contain a content type part [M1.13]。需要使用者手動給檔案進行解密處理。

2）資料量或檔案體積過大觸發限制

• 產品目前支援的檔案資料集體積最大為 20M，若檔案超過 20M將無法取數。

• 在「智慧維運>記憶體管理>範本限制」中的匯入 Excel 儲存格限制設定會對檔案資料集生效。這類原因導致取數失敗，需要在資料決策平台中調整匯入 Excel 儲存格限制即可解決問題。

3）遠端資料集網路不通

4）遠端資料集 URL 地址類型不支援

FineReport 支援的是瀏覽器存取就能自動下載的或者直接預覽內容的URL地址。如果檔案資料集的URL地址用瀏覽器存取並不會直接下載，而是需要點選操作，這類 URL 地址是不支援的。此外，遠端資料集地址不支援使用 ftp 協定或者谷歌雲盤檔案。

5）遠端資料集 URL 地址或參數中包含中文，需要手動轉碼後再使用。

6）XML 資料不規範。

7）遠端設計時 JAR 版本不一致也會導致取數失敗，將伺服器和設計器 JAR 版本統一即可解決問題。

8）遠端設計時報表伺服器沒有啟動好也會出現建立檔案資料集選擇 Excel 檔案不能正常預覽的情況，此時重啟伺服器即可。

2.3 取數緩慢

網路問題導致的取數緩慢，可以優化網路或將檔案放到伺服器磁碟上離線使用。

2.4 設計器取數與預期不符

1）伺服器資料集中檔案資料集不支援使用動態時間或公式作為參數。

2）目前 Finereport 的 Excel 資料集只能取到第一個 sheet。

3）設計器預設根據 Excel 第一列資料的格式，對整列資料進行標記處理，需要統一資料格式。

2.5 頁面資料展示錯誤

1）當 Excel 裏面欄位的標題裏面有多餘空格時，欄位在資料集中預覽正常，拖入儲存格後預覽範本，該欄位則不顯示，需要使用者只能手動處理刪除多餘空格。

2）Excel 的 HH:mm:ss 格式的時間類型資料不支援識別，會預設格式化成字串。如果 Excel 中設定的格式日期元件能識別，就保留格式，否則轉換為 yyyy-MM-dd HH:mm:ss 格式。

3）甘特圖資料設定為無，不會去讀取檔案資料集中表頭空白的欗資料，此時將 JAR 包更新至 10.0.19.7 及之後版本即可