1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
1.2 應用場景
「網頁框」元件不支援參數應用，一般在報表頁面中嵌入其他網頁或者報表中會用到，如下圖所示：
注：本篇文檔只針對普通報表中「網頁框元件」，「決策報表」中需安裝「網頁框元件插件」使用，詳細可參考：網頁框元件插件
1.3 如何新增
「普通報表」中，被選儲存格後，點選右側屬性面板的「元件設定」，「選擇元件」處下拉選擇「網頁框」元件。如下圖所示：
1.4 使用說明
在使用「網頁框」元件時，相關注意事項如下：
「網頁框」元件在「填報預覽」和「資料分析」下才能顯示。
「參數面板」不支援新增「網頁框」元件。
「網頁框」元件不支援流媒體。
「網頁框」元件不支援給主範本元件自訂傳遞參數值，只能透過修改主範本的參數去控制網頁框地址的參數值。
2. 元件介紹
2.1 屬性
「網頁框」元件的屬性設定介面如下圖所示：
各屬性設定項的詳細介紹如下：
| 分類 | 設定項 | 詳細介紹 |
|---|---|---|
| 基本 | 元件名稱 | 元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為無。 |
| 可 用 | 元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。 | |
| 可 見 | 元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。 | |
| 進階 | 水平捲軸可見 | 「網頁框」的寬就是所在儲存格的寬，當嵌入的網頁的寬超過網頁框的寬值時，就會出現相應的「水平捲軸」。勾選時，可以看到水平捲軸；不勾選，不可見捲軸且無法捲動，超出「網頁框」大小的內容會被截斷不顯示。預設勾選。 |
| 豎直捲軸可見 | 「網頁框」的高就是所在儲存格的高，當嵌入的網頁的高超過網頁框的高值時，就會出現相應的「垂直捲軸」。勾選時，可以看到垂直捲軸；不勾選，不可見捲軸且無法捲動，超出「網頁框」大小的內容會被截斷不顯示。預設勾選。 | |
| 地址 | 地址欄用於輸入「網頁框」需要嵌入的網頁、報表、頁面的地址。可輸入跨域頁面、當前報表工程下的報表、當前應用下的頁面。 1）跨域頁面：可存取的地址，例如：https://help.fanruan.com/finereport-tw/index.php 2）當前報表工程下的報表： %FR_HOME%\webapps\webroot\WEB-INF\reportlets 下的報表
地址欄輸入：${servletURL}?viewlet=範本名.cpt 例如：${servletURL}?viewlet=GettingStartedTW.cpt
地址欄輸入：${servletURL}?viewlet =範本名.frm 例如：${servletURL}?viewlet=doctw/Form/決策報表填報.frm 3）當前工程下的頁面：頁面儲存在%FR_HOME%\webapps\webroot 目錄下的頁面 。 在地址欄輸入：${contextPath}/頁面名稱，contextPath 意指 /webroot，絕對路徑的伺服器別名，即虛擬目錄。 例如將頁面儲存在%FR_HOME%\webapps\webroot 目錄下，輸入地址：${contextPath}/1.html | |
| 參數 | 可以給嵌入的網頁傳遞參數，如下圖所示：
|
2.2 事件
「網頁框」元件不支援新增事件。
2.3 行動端
行動端無可配置項。
注：普通報表中「網頁框」元件不支援行動端。
3. 應用範例
3.1 範本準備
1）在 FineReport 設計器中，點選「檔案>建立普通報表」。
2）合併一片儲存格，選中 A1 儲存格，插入「網頁框」元件，在「地址」中輸入https://help.fanruan.com/finereport-tw/index.php 。如下圖所示：
3）合併一片儲存格，選中 A13 儲存格，插入「網頁框」元件，在「地址」中輸入${servletURL}?viewlet=GettingStartedTW.cpt。如下圖所示：
注：路徑在 %FR_HOME%\webapps\webroot\WEB-INF\reportlets 下。
3.2 效果查看
點選「填報預覽」，效果與本文 1.2 節預期效果相同。
3.3 範本下載
點選下載範本：網頁框元件.cpt
4. 注意事項
當「網頁框」元件內嵌了 FineBI 範本，點選預覽時，出現如下報錯：
此時需要開啟FineBI範本所在工程，用管理者帳號登入，點選「管理系統>安全管理>安全防護」，關閉 Security Headers 即可。
