普通報表匯出常見問題

本文介紹普通報表 匯出 的一些問題及解決方案。

• 決策報表匯出需要使用API或插件，決策報表匯出常見問題請參見：決策報表匯出常見問題

• 大數據集匯出常見問題，請參見：大數據集匯出常見問題

其中幾大通用問題排查步驟較為複雜，可參見具體的問題排查文檔，如下所示：

1）匯出時經常出現檔案內效果與預覽不一致，此問題較為複雜，若本文沒有具體的解決方案可以參考 匯出檔案內效果與預覽不一致問題排查思路 中的排查思路進行排查。 

2）如何實現匯出檔案的重新命名，可參考：匯出重新命名

注：jdk1.8.0_262，jdk-8u231，jdk1.8.0_192 三個版本不建議使用匯出功能將普通報表匯出為 PDF 或圖片。

2.1 匯出的格子中顯示灰色的箭頭

問題描述：

若將某張報表匯出為 Word 格式，開啟匯出後的 Word，可以看到每個格子後都有一個灰色的箭頭。如下圖所示：

原因分析：

在 Word 裏，灰色的箭頭代表段落的標記，即一行的結尾處顯示的回車符號。

由於 FineReport 範本的介面是類似 Excel 的，且 Word 預設顯示段落標記，所以匯出為 Word 時，就會有段落標記。

解決方案：

開啟 Word，點選「檔案>選項>顯示」，取消勾選「段落標記」，就可以去掉灰色箭頭了，如下圖所示：

注1：取消勾選段落標記後，下次匯出範本或者開啟其他 doc 文檔，都不會顯示灰色箭頭了。

注2：此操作只針對當前用戶端，若將匯出的檔案發至別的用戶端，需要在對應的用戶端再進行如上設定。

2.2 匯出的元件值與顯示值不一致

問題描述：

範本中存在元件，匯出的元件值與預覽時的顯示值不一致，如下圖所示：

原因分析：

元件匯出的是資料字典中的「實際值」，預覽時顯示的是資料字典中的「顯示值」。如下圖所示：

2.3 匯出 Word 無內容/報錯

問題描述：

現象1：普通報表匯出 Word 後無內容，但是匯出 Excel 沒有問題。

現象2：普通報表匯出 Word 時報錯11300002：行高列寬超出頁面大小設定，如下圖所示：

原因分析：

範本中某個儲存格的寬度超出頁面設定的邊框過多。

解決方案：

查看分頁虛線前的儲存格寬度是否過大，縮減對應儲存格寬度即可。如下圖所示：

2.4 文字匯出後顯示為圖片

問題描述：

範本中預覽時正常顯示為正文內容，匯出 Excel 時正常顯示為文字，但匯出 Word 後顯示為圖片。如下圖所示：

原因分析：

1）正文控制

被選儲存格，點選「儲存格屬性>樣式>對齊」，正文控制設定有四種，分別為「自動換行、單行顯示、單行顯示（調整字體）、多行顯示（調整字體）」，除了「自動換行」，設定為其他三種匯出 word 時，文字均顯示為圖片。

2）正文方向

被選儲存格，點選「儲存格屬性>樣式>對齊」，正文方向設定有三種，分別為「自訂角度、文字豎排（從左向右）、文字豎排（從右向左）」，除了「自訂角度」，設定為其他兩種匯出 word 時，文字均顯示為圖片。

2.5 設定頁首頁尾後匯出結果與分頁預覽效果不一致

問題描述：

報表含有頁首或者頁尾，匯出後的 Word 與分頁預覽的結果不同，分頁點不一致，內容下移或被斷開顯示了，如下圖顯示：

原因分析：

Word 中頁首預設距離頂端 12.7 公釐，對應的是 FineReport 的頁邊距。

兩者頁邊距、頁首的高度邏輯不同，導致匯出 Word 後，報表內容可能被頁首擠下而造成下移或斷開顯示。

解決方案：

點選菜單欄「範本>頁面設定>頁面」，將頁邊距的上邊距設定為12.7mm，如下圖所示：

此時預覽及匯出 Word 時，頁首的頂端距離一致，進而匯出結果與預覽結果一致。

2.6 範本雙向自適應

問題描述：

1）普通報表設定 自適應屬性 為「雙向自適應」，匯出時，儲存格內容被截斷/行高變窄，如下圖所示：

2）範本開啟雙向自適應後，在 Chrome 和 Firefox 瀏覽器下匯出的 Word 和 PDF，可能存在多餘空白頁。如下圖所示：

原因分析：

普通報表匯出為任何格式，都不支援自適應。

2.7 範本使用 HTML 顯示內容並匯出 Word 格式

範本使用 HTML 顯示內容，並匯出 Word 格式時，需要注意以下幾點：

1）HTML 內指定的字號要與儲存格字號保持一致，如下圖所示：

2）如果 HTML 內容中存在圖片，建議點選「範本>範本匯出屬性」，使用「不固定行高匯出」，如下圖所示：

2.8 範本右側內容丟失

問題描述：

使用者範本預覽、範本匯出為 PDF 格式都正常，匯出為 Word 格式時右側邊框丟失，如下圖所示：

原因分析：

範本匯出為 Word 格式，表格列數最大不超過 63 ，否則超過 63 列的範本內容丟失。

解決方案：

調整範本所佔的表格列數為 63 列以內。

2.9 匯出 Word 上半截字體不顯示

問題描述：

使用者儲存格內容為 HTML 顯示的一段文字，匯出 Word 後，文字的上半截不顯示。

解決方案：

HTML 中設定的字體要與「儲存格屬性>樣式>字體」中一致。

2.10 範本中含有條碼匯出 Word 文字被遮擋

問題描述：

範本中設定的有條碼，匯出 Word 後，條碼下一行的文字被遮擋。

解決方案：

條碼所在的儲存格的高度設定大於等於 6mm 。

2.11 富正文所在儲存格匯出word後，行高不夠，正文發生截斷

原因分析：

匯出時是按照儲存格的字體計算行間距的固定值，所以需要將儲存格字體大小配置與富正文設定一致

解決方案：

富正文中設定的字號要與儲存格字號設定保持一致。

2.12 範本配置頁首頁尾，匯出word後多出空白頁

原因分析：

word 中的頁首和頁尾無法固定高度，且無法和內容直接貼着進而產生了誤差。

解決方案：

勾選不固定行高匯出或去掉頁首頁尾。

2.13 匯出word沒辦法修改或行高無法調整

問題描述：

1）匯出後在word裏編輯內容，行高不會自動調整。

2）匯出word沒辦法修改。

3）範本匯出word回車後無法自動倒退。

原因分析：

為了達成預覽與匯出的效果一致，產品預設是固定行高匯出的。但這個功能會固定匯出後word檔案內的行高，所以編輯word插入新的正文內容是不會自動調整行高的。

解決方案：

開啟不固定行高匯出。

2.14 word 匯出格式顯示不完整

問題描述：

報表預覽時顯示正常在匯出為 word 後出現圖表/圖片需要跨頁顯示但顯示不完整，如下圖所示：

原因分析：

範本的大小超過了 word 的紙張大小要求。

解決方案：

1）可以跳轉word紙張大小與範本的頁面設定一致，或略大於範本的頁面設定。

2）需要修改範本紙張大小，不能超出 word  對於紙張大小的要求，必須在 2.6mm~558.5mm之間。

3）調整圖表的位置，不要處於分頁線處。

4）設定圖表分頁時不斷開，但是這樣的話圖表可能會被分到下一頁顯示，意味着上一頁會出現大片空白。

3.1 匯出 PDF 時換行顯示內容被截斷

問題描述：

範本儲存格使用了分頁公式，包含 $$totalPage_number 和 $$page_number 參數，分別表示「總頁數」和「當前頁數」，如下圖所示：

預覽時範本顯示正常，匯出為 Word、Excel 或 PDF 時，換行顯示的內容被截斷。如下圖所示：

原因分析：

分頁需要依賴儲存格的寬高，即儲存格高度計算完成之後才能分頁，然後分頁公式才能得出計算值。所以當儲存格使用了分頁公式，在匯出計算儲存格高度時，實際獲取不到分頁公式的計算值，最終可能導致儲存格高度計算錯誤，進而導致文字顯示不全等異常。

解決方案：

匯出為 Word 或 Excel 時，是以表格的形式匯出的，調整表格高度即可顯示，匯出 PDF 則需先手動調整設計器中儲存格的高度。

3.2 同一報表匯出 Word 是橫向佈局，匯出 pdf 是縱向佈局

問題描述：

同一報表匯出 Word 是橫向佈局，匯出 pdf 是縱向佈局。

原因分析：

匯出效果以 Office 為準，是報表橫向自適應導致的紙張高度變化，這個報表的紙張高度超過了 Word 紙張設定的最大值 55.87 公分，所以 Word 處理成預設 27.94 公分的高度。

解決方案：

報表紙張高度超出的原因是開啟了橫向自適應，匯出時的紙張高度和瀏覽器的頁面大小有關。取消橫向自適應後，匯出正常。

3.3 TTf is not a valid TTF or OTF file

問題描述：

匯出 PDF 出現報錯：TTf is not a valid TTF or OTF file

原因分析： 

pdf 匯出會掃描本地的字體檔案, 如果字體損壞, 就會有上述報錯.。

解決方案： 提示哪個字體損壞, 就copy一份過去。

3.4 匯出pdf後，行高比預覽時高

問題描述：匯出pdf後，行高比預覽時高

原因分析：

由於範本字號（9）小於瀏覽器最小字號（12），所以瀏覽器預設以瀏覽器最小字號（12）渲染了，所以預覽時看起來正文是將行塞滿的，但實際匯出的結果是正確的。

解決方案：

調整範本字體或調整瀏覽器最小字號

4.1 border-spacing 匯出 Excel 報錯

問題描述

範本匯出 Excel ，報錯：Invalid char (:) found at index (14) in sheet name 'border-spacing:10px 20px'

原因分析

sheet 名稱匯出 Excel 時，需注意以下兩個問題：

• sheet 的名稱長度有限制，不能多於 31 個。若多於 31 個，匯出時會被自動截取，可能會導致兩個 sheet 名稱相同，匯出報錯。

• sheet 名稱支援包含英文、漢字、| 、（）等，但是不能包含： 、/、？、*、[]等。

4.2 匯出 excel 報錯提示公式被刪除

問題描述：

原樣匯出 excel 後，開啟提示公式被刪除，點選恢復後內容顯示為 0 。

原因分析：

範本中存在 excel 不支援的公式，如層次座標。

解決方案：

取消勾選「匯出/編輯結果時，保留公式」。

4.3 匯出 Excel 後字體變小

問題描述：

範本內字體格式為仿宋 22 號，但是匯出到 excel 後變小了為 20 號。

原因分析：

excel 匯出字體大於 15 時則為 (int)fontSize * 0.95 。

4.4 原樣匯出為Excel後使用WPS開啟頁首頁尾異常

問題描述：

使用 wps 開啟原樣匯出後的 excel 發現了頁首頁尾異常，如下圖所示：

原因分析：使用 WPS 開啟後的顯示問題。

解決方案：更換為 Excel 開啟檔案即可。

4.5 複合式報表匯出excel部分邊框丟失

問題描述：複合式報表匯出excel部分邊框丟失，如下圖所示：

原因分析：複合式報表內橫向放置了多個報表塊，因為位置不對齊，所以導致有儲存格的邊框正好被遮擋了

解決方案：保證橫縱向的多個報表塊位置保持對齊（一點偏差都不行）

4.6 時間型元件直接匯出excel會預設連接1970-01-01

問題描述

前端預覽看到的都是 HH:mm:ss 格式的時間，不編輯元件匯出 excel 後，被選儲存格可以看到值是 1970-01-01 HH:mm:ss。

原因分析

目前時間類型的元件匯出 Excel 後，Excel 儲存格保持格式正常，被選儲存格後上方儲存格編輯欄會顯示完整的日期。（Excel的邏輯導致的，直接在Excel儲存格內新增日期，然後設定該儲存格格式為日期，其上方的編輯視窗也是會顯示完整的日期）

解決方案

資料集 SQL 裏將欄位類型由日期型轉換為字串，時間元件匯出 excel 就不會連接上年月日。

4.7 報表中圖片預覽顯示正常，匯出Excel後只顯示一部分圖片

問題描述

報表中圖片顯示正常，在資料庫中欄位類型為image，但是匯出原樣excel後，只匯出了圖片左上角。

原因分析

圖片佈局設定為預設，受儲存格限制顯示不全。

解決方案

圖片佈局修改為適應

4.8 匯出後圖片被剪裁

問題描述

儲存格使用 html 展現的 base64 編碼的圖片，使用的谷歌瀏覽器，預覽時圖片正常顯示，但是匯出 excel 圖片顯示不全；試了匯出pdf,圖片也是顯示不全，只顯示部分。

原因分析

img 標籤的width.height 不支援以%為單位，導致寬高限制未生效

解決方案

修改html，如height=200px

5.1 匯出的 sheet 名稱無法引用儲存格值或參數值

問題描述

匯出的 sheet 名稱無法引用儲存格值或參數值。

解決方案

需要自己手動加「=」等於號，最多 30 個字元。

5.2 決策報表/複合式報表匯出，圖片有拉伸

問題描述

決策報表/複合式報表匯出，圖片發生拉伸，與預覽時效果不一致。

原因分析

決策報表/複合式報表匯出，是先把報表轉成格子報表，這一步會損失一部分屬性, 導致格子行高列寬切割。

解決方案

圖表改成儲存格元素，把圖表放在報表塊裏。

5.3 匯出圖表不顯示自訂標籤等內容

問題描述

新圖表預覽時正常，匯出或列印時缺少自訂標籤和自訂坐標軸等，預覽效果：

匯出或列印效果：

原因分析

標籤和坐標軸使用了自訂圖片和文字，如下圖所示：

自訂是前台，匯出列印都是呼叫的後台，導致部分內容無法顯示。

解決方案

目前此種自訂標籤的方式暫不支援匯出或列印。

5.4 匯出重新命名亂碼

問題描述

使用 IE 瀏覽器進行 匯出重新命名 時，若重新命名的名稱為中文的話，會出現亂碼，為什麼會出現這種亂碼又如何解決呢？

如在瀏覽器中輸入：http://localhost:8075/webroot/decision/view/report?viewlet=GettingStarted.cpt&format=pdf&__filename__=銷量表

原因分析：

對於中文來說，瀏覽器編碼和伺服器編碼不一致，導致中文部分出現了亂碼。

解決方案：

解決方法與 URL給參數傳遞中文值 類似。

1）若想直接在瀏覽器中輸入並匯出的話，可以將瀏覽器換成火狐或者谷歌瀏覽器。

2）若整合到項目中，可以使用 encodeURIComponent 方法，如點選某個連結呼叫匯出重新命名，此時可以使用如下方法：

window.location="http://localhost:8075/webroot/decision/view/report?viewlet=gettingstarted.cpt&format=pdf&__filename__="+encodeURIComponent("中文名稱")

詳細的內容可參考 編碼轉換 章節。

5.5 匯出內容在頁尾截斷了

原因分析：

Web 端預覽的時候, 瀏覽器可以自動撐開 div, 而列印匯出的時候,  是嚴格收到頁面大小限制的, 所以會截斷.
解決方案：

把截斷的儲存格設定成分頁可以斷開。