1. 概述
1.1 版本
報表伺服器版本 | 內建範本檢查助手插件版本 | 功能變動 |
---|---|---|
11.0.4 | V1.2.18 | 新增匯出列印檢查功能 |
1.2 應用場景
使用者在使用匯出列印功能時,會有很多因素影響最終的效果,但無法對眾多因素逐一進行排查,且排查過於耗時、效率較低。
1.3 功能簡介
V1.2.18 及之後版本的範本檢查助手插件提供「匯出列印檢查」功能,幫助使用者更好的使用匯出列印功能。
具體功能如下:
支援對 cpt、cptx、frm 型別的範本進行匯出列印檢查。
設計器、伺服器中預覽的範本均可進行匯出列印檢查。
對設計器、瀏覽器、範本以及使用者環境等影響匯出列印效果的因素進行檢查。
提供檢查報表,準確展示環境資訊、範本配置資訊以及插件資訊,並標紅顯示需要進一步排查的專案,提升排查效率。
使用者可根據給出的檢查結果以及相關排查文檔連結,進行一定的自主排查。
2. 開啟匯出列印檢查
管理者登入數據決策系統,點選「管理系統>系統管理>標準」,在「範本助手」下,開啟「匯出列印檢查」按鈕,如下圖所示:
3. 檢查入口
3.1 工具欄入口
預覽範本後,點選工具欄中的「匯出列印檢查」按鈕,即可進行匯出列印檢查,如下圖所示:
3.2 URL 入口
匯出列印檢查功能提供兩種 URL 入口:
透過相對路徑進行檢查,形如http://IP:Port/工程名/decision/detect?path=xxx(範本相對路徑)
透過 sessionID 進行檢查,形如http://IP:Port/工程名/decision/detect?sessionID=xxx(sessionID)
本節以內建範本 %FR_HOME%\webapps\webroot\WEB-INF\reportlets\doctw\frm\決策報表入門.frm 為例,分別示範這兩種 URL 的用法。
3.2.1 透過相對路徑進行檢查
瀏覽器存取http://IP:Port/工程名/decision/detect?path=xxx(範本相對路徑),即可進行匯出列印檢查。
本節範例範本的相對路徑為doctw/frm/決策報表入門.frm
在瀏覽器中存取http://IP:Port/工程名/decision/detect?path=doctw/frm/決策報表入門.frm,如下圖所示:

3.2.2 透過 sessionID 進行檢查
1)預覽範本後,按 F12 鍵,或者按滑鼠右鍵點選檢查,開啟 Chrome 的控制檯,切換到「網路」選項,如下圖所示:
2)點選「重新整理」按鈕,重新整理頁面後,在右側過濾框中輸入「sessionID」,篩選出攜帶 sessionID 的請求。
點選一個請求,在右側「Headers>Request Headers>Cookie」中獲取 sessionID 的值,如下圖所示:
3)瀏覽器存取http://IP:Port/工程名/decision/detect?sessionID=xxx(上一步驟獲取的 sessionID),即可進行匯出列印檢查,如下圖所示:
4. 檢查內容
匯出列印檢查完成後,即會在瀏覽器端展示當前範本的檢查報表。
檢查報表的內容包括:基礎問題檢查、環境資訊檢查、範本配置檢查以及插件檢查。
檢查報表中,會標紅顯示需要排查的專案,使用者可點選提供的排查連結跳轉至相應的說明文檔,做進一步排查。如下圖所示:
4.1 基礎問題檢查
展示檢查時間、檢查範本,如下圖所示:
檢查專案 | 說明 |
---|---|
檢查時間 | 檢查完成的時間 |
檢查範本 | 檢查範本的路徑 |

4.2 環境資訊檢查
從使用者的環境因素入手,檢查對匯出列印效果有影響的環境配置,檢查內容如下所示:
使用者如需對相關配置做進一步排查,可點選排查連結跳轉至 影響匯出列印效果的環境因素 進行查看。
檢查專案 | 說明 |
---|---|
JAR 包版本 | - |
JDK 版本 | - |
功能登入 | 當前功能是否登入 |
匯出臨時資料夾權限 | 是否有 temp 資料夾的權限 |
匯出臨時資料夾大小 | temp 資料夾所在磁碟剩餘空間 |
單個圖表匯出資料量限制 |
|
點選攻擊劫持防護 | - |
內容嗅探攻擊防護 | - |
瀏覽器型別版本 | - |

4.3 範本配置檢查
從範本配置因素入手,檢查對匯出列印效果有影響的配置,檢查內容如下所示:
使用者如需對範本的相關配置做進一步排查,可點選排查連結跳轉至 影響匯出列印效果的範本配置因素 進行查看。
檢查專案 | 說明 |
---|---|
字體檢查 | 對已使用的字體進行檢查 |
範本認證 |
|
後臺分頁 |
|
字體自適應 |
|
表格自適應 |
|

4.4 插件檢查
從插件配置因素入手,檢查對匯出列印效果有影響的插件,檢查內容如下所示:
使用者如需對相關插件做進一步排查,可點選排查連結跳轉至 影響匯出列印效果的插件配置因素 進行查看。
檢查專案 | 說明 |
---|---|
itext7匯出及國際化換行插件 | 檢查是否安裝了itext7匯出及國際化換行插件,以及全新PDF匯出列印、新國際化換行策略的開啟情況 |
當前已安裝插件 | 檢查全部已安裝插件,並優先展示匯出列印相關插件 |
當前未安裝匯出列印相關插件 | - |