反饋已提交

網絡繁忙

範本檢測助手

1. 概述

1.1 版本

報表伺服器版本
内建范本檢測助手插件版本功能變動
11.0V1.0.0
-
11.0.2V1.1.0
  • 範本檢測助手的結果頁面新增【功能建議】Tab

  • 範本檢測助手的結果頁面樣式優化

  • 可關閉單個範本的自動優化

  • 可關閉範本檢測助手的特定檢測項

  • 新增填報模快異常檢測,詳情可見:填報範本異常檢查

1.2 應用場景

由於範本開發人員的開發水平不一,較多的效能問題都是在開發的過程中使用一些效能不好的用法導緻的,而且使用者對於已開發完成的範本,改動意願不高。範本檢查助手可以在範本制作過程中引導使用者,降低新增範本出現效能問題的幾率。

1.3 功能簡介

FineReport 11.0 內建【範本助手插件,cpt 範本過點擊【範本檢測助手按鈕對範本能進行檢,發現其中可能導致能出現問題的地方,提醒給使者並提供建議修改方案。

注:該功能只支援 cpt 範本。

2. 操作步驟

2.1 觸發檢測方式

2.1.1 手動觸發

開啟一張 cpt 範本,點擊image (3).png範本檢測助手,可對範本進行檢查,若範本未儲存先觸發範本儲存提醒。如下圖所示。

image (4).png

2.1.2 保存檢測

開啟一張未做過檢查的 cpt 範本,進行修改並儲存後,將自動對範本進行檢查。 

2.1.3 預覽檢測

開啟一張未做過檢查的 cpt 範本,對範本進行預覽(支援所有預覽方式),將自動對範本進行檢查。  

預覽後關閉範本再次開啟範本,【檢查錯誤提示】按鈕才會出現。 

2.1.4 其他說明

  • 檢查程式中發生中止操作則中止檢查(如關閉設計器、切換工作區間),下次正常預覽或儲存時再重新觸發檢查。

  • 手動點擊【範本檢測助手】前,若範本未儲存,先觸發範本儲存提醒。

  • 預覽檢查方式下:檢查未完成時,再次發生預覽不觸發第二次檢查,如果再觸發儲存將中止未完成的檢查重新開始。 


2.2 檢測錯誤提示按鈕

2.2.1 按鈕樣式介紹

範本檢查後,將會出現【檢查錯誤提示】按鈕,該按鈕樣式如下圖1、2所示。

image (5).png

image (6).png

2.2.2 其他說明

  • 手動觸發檢查後,檢查結果界面將以彈窗形式出現;儲存或預覽觸發檢查後,可透過點擊【檢查錯誤提示】按鈕查看結果界面。

  • 若使用者對檢查出的效能問題進行最佳化,檢查出的問題數字將根據實際情況變化。

  • 生成檢查結果後,下次再開啟範本,【檢查錯誤提示】按鈕依然存在。 


2.3 檢測錯誤提示頁面

若檢查到效能問題,【修改建議】和【自動優化】兩個 Tab 頁將根據範本實際情況單獨展示或組合展示。

  • 修改建議:將不會自動進行最佳化,需要使用者根據提醒手動修改。

  • 自動最佳化:展示的是系統已經自動進行最佳化的部分。 

  • 功能建議:針對範本情況向用戶推薦可以優化該範本性能的功能。


2.3.1 無性能問題

若暫未檢測到性能問題,檢測結果頁面如下圖所示:

image (7).png


2.3.2 修改建議頁面

如下圖所示:

image (8).png


2.3.3 自動最佳化頁面

如下圖所示:

image (9).png


2.3.4 功能建議

如下圖所示:

26.png


2.3.5 檢測失敗

檢測失敗時顯示報錯彈窗提示:檢測出現錯誤,請在日志中查看失敗原因。如下圖所示:

image (10).png

2.4 是否自動優化

是否對範本進行自動優化如下表所示:

問題編號

問題内容

建議方案

是否自動最佳化

01001

資料集存在冗餘取數列,檢查到僅有XX、XX、XX資料欄實際被使用。

建議修改sql,減少所取資料欄,僅保留需要的資料欄。

02001

儲存格存在冗餘條件屬性,相關條件屬性計算已在其父格中重複進行。

建議刪除儲存格中與父格一緻的條件屬性計算。

02002儲存格存在冗餘過濾條件,相關過濾條件計算已在其父格中重複進行。建議删除儲存格中與父格一緻的過濾條件計算。
02003隱藏列欄中包含部分無意義的條件屬性計算。建議删除隐藏列欄中列高、欄寬及分頁以外的條件屬性。
03001儲存格存在除數為0計算風險。建議對除法計算進行空值判斷,例如=IF(B1=0, Ifinity, A1 / B1)。

04001

此行記憶體在較多列資料,容易出現父子格關系過深影響計算效能。

建議將除第一個資料欄以外的其他資料欄都設定父格為第一個資料欄,以減少計算父子格關系時的遞迴呼叫深度。

05001

資料欄儲存格中存在過濾,將交給記憶體處理,當資料集結果資料較多時將導緻效能慢。

建議去除資料欄儲存格中的過濾,將過濾條件寫入資料集中進行過濾。

06001

儲存格存在擴展的SQL類函式sql,value,map、select),可能出現重複計算導緻效能差。

SQL 類函式在每一次擴展後都會額外進行獨立計算或執行sql,可能導緻重複取數或重複計算建議排查當前儲存格是否需要擴展計算(每行計算內容不同),如不需要可將 SQL 類函式放在非擴展儲存格結果用於擴展。

06002儲存格存在擴展的層次座標函式,可能導緻計算效能差

層次座標的計算效能較差,在擴展後多個層次座標計算可能進一步降低報表預覽效能

建議應答層次座標函式的使用場景,減少層次座標擴展使用,更換成其他方式實現需求

06003
大數據量明細範本使用分組而不是列表建議將明細表所在行的最左父格修改為列表
06004大數據量明細範本使用分組而不是列表建議將明細表所在行的最左父格修改為列表
07001資料集資料量過大,可能佔用較多的記憶體並導緻範本預覽慢建議在元件中對範本查詢時使用的參數進行限制,避免出現不必要的查詢全部資料場景,影響預覽效能造成伺服器壓力
08001元件預設值計算時間過長,可能導緻範本預覽慢

元件預設值的sql函式執行過慢

建議元件預設值不要使用sql函式,改為使用value函式或固定值


2.5 關閉範本自動優化

2.5.1 所有範本關閉自動優化

若使用者不希望對範本進行自動最佳化,需要以管理者身分進入平台,點擊【管理系統】→【系統管理】→【標準】,關閉【範本自動最佳化】按鈕。如下圖所示。 

image (11).png

2.5.2 單個範本關閉自動優化

在範本的檢測錯誤提示頁面中,勾選「不使用自動優化」按鈕,可關閉該範本的自動優化。如下圖所示:

2.6 關閉檢測項

若一些問題用戶不希望範本助手進行檢測或優化,可使用 FINE_CONF_ENTITY可視化配置 插件,增加一個字段即可。

欄位名欄位值
forbiddenRule參考本文第二章節第4小節表格内容決定禁用的檢查項,欄位值為表格中的【問題編号】,譬如:【01001,02001】(使用英文逗号分隔)。


附件列表


主題: 效能優化
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

文 檔回 饋

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉