標準- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 版本

報表伺服器版本	功能變更
11.0	-
11.0.2	新增一個容器 websocket 方案，幫助使用者實現快速配置 websocket 埠。若「管理系統>系統管理>標準」頁面不顯示 Websocket 設定項，說明此方案生效，Websocket 連結已正確配置，無需其他任何手動配置。
11.0.3	新增「報表檢查」功能
11.0.5	新增「決策報表計算全局設定」功能新增「參數設定」功能
11.0.7	移除「網路報表根目錄名」、「報表資源根目錄名」、「伺服器端字元編碼」設定項
11.0.28	「加密算法」移至管理系統>安全管理>安全防護
11.0.30	新增「防當機專項配置」

1.2 功能簡介

管理者登入FineReport系統，點選「管理系統>系統管理>標準」，可對標準設定屬性進行一系列設定。如下圖所示：

2. 參數說明

模組	功能	簡介
標準參數	Servlet 路徑名	修改它將影響到存取範本時 URL 的書寫方式，不推薦修改預設為 decision
	連結地址管理中心	雲中心連結開關，收集設計器的資訊以及 AlphaFine 的資訊至雲中心，以便使用雲端健檢分析相關功能建議開啟
	外接資料庫	報表系統配置外接資料庫後，遇到叢集環境或資料量較大情況時，可保證報表系統的穩定性詳情請參見：配置外接資料庫
	週開始於	平台內選擇週開始於「星期一/星期日」，儲存並重啟系統後，設定生效設定週開始於星期一時，系統中週的範圍為星期一到星期日設定週開始於星期日時，系統中週的範圍為星期日到星期六該設定對日期公式有影響，具體如下：支援的公式有 WEEK() 和 WEEKDATE() 不影響 WEEKDAY()，傳回的是數字週幾不影響 DATEINWEEK()，預設週開始日期是週一
	Gzip 壓縮	開啟 Gzip 壓縮設定後，可以減少儲存空間透過網路傳輸檔案時，可以減少傳輸的時間，可加快報表存取速度建議開啟
維運平台連結設定		FineOps維運平台是幫助帆軟應用穩定運作和全方位維運管理的解決方案。維運平台支援接入已部署好的FineReport、FineBI、FineDataLink等專案。該配置即用於發起對接請求。具體操作步驟請參見：接入已有專案
範本助手	範本自動優化	預設關閉開啟後，會自動檢查並優化範本存在的問題。優化的問題清單可參見：範本檢測助手
	報表塊自動簡化（beta）	設計決策報表時，往往需要新增非常多的組件，並且經常會為了某些樣式做很多小的報表塊，導致報表塊數量急劇上升。「報表塊自動簡化」功能開啟後，會自動將簡單報表塊轉換成標籤元件及圖片元件，提升前端渲染效能，但樣式上會有略微變化。
	匯出列印檢查	「匯出列印檢查」按鈕預設關閉。開啟「匯出列印檢查」按鈕後，可提高報表塊計算效率。詳情請參見：匯出列印檢查
字體檢查	字體缺失檢查	在製作、匯出、列印範本時，「字體確實檢查」功能，可自動對使用的字體進行檢查。如果伺服器缺少字體，將提示設計者或使用者完成對應字體的安裝。詳情請參見：字型缺失檢測
決策報表計算全局設定	平行計算報表塊（beta）	「平行計算報表塊」按鈕預設關閉開啟後，可提高報表塊計算效率
決策報表計算全局設定	新自適應簡化json	「新自適應簡化json」按鈕預設關閉開啟後，可精簡每個儲存格的json在後台的計算的資料結構
參數設定	全局參數與範本參數延遲計算	報表全局參數或範本參數過多時，可能會因為參數優先計算問題出現效能問題。 11.0.5 及之後版本的工程，新增「參數設定」功能。「全局參數與範本參數延遲計算」按鈕預設關閉。開啟後，可提升速度和效能。
報表檢查	報表前端異常提示	瀏覽器縮放和字體限制，會影響報表在瀏覽器中的預覽效果。使用者無法意識這些問題是縮放導致的，會反饋 BUG 給資訊部門，浪費溝通成本。 11.0.3 及之後版本的工程，新增「報表前端異常提示」功能。對終端使用者進行提示，引導使用者調整到適合預覽的縮放效果。詳情請參見：報表檢查
防當機專項配置	執行緒熔斷	在使用者存取工程資源時，可能會出現執行緒阻擋等問題，而這些問題往往會導致工程當機帆軟提供「執行緒熔斷」功能，對執行緒阻擋問題提供兜底故障容許度策略，降低當機風險。 11.0.30及之後版本，新增「執行緒熔斷」按鈕，支援使用者自訂開啟詳情請參見：資源調度熔斷插件
防當機專項配置	記憶體控制	報表計算程式中會有一些中間物件，這些物件是取數之後產生的，在計算結束後會被轉化為結果報表後清理，但是在計算程式中會引起記憶體激增 11.0.30及之後版本，新增「記憶體控制」按鈕。開啟後，系統會自動對中間物件進行記憶體佔用估算，並與系統閒置記憶體進行對比。如老年代已使用記憶體佔比達到92%，則直接終止計算並拋錯
FineReport 參數	範本限制	一些範本的內部計算邏輯過於複雜，有可能造成系統當機，需要對這些範本進行限制帆軟提供「範本限制」功能，支援對所有範本進行限制，也支援對部分範本放寬限制或進行優化詳情請參見：範本限制

注：關閉「連結地址管理中心」按鈕後，一些功能將無法使用，無法使用的功能如下表所示：

模組	功能	具體說明
雲中心	獲取地址中心的地址	地址管理中心本身
插件引擎	獲取更新資訊	插件商城版本資訊
	下載插件	線上安裝插件、線上更新插件
	平台-插件商城資訊設計器-插件商城資訊	獲取插件商城資訊
更新升級	下載 JAR 包	線上更新升級
更新升級	獲取更新資訊	獲取版本更新資訊
本地列印	獲取地址中心的地址	線上下載本地列印
BBS 認證	帆軟通行證登入	設計器登入
		平台插件商城
		簡訊登入
		雲端健檢分析登入
帆軟市場	開啟簡訊平台	-
帆軟市場	傳送簡訊	-
決策平台	獲取當前使用者端 IP 和城市	上次登入資訊提示功能注：上次登入資訊提示功能無法顯示最新資訊

3. WebSocket 設定

提示:

如不顯示此模組，說明 Websocket 連結已正確配置，無需其他任何手動配置。

WebSocket 埠提供介面化配置，提升易用性。

3.1 WebSocket 請求埠

勾選後可以配置 WebSocket 請求埠，單機下預設不勾選，叢集下預設開啟。

勾選後，在下方顯示「埠」設定框，用於填寫 WebSocket 的請求埠，預設為 38889 。如下圖所示：

注1：FineReport 的 WebSocket 埠預設為[38888,39888]，埠號優先 38888 ，其次 39888 。

注2：若Websocket 埠被佔用/無法使用，請參考文檔進行排查和解決：Websocket 埠被佔用/無法使用

注3：埠填寫有格式限制，如果埠格式填寫錯誤，在報錯設定時，會提示報錯資訊：埠格式錯誤。

3.2 WebSocket 請求路徑

預設值為/socket.io，則預設請求路徑為http://ip:port/socket.io。

可指定中間路徑如/webroot/decision/socket.io，則請求路徑為http://ip:port/webroot/decision/socket.io。

3.3 HTTPS 設定

注：如果在 Nginx 處已配置 HTTPS ，則不需要配置平台的 HTTPS 資訊。

伺服器協定：選擇協定類型，http 選擇 plain，https 選擇 ssl。詳細內容可參見：配置 SSL 證件實現 HTTPS 存取。預設值為 plain。
SSL 金鑰路徑：金鑰和公用鍵存放路徑，使用絕對路徑，對應如%TOMCAT_HOME%\conf\server.xml中 keystoreFile 欄位的值。
SSL 金鑰密碼：申請時用的金鑰，對應如%TOMCAT_HOME%\conf\server.xml中的keystorePass欄位的值。
SSL 證件類型：選擇證件格式，如果是 pfx 證件，改成 PKCS12。預設為 JKS。

注：配置好 WebSocket 請求埠後，儲存配置時會提示重啟報表伺服器的資訊，如下圖所示：

上一篇：登入後強制跳轉

下一篇：報表檢查

有幫助
沒幫助
只是瀏覽
圖片不清晰
用語看不懂
功能說明看不懂
操作說明太簡單
內容有錯誤

中文（简体） English 日本語

中文（繁體）

標準