Web頁面整合

1.1 版本

1.2 功能簡介

FineReport 透過各種樣式如表格、圖表等來呈現資料，進行統計分析。這些資料表格或圖表，使用者在開發系統的時候也可以自己編程來實現，但是工作量大，維護難。

因此使用者往往選用現成的軟體開發，最後將製作好的 FineReport 範本嵌入到自己的系統中，以節省專案開發週期。

使用者開發的系統基本上趨於 B/S 架構的瀏覽器/伺服器模式，因此需要將製作好的範本嵌入到系統的某一個頁面中，作為頁面的一部分。

本章節將詳細介紹 Web 頁面整合方法。

說明文檔僅提供官方API，提供給具備自主產品整合能力的使用者使用。技術支援不負責API範例的維護和使用問題解答。

簡單整合範例請參見：web頁面整合簡單範例

API除錯注意事項請參見：Web頁面整合API

2.1 常用方案

參考文檔	內容簡介	效果預覽
HTML透過iframe巢狀多張範本並設定聯動	在 HTML 頁面中嵌套多張範本，並實現主子表的聯動
iframe 框架自適應報表高度	iframe 框架大小能夠根據報表頁面的內容自動調整高度或寬度
自訂參數介面	自訂參數介面實現條件查詢
iframe 嵌入報表捲軸問題	讓 iframe 始終在瀏覽器裏面，只有報表超出的部分可能會出現捲軸
自訂參數面板和工具欄	自己定義參數介面以及工具欄
URL 參數傳遞給 iframe 中的報表	iframe 中的報表能夠獲取到主頁面中傳遞過來的參數，直接填入報表預覽頁面中

2.2 跨域存取

參考文檔	內容簡介	效果預覽
跨域呼叫 JS	跨域呼叫 JS 觸發報表事件 範例：跨域提交資料到 FineReport 範本中
不同埠號下跨域呼叫 JS	不同埠下，跨域呼叫 JS 觸發報表事件 範例：8080 埠下的 HTML 檔案中嵌入一個 iframe ，iframe 中嵌入埠 8081 下的範本 test.frm 。點選 test.frm 裏面的按鈕時，則可將正文框中的內容賦給 iframe 中的正文框

2.3 自訂按鈕

透過 Web 整合，使用者可以自訂一套工具欄，透過 iframe 嵌入報表內容，將自訂按鈕放置在報表頁面之外。

並且實現在點選自訂按鈕時，能夠透過 JS 呼叫 FineReport 內建工具欄的方法，來對報表進行一些操作。

JS 呼叫工具欄方法請參考：自訂按鈕

參考文檔	內容簡介	效果預覽
自訂列印按鈕	自訂列印按鈕，列印 iframe 內報表內容
自訂提交按鈕	自訂提交按鈕，將 iframe 內報表資料入庫
自訂批量匯出按鈕	自訂批量匯出按鈕，將多個報表內容同時匯出成某種格式
自訂翻頁按鈕	自訂翻頁按鈕，包括：首頁、上一頁、下一頁、末頁和跳轉
自訂匯出按鈕	自訂按鈕實現匯出報表內容，提供格式包括：PDF、Word、Excel 和圖片
自訂縮放按鈕	自訂縮放按鈕，可放大和縮減報表頁面
工具欄顯示資料總量	在工具欄中顯示資料的總條數

2.4 常見問題