1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
1.2 应用场景
「网页框」控件不支持参数应用，一般在报表页面中嵌入其他网页或者报表中会用到，如下图所示：
注：本篇文档只针对普通报表中「网页框控件」，「决策报表」中需安装「网页框控件插件」使用，详细可参考：网页框控件插件
1.3 如何添加
「普通报表」中，选中单元格后，点击右侧属性面板的「控件设置」，「选择控件」处下拉选择「网页框」控件。如下图所示：
1.4 使用说明
在使用「网页框」控件时，相关注意事项如下：
「网页框」控件在「填报预览」和「数据分析」下才能显示。
「参数面板」不支持添加「网页框」控件。
「网页框」控件不支持流媒体。
「网页框」控件不支持给主模板控件自定义传递参数值，只能通过修改主模板的参数去控制网页框地址的参数值。
2. 控件介绍
2.1 属性
「网页框」控件的属性设置界面如下图所示：
各属性设置项的详细介绍如下：
| 分类 | 设置项 | 详细介绍 |
|---|---|---|
| 基本 | 控件名称 | 控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为无。 |
| 可 用 | 控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，默认勾选。 | |
| 可 见 | 控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，默认勾选。 | |
| 高级 | 水平滚动条可见 | 「网页框」的宽就是所在单元格的宽，当嵌入的网页的宽超过网页框的宽值时，就会出现相应的「水平滚动条」。勾选时，可以看到水平滚动条；不勾选，不可见滚动条且无法滚动，超出「网页框」大小的内容会被截断不显示。默认勾选。 |
| 竖直滚动条可见 | 「网页框」的高就是所在单元格的高，当嵌入的网页的高超过网页框的高值时，就会出现相应的「垂直滚动条」。勾选时，可以看到垂直滚动条；不勾选，不可见滚动条且无法滚动，超出「网页框」大小的内容会被截断不显示。默认勾选。 | |
| 地址 | 地址栏用于输入「网页框」需要嵌入的网页、报表、页面的地址。可输入跨域页面、当前报表工程下的报表、当前应用下的页面。 1）跨域页面：可访问的网址，例如：http://www.fanruan.com 2）当前报表工程下的报表： %FR_HOME%\webapps\webroot\WEB-INF\reportlets 下的报表
地址栏输入：${servletURL}?viewlet=模板名.cpt 例如：${servletURL}?viewlet=GettingStarted.cpt
地址栏输入：${servletURL}?viewlet =模板名.frm 例如：${servletURL}?viewlet=doc/Form/FormFilling.frm 3）当前工程下的页面：页面保存在%FR_HOME%\webapps\webroot 目录下的页面 。 在地址栏输入：${contextPath}/页面名称，contextPath 意指 /webroot，绝对路径的服务器别名，即虚拟目录。 例如将页面保存在%FR_HOME%\webapps\webroot 目录下，输入地址：${contextPath}/1.html | |
| 参数 | 可以给嵌入的网页传递参数，如下图所示：
|
2.2 事件
「网页框」控件不支持添加事件。
2.3 移动端
移动端无可配置项。
注：普通报表中「网页框」控件不支持移动端，决策报表中「网页框控件插件」版本在 10.4.61 及之后时，支持在移动端使用。
3. 应用示例
3.1 模板准备
1）在 FineReport 设计器中，点击「文件>新建普通报表」。
2）合并一片单元格，选中 A1 单元格，插入「网页框」控件，在「地址」中输入http://www.fanruan.com。如下图所示：
3）合并一片单元格，选中 A13 单元格，插入「网页框」控件，在「地址」中输入${servletURL}?viewlet=GettingStarted.cpt。如下图所示：
注：路径在 %FR_HOME%\webapps\webroot\WEB-INF\reportlets 下。
3.2 效果查看
点击「填报预览」，效果与本文 1.2 节预期效果相同。
3.3 模板下载
已完成模板可参见：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\demo\other\网页框控件.cpt
点击下载模板：网页框控件.cpt
4. 注意事项
当「网页框」控件内嵌了 FineBI 模板，点击预览时，出现如下报错：
此时需要打开FineBI模板所在工程，用管理员账号登录，点击「管理系统>安全管理>安全防护」，关闭 Security Headers 即可。
上一篇：列表控件
