列印

1

應用場景。

1. FineReport 8.0 和 9.0 自帶 PDF 列印、Flash 列印和 Applet 列印方式，且配套一個本機軟體列印的插件，以改寫各種場景和滿足客戶的特殊需求。

2. 但過多的列印方式對使用者的選擇造成了一定的困擾，且隨着 Web 協定框架和技術的完善，有些列印方式漸漸被淘汰，部分瀏覽器對老列印方式的支援也越來越差。

3. 為了提升使用者的體驗、簡化列印的場景，FineReport 10.0 對列印功能進行了升級，將各種列印方式整合到一起，形成一個統一的列印入口，讓客戶的選擇變得更加簡單清晰。

注1：10.0 設計器和部署包使用的都是【openjdk】，而使用【openjdk】 無法啟動 flash 列印，但使用【Oracle/sun jdk】可以。

注2：flash 列印目前是已經被淘汰了的技術，很多瀏覽器都將不再支援 flash 列印，建議客戶使用零用户端或本機列印。

2

功能簡介。

1. 新列印有以下特點。

2. 易用性強：易於設定，可預先進行頁面設定傳遞至列印機，並可以儲存使用者列印習慣，無需複雜設定，一鍵列印。同時對於市面上幾乎所有型別列印機都能很好的支援。針式、 熱敏列印機列印是容易出現列印不清晰、列印效果不好的問題都能透過本機軟體列印得到解決。

3. 功能豐富：提供套打、批量列印、列印內容控制、列印偏移、靜默列印等豐富的功能。

4. 效能強大：相同環境下，零用户端列印耗時不到同類競品的一半，本機軟體列印耗時不到同類競品的 1/3。

1. 新列印支援兩種列印方式：【零用户端列印】與【本機軟體列印】。

2. 零用户端列印：無需安裝列印軟體，任何機器上隨時都能列印，適合更偏向列印便捷性的客戶。

3. 本機軟體列印：需要安裝列印軟體，適合固定機器進行大量列印的客戶，有更高的效率和更豐富的設定，不受瀏覽器約束。

1

設定方法。

1. 伺服器設定：設計器菜單欄點擊【伺服器】→【伺服器設定】→【列印設定】，可設定列印方式，對所有範本生效，如下圖1所示。

2. 範本設定：點擊【範本】→【列印設定】，預設為【採用伺服器設定】，可選擇【為該範本單獨設定】，則僅對當前範本有效，如下圖2所示。

2

零用户端列印。

1. 零用户端列印設定內容如下圖所示。

2. 各項設定的定義如下表所示。

3

本機軟體列印-軟體安裝。

1. 選擇本機軟體列印，需在用户端安裝 FinePrint 軟體。點擊下載 FinePrint V5 版本：FinePrint 。

2. 使用者可在【伺服器設定】→【列印設定】中設定軟體下載位址，如下圖所示。

3. 設定的定義如下表所示。

注：遠程設計修改列印埠後，需要重啓工程才可生效。

4

本機軟體列印-基本設定。

1. 本機軟體列印基本設定內容如下圖所示。

2. 設定的定義如下表所示。

注：設定【列印時需要指定 sheet】在分頁預覽下不支援。

1. 點擊【範本】→【範本 Web 屬性】，如下圖所示。

2. 根據範本型別選擇【分頁預覽設定】、【填報頁面設定】、【資料分析設定】。

3. 設定【為該範本單獨設定】。

4. 雙擊【列印】按鈕，在工具欄中新增列印按鈕。

注1：老的列印按鈕，顯示為【列印（相容）】。

注2：版本升級後，老的列印按鈕無法新增到工具欄上進行使用，若想使用老的列印方法，可以透過在工具欄中新增自訂按鈕呼叫API的方法實現。API詳情請參見：JS 呼叫 FR 列印方法。

1. JAR 包時間在 2020-04-26 及之後的 FineReport，新增列印鑒權機制，列印權限受 認證設定 權限控制。

2. 列印鑒權機制適用於【本機列印】、【零用户端】列印和相容的多個列印方式（ 【PDF 列印】、【Flash 列印】），伺服器端列印不受限制。

注：跨域情況下列印，範本認證控制列印權限功能需要做單點登入，否則無法支援範本認證。

1

列印鑒權機制。

2

跨域列印鑒權。

1. 跨域列印時，需要點擊【伺服器】→【報表平台管理】登入數據決策系統，點擊【管理系統】，如下圖所示。

2. 在其中點選【安全管理】。

3. 點擊【安全防護】。

4. 點擊 Security Headers 的【進階設定】，關閉【點擊劫持攻擊防護】和【內容嗅探攻擊防護】。

1

列印軟體不生效。

1. 問題描述：升級至 2020-04-26 之後的 JAR 包，列印軟體不生效。

2. 原因分析：一般是由於列印軟體版本過低，使用文檔中 3.3.1 節提供的 FinePrint  V5 版本即可。

2

本機列印軟體啟動失敗。

1. 問題描述：選擇【本機軟體列印】時，提示本機列印軟體啟動失敗，如下圖所示。

2. 解決方案：點擊提示中的【下載安裝】，下載並啟動本機列印軟體。

注1：本機列印不要安裝在設計器的安裝目錄下。

注2：若已安裝好本機列印軟體，提示啟動失敗，請檢查 9092 埠是否被佔用。

注3：若機器效能較差，會導緻首次啟動消耗時間較長。出現以上報錯時請耐心等待，或稍後再次嘗試列印。

3

瀏覽器不相容。

1. 問題描述：目前瀏覽器列印預覽不相容 IE10 及以下版本，不相容時列印預覽右側 iframe 提示【此瀏覽器暫不支援列印預覽】，如下圖1所示。

2. 解決方案：在 IE 瀏覽器下進行列印時，需要啟用管理載入項中的 Adobe PDF Reader 元件，否則提示【安裝警告】或列印出來的檔案名稱預設 ReportSerber，如下圖2所示。

注：IE11 有些小版本可能不相容，更換瀏覽器即可。

4

報錯 404。

1. 問題描述：Tomcat 上呼叫 FR 工程的本機列印，如果 Tomcat 上無 FR 工程，下面這個請求報錯 404，如下圖所示。

2. 原因分析：執行【FineReport.js】的時候，會嘗試從本伺服器上載入資源，而呼叫者的伺服器上，沒有報表工程，載入不到資源，所以報錯。 

3. 解決方案：在跨域呼叫新列印時，需要額外引入兩個 js，分別是【socket.io.js】和【jquery.watermark.js】（引入位置在【FineReport.js】後面），範例代碼如下所示，其中代碼塊1為10.0範例，代碼塊2為9.0範例。

注1：該問題在 Finereport 10.0 和 Finereport 9.0 中都會出現。

注2：Tomcat 下不能有報表工程。

<script type="text/javascript" 
src="http://localhost:8075/webroot/decision/view/report?op=resource&resource=/com/fr/web/core/js/socket.io.js"></script>
<script type="text/javascript" 
src="http://localhost:8075/webroot/decision/view/report?op=resource&resource=/com/fr/web/core/js/jquery.watermark.js"></script>

<script type="text/javascript" 
src="http://localhost:8075/WebReport/ReportServer?op=resource&resource=/com/fr/web/core/js/socket.io.js"></script> 
<script type="text/javascript" 
src="http://localhost:8075/WebReport/ReportServer?op=resource&resource=/com/fr/web/core/js/jquery.watermark.js"></script>

5

自訂紙張列印不全。

1. 問題描述：當【範本】→【頁面設定】中紙張大小為【自訂】時，本機軟體列印的內容可能會顯示不全。

2. 原因分析：因為 Java 預設列印，會從列印機紙張裏尋找相近的紙張進行匹配。如果沒有在列印軟體中新增自訂紙張，可能找出來的是別的紙張。進而導緻列印內容被修剪。

3. 解決方案：需要在列印軟體中新增自訂紙張大小。具體設定請參見：Java 讀取列印機自訂紙張（該連結為第三方方案）。