大數據集匯出插件

1.1 版本

1.2 應用場景

大批量資料匯出的時候，會對伺服器、網路傳輸、資料庫造成一定的壓力。為了防止這樣的風險，FineReport 推出「大數據集匯出」的功能，可直接根據資料集結果進行匯出。

1.3 功能描述

「大數據集匯出」是一種佔用資源少且速度快的 Excel 匯出方式，無需前臺資料展示即可進行後臺流式匯出。
透過「大數據集匯出 Excel」插件，使用者可以自訂大數據集匯出事件，跨越報表計算直接取數匯出。
實現原理如下：
1）使用 SXSSFWorkbook 流式行匯出，速度快。
2）使用生産者消費者模式，一個執行緒用於取數，把資料行存在佇列中，另一執行緒讀取行匯出。
注：FineReport 設計器支援使用 JavaScript 代碼實現大數據集匯出 Excel，詳情請參見：JS 實現大數據集匯出 Excel 。

1.4 注意事項

1）此功能只支援關系型資料庫。且 SQL Server 資料庫需要把游標設定為伺服器游標。
2）此功能無法直接匯出 date/datetime 型空值，需要在 JDBC 資料連結的 URL 後新增 zeroDateTimeBehavior=convertToNull 參數，如果是 Oracle 資料無需加參數。
3）如果範本有多個參數，且匯出時需要設定參數，那麼這些參數都要設定，不要只設定其中幾個，否則會導緻資料無法匯出。
4）建議匯出的資料量不超過「1000W 行 * 20 列」，資料量超大可能會導緻僅匯出部分資料。
5）匯出的 Excel 是透過 SQL 語句直接從資料庫中獲取的資料，並非報表中的資料，因此報表中設定的資料格式等無法被匯出。
6）此功能不支援行動端。
7）插件版本在 V1.1.10 及之後時，匯出超過 5s 時顯示進度條。
8）支援儲存過程，但是必須按下圖的方式呼叫：

2.1 插件安裝

點選下載插件：大數據集匯出
設計器插件安裝方法參照：設計器插件管理
伺服器安裝插件方法參照：伺服器插件管理

2.2 插件簡介

插件安裝後，在元件事件/範本頁面事件中新增「大數據集匯出」事件型別，如下圖所示：

具體設定和功能如下表所示：

3.1 設定範本

開啟%FR_HOME%\webapps\webroot\WEB-INF\reportlets\GettingStarted.cpt
編輯參數面板，新增一個「按鈕元件」，元件名稱和按鈕名稱修改為「匯出」，如下圖所示：

3.2 設定元件事件

選中「匯出」按鈕元件，點選「元件設定>事件」，新增「點選事件」，設定事件型別為「大數據集匯出」，如下圖所示：

「大數據集匯出」事件的具體設定如下圖所示：

• 匯出檔案名稱為「匯出範例1」

• 格式為「excel」

• 資料集為「ds1」

• 參數地區型別為「字串」，值為「華東」

• 匯出資料列為「地區、銷售員、産品型別」

3.3 效果預覽

儲存範本，點選「分頁預覽」，點選「匯出按鈕」，即可匯出地區為「華東」的「匯出範例1.xlsx」檔案，如下圖所示：

4.1 設定範本

開啟%FR_HOME%\webapps\webroot\WEB-INF\reportlets\GettingStarted.cpt
編輯參數面板，新增一個「按鈕元件」，元件名稱和按鈕名稱修改為「匯出」，如下圖所示：

4.2 設定元件事件

選中「匯出」按鈕元件，點選「元件設定>事件」，新增「點選事件」，設定事件型別為「大數據集匯出」，如下圖所示：

「大數據集匯出 Excel」事件的具體設定如下圖所示：

• 匯出檔案名稱為「匯出範例2」

• 格式為「excel」

• 資料集為「ds1」

• 參數地區型別為「公式」，值為「$地區」，此時匯出Excel的參數值由另一個參數元件決定。

• 匯出資料列為「地區、銷售員、産品型別」

儲存範本，點選「分頁預覽」。匯出 Excel 的參數值由下拉框元件的參數值決定。
下拉框元件選擇「華北」，即可匯出地區為「華北」的「匯出範例2.xlsx」檔案，如下圖所示：