1. 概述
本文主要總結了Word報表插件在使用中經常出現的問題以及對應的解決方案。
2. 建立報表時出現問題
2.1 無法啟動WPS
問題描述:
建立 Word 報表時，WPS 無法啟動。
原因分析：
埠不通導致呼叫失敗。較低版本的瀏覽器導致前端無法顯示 Word 報表的入口。
解決方案：
更新谷歌瀏覽器版本（最低版本：99版本）。
2.2 建立範本時點選儲存卡住
問題描述：wps 建立一個範本時，點選儲存卡住。
原因分析：wps 建立立的 word 要隨便編輯下才能儲存，否則就會卡住。
解決方案：先編輯一下，再點選儲存。
3. Word報表預覽異常
3.1 預覽word報表製作的cpt檔案，瀏覽器直接下載檔案
原因分析：預覽是以pdf的形式預覽的，瀏覽器對於pdf的設定問題，導致觸發下載。
解決方案：更改瀏覽器設定，以谷歌瀏覽器為例，點選「隱私權和安全性 > 其它內容設定 > PDF檔案」，將其設定修改為在 chrome 中開啟 PDF 檔案即可。如下圖所示：
3.2 預覽後報錯
問題描述：Word 報表預覽後報錯 Compile template failed... ...
原因分析：暫只支援 .docx 後綴的 word 檔案，.doc 後綴的 word 檔案暫不支援。
解決方案：將word檔案另存為 .docx，使用 .docx 製作 word 報表。
3.3 預覽時中文亂碼
問題描述：報表中的中文顯示為口口口或匯出 Word 時提示缺少字體。
原因分析：伺服器缺少對應的字體。
解決方案：伺服器安裝缺失的字體，可以把本地字體同步到到伺服器後重啟工程。可參考說明文檔：伺服器安裝字體。
3.4 嵌入字體顯示為預設字體
問題描述：嵌入字體顯示為預設字體，如下圖所示：
原因分析：
1）安裝的字體為不可嵌入的。
2）儲存 word 時沒有勾選將字體嵌入檔案。
解決方案：修改字體的嵌入屬性為可安裝。如下圖所示：
3.5 匯入其他字體後存在粗體和普通字體時顯示異常
原因分析：1.0.13.3 版本之前插件在 pdf 展示下，word 報表插件內文字粗體展示存在問題。
解決方案：更新插件至 1.0.13.3 及之後版本。
3.6 禁止使用雲字體
在WPS中編輯範本時，需要注意禁止使用雲字體。如下圖所示：
3.7 匯入圖表（包括引用報表區域）部分顯示異常
問題描述：匯入圖表（包括引用報表區域）部分，不顯示或者顯示異常，如顯示不全、重複顯示。
原因分析：word 裏的列間距被修改成固定值，圖片顯示不下，所以顯示異常。
解決方案：修改插入圖表部分的欄間距。
3.8 匯入圖表或表格部分資料報錯
問題描述：
1）匯入圖表部分資料，報錯：TemplateRenderPolicy render
2）匯入表格部分資料，報錯：ThrowException(AbstractRenderPolicyjava:83), com.deepoove.poi.policy.AbstractRenderPolicy.render
原因分析：
1）圖表資料來源於儲存格，引用的儲存格資料有空白欄（或者空白值）。
2）引用的儲存格中有空的儲存格。
解決方案：
1）檢查是否有空白欄，刪除後重新引用。
2）刪除空的儲存格引用或者儲存格設定形態公式：$$$
3.9 預覽報錯 no docx file on this file
原因分析：安裝目錄下，plugins 資料夾下與%FR_HOME%\webroot\WEB-INF\plugins 資料夾下的word插件版本不一致。
解決方案：同步兩個plugins資料夾下插件版本，保持版本一致。
3.10 Word 提示儲存失敗
3.10.1 日誌顯示範本被鎖定
問題描述：
WPS 中顯示儲存失敗。
日誌中顯示範本被鎖定，如下圖所示：
原因分析：
遠端設計修改 Word 報表，在設計器和 Word 中同時開啟了範本，導致範本被鎖定。
解決方案：
關閉設計器中開啟的範本，然後在 Word 端重新進行儲存。
3.10.2 元件顯示增強1.0.2版本插件問題
問題描述：
開啟 Word 報表範本，引用設計器資源，點選儲存，WPS 中顯示儲存失敗。
原因分析：
1.0.2 版本的元件顯示增強插件導致 WPS 無法儲存。
解決方案：
該問題可透過升級插件解決，請升級元件顯示增強插件至 1.0.3 版本。
3.11 Word 報表引用表格，表格中內容部分文字被擋住
問題描述：
CPT 中儲存格已經設定為自動調整列高，但在 Word 報表中引用時無法自動調整列高，導致部分文字被擋住。
解決方案：
將被遮擋的表格中對應的CPT中的列高調高。
3.12 WPS 無法載入出範本目錄
問題描述：
1）建立範本在設計器中可以預覽，可以開啟，在WPS的目錄中找不到範本。
2）安裝後建立範本，在WPS的目錄中載入卡死。
原因分析：
1）存在單點時，WPS無法載入出範本目錄。
2）範本目錄 reportlets 下，有名稱為reportlets的資料夾，資料夾名稱重複，出現讀取範本卡死。
3.13 動態圖表掛載到決策系統中圖表顯示空白
問題描述：本地設計器單獨開發的word報表範本其中圖表正常，手動copy範本到伺服器上掛載到決策系統預覽圖表資料空白。
原因分析：設計器中動態圖表引用的範本的資料，與伺服器中的範本位置不一致。
解決方案：將伺服器範本位置與設計器中的範本位置調整成一致後再引用。
4. word報表登入異常
4.1 登入插件時登入頁面空白
問題描述：登入插件時登入頁面空白，用本機 IE 瀏覽器開啟數據決策系統，同樣是空白頁。如下圖所示：
解決方案：更新JAR包到11.0.5 及之後版本，並更新插件至 2.0.1及之後版本。
4.2 勾選記住帳號密碼後登入異常
問題描述：WPS端勾選記住帳號和密碼後，登入失敗。
解決方案：勾選記住帳號及密碼後，平台中支援保持登入選項也要開啟，否則會登入失敗。
5. 不支援同時開啟多個報表
word 報表插件暫時不支援同時開啟多個文檔，開啟多個 word 時其他已經開啟的 cpt 再次上傳就需要從新上傳，此時上傳為改寫儲存，改寫儲存會使範本的 sheet 和資料集丟失。
6. web.xml形式的cas認證
問題描述：
word報表插件，如果cas認證為web.xml形式（非插件）則無法使用。
原因分析：
wps開啟時傳送的請求不攜帶cookie資訊，請求被重定向。
解決方案：
配置一個放行請求的攔截器（RemoteFilter.class），class 檔案如下，請下載並解壓後使用：
攔截器下載：RemoteFilter.class.zip
將 class 檔案 放在工程路徑 %FR_HOME%/webroot/WEB-INF/classes/com/fr 下，如下圖所示：
對 %FR_HOME%/webapps/webroot/WEB-INF 目錄下的 Web.xml 檔案進行編輯，可使用電腦預設正文編輯器，新增部分如下圖紅框所示：
完成後重啟報表工程。
