1. 概述
1.1 應用場景
為了提升使用者的體驗、簡化列印的場景，FineReport 10.0 對列印功能進行了升級，將各種列印方式整合到一起，形成一個統一的列印入口，讓客戶的選擇變得更加簡單清晰。
注1：11.0 設計器和部署包使用的都是 openjdk，而使用 openjdk 無法啟動 flash 列印，但使用 Oracle/sun jdk 可以。
注2：flash 列印目前是已經被淘汰了的技術，很多瀏覽器都將不再支援 flash 列印，建議客戶使用零用戶端或本地列印。
注3：僅普通報表支援列印。
1.2 功能簡介
列印有以下特點：
易用性強：易於設定，可預先進行頁面設定傳遞至印表機，並可以儲存使用者列印習慣，無需複雜設定，一鍵列印。同時對於市面上幾乎所有類型印表機都能很好的支援。針式、 熱敏印表機列印是容易出現列印不清晰、列印效果不好的問題都能透過本地軟體列印得到解決。
功能豐富：提供套打、批量列印、列印內容控制、列印偏移、靜默列印等豐富的功能。
效能強大：相同環境下，零用戶端列印耗時不到同類競品的一半，本地軟體列印耗時不到同類競品的 1/3。
2. 列印功能
列印支援兩種列印方式：
零用戶端列印：無需安裝列印軟體，任何機器上隨時都能列印，適合更偏向列印便捷性的客戶。
本地軟體列印：需要安裝列印軟體，適合固定機器進行大量列印的客戶，有更高的效率和更豐富的設定，不受瀏覽器約束。
| 功能 | 簡介 | 零用戶端列印 | 本地軟體列印 | 相關文檔 |
|---|---|---|---|---|
| 首選印表機 | 支援報表綁定印表機，列印報表時優先選擇綁定的印表機進行列印，免去了使用者每次都要選擇印表機的麻煩 | 不支援 | 支援 | - |
| 列印偏移 | 增加頁面邊距設定，可以調整列印內容的邊距來進行列印偏移，以適應不同印表機的列印效果不同的問題 | 支援 | 列印偏移 | |
| 靜默列印 | 列印繼承範本中的紙張、佈局和邊距設定，可在設計器中提前設定好要列印的樣式，使用者直接使用統一設定，不再彈出設定視窗 | IE 下支援 其他不支援 | 支援 | 靜默列印 |
| 列印內容控制 | 可在設計器中透過對內容進行設定，實現內容是否列印 | 支援 | 列印儲存格 | |
| 套打 | 支援發票、貨運單等內容的套打 | 支援 | 套打 | |
| 批量列印 | 支援對單張範本多個參數值進行批量列印 | 支援 | 批量列印 | |
| 伺服器端列印 | 提供了易呼叫的 JS API，直接呼叫伺服器連結的印表機，可解決本地PC沒有連結印表機無法列印的問題 | 支援 | 伺服器端列印 | |
| Https 下的列印 | 在 https 環境下使用 FineReport11.0，支援使用本地列印功能 | 支援 | 本地列印 https 配置說明 | |
| 跨域列印 | - | 不支援 https 存取 http 支援 http 存取 http 支援 http 存取 https 支援 https 存取 https | - | |
3. 列印設定
3.1 設定方法
3.1.1 伺服器設定
設計器菜單欄點選「伺服器>伺服器設定>列印設定」，可設定列印方式，對所有範本生效，如下圖所示：
3.1.2 範本配置
點選「範本>列印設定」，預設為「採用伺服器設定」，可選擇「為該範本單獨設定」，則只對當前範本有效，如下圖所示：
3.2 零用戶端列印
零用戶端列印設定內容如下圖所示：
各項設定的定義如下表所示：
| 設定 | 定義 | |
|---|---|---|
| 列印時可設定列印邊距 | 勾選 | 彈框對列印邊距進行設定 |
| 不勾選 | 直接使用預設設定中的列印邊距 | |
| IE 瀏覽器中不顯示列印設定 | 勾選 | IE 瀏覽器使用靜默列印功能 |
| 不勾選 | IE 瀏覽器中顯示列印設定 | |
| 針式列印優化 | 勾選 | 列印時，將文字字體更換為黑體以優化列印效果 |
| 不勾選 | 列印實際的文字字體 | |
| 繼承頁面邊距設定 | 勾選 | 繼承頁面邊距設定 |
| 不勾選 | 自訂設定上下左右的邊距 | |
3.3 本地軟體列印
3.3.1 軟體安裝
選擇本地軟體列印，需在用戶端安裝 FinePrint 軟體。點選下載 FinePrint V6 版本
使用者可在「伺服器設定>列印設定」中設定軟體下載位址，如下圖所示：
設定的定義如下表所示：
| 設定 | 定義 | |
|---|---|---|
| 軟體下載位址 | 勾選「預設」 | 列印軟體的下載位址為預設位址（FineReport 提供的下載位址） |
| 不勾選「預設」 | 可以自訂下載位址，當客戶使用的是內網時，可以設定內網位址來下載 例如在軟體下載位址裏填相對路徑 /webroot/FinePrint_Windows_5_0.exe，可以將下載的 FinePrint 軟體放在報表路徑 webroot 下 | |
| 列印軟體埠號 | IE 瀏覽器使用靜默列印功能 注：遠端設計修改列印埠後，需要重啟工程才可生效 | |
3.3.2 基礎設定
本地軟體列印基礎設定內容如下圖所示：
設定的定義如下表所示：
| 設定 | 定義 | |
|---|---|---|
| 列印時需要列印設定視窗 | 勾選 | 彈框對列印屬性進行設定 |
| 不勾選 | 繼承範本中的紙張、佈局和邊距設定，可在設計器中提前設定好要列印的樣式，使用者直接使用統一設定，不再彈出設定視窗，實現靜默列印 | |
| 列印時需要指定 sheet | 預設不勾選。 勾選後，列印時，點選列印按鈕彈出如下彈窗，預設選中所有 sheet，如下圖所示：
注：分頁預覽下不支援 | |
| 印表機 | 支援報表綁定印表機，自動獲取本地可用的印表機，無可用印表機時，顯示為空 | |
| 份數 | 列印的份數，預設為 1 份 | |
| 頁碼 | 預設列印「所有頁」 勾選「指定頁」時，在後面正文框中輸入符合格式要求的數值 勾選「雙面列印」，可以設定列印「奇數頁」或者列印「偶數頁」 | |
| 紙張 | 勾選 | 繼承頁面紙張設定 |
| 不勾選 | 在下拉框中設定需要列印的紙張大小。 | |
| 佈局 | 勾選 | 繼承頁面布置設定 |
| 不勾選 | 自訂設定頁面是縱向還是橫向列印，預設為縱向 | |
| 邊距 | 勾選 | 繼承頁面邊距設定 |
| 不勾選 | 自訂設定頁面的上下左右邊距 | |
| 縮放 | 勾選 | 根據紙張大小縮放列印 |
| 不勾選 | 自訂縮放的比例 | |
4. 列印按鈕
點選「範本>範本 Web 屬性」，根據範本類型選擇「分頁預覽設定、填報頁面設定、資料分析設定」，設定「為該範本單獨設定」，雙擊列印按鈕，在工具欄中新增列印按鈕，如下圖所示：
注1：老的列印按鈕，顯示為「列印（相容）」。
注2：版本升級後，老的列印按鈕無法新增到工具欄上進行使用，若想使用老的列印方法，可以透過在工具欄中新增自訂按鈕呼叫API的方法實現。API詳情請參見：JS 呼叫 FR 列印方法。
5. 列印權限
JAR 包時間在 2020-04-26 及之後的 FineReport，新增列印鑑權機制，列印權限受 範本認證 權限控制。
列印鑑權機制適用於「本地列印、零用戶端」列印和相容的多個列印方式（ PDF 列印、Flash 列印），伺服器端列印不受限制。
注：跨域情況下列印，範本認證控制列印權限功能需要做單點登入，否則無法支援範本認證。
5.1 列印鑑權機制
| 情況 | 列印權限 | 提示 |
|---|---|---|
| 範本認證關閉 | 「任何使用者」可列印任何範本 | - |
範本認證開啟 範本無需認證 | ||
範本認證開啟 僅認證使用者密碼 | 「登入使用者」可以列印任何範本 | 未登入使用者列印時提示：請登入後進行列印 |
範本認證開啟 角色權限認證 | 「登入使用者」可以列印「有權限」的範本 | 登入使用者列印無權限範本時提示：此使用者無權限列印該範本 未登入使用者列印時右上角提示：請登入後進行列印 |
範本認證開啟 數字簽章認證 | 「透過數字簽章認證」的使用者可以列印「有權限」的範本 | 透過數字簽章認證的使用者列印無權限範本時提示：此使用者無權限列印該範本 未透過數字簽章認證的使用者列印時提示：此使用者無權限列印該範本 |
5.2 跨域列印權限
跨域列印時，需要點選「伺服器>報表平台管理」登入數據決策系統，再點選「管理系統>安全管理>安全防護」，點選 Security Headers 的「進階設定」，關閉「點選劫持攻擊防護」和「內容嗅探攻擊防護」。如下圖所示：
6. 注意事項
列印相關問題及解決方案請參見：列印問題匯總
