历史版本14 :FVS网页框组件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

适用场景:安装了「FineVis数据可视化」插件的用户,可参考本文了解 FineVis 的相关功能。

1.1 版本

报表服务器版本
JAR包插件版本功能变动
11.02021-11-15V1.0.0
-
11.0.9-V1.14.1
新增:网页框传参支持动态参数值
11.0.16-V1.16.1新增:网页框「网页路径」支持添加公式,实现动态 URL

1.2 功能简介

「网页框组件」主要用于在 FVS 模板中引入网络页面和工程下其他模板。如下图所示:

Snag_29b5cae4.png

注:本文仅为大家介绍网页框特有功能,其他属性不赘述。

组件交互请参见:FVS组件交互属性 。

组件动画请参见:FVS组件动画 。

组件属性请参见:FVS组件样式属性 。

2. 组件介绍编辑

2.1 路径地址

FVS网页框组件支持两种路径地址:网页路径和模板路径。

2.1.1 网页路径

网页路径支持绝对路径和相对路径,V1.16.1 及之后版本还支持在路径中添加公式,实现动态 URL 链接。

  • 绝对路径:确保当前服务器可访问该网址即可,例如 https://www.fanruan.com/finemax 

  • 相对路径:需要将资源文件保存到 %FR_HOME%\webapps\webroot 文件夹下,例如 /webroot/1.png

例如在网页路径框中输入https://www.fanruan.com/finemax,即可预览该网页内容。如下图所示:

Snag_29b6cd31.png

V1.16.1 及之后版本插入公式示例如下图所示,详细内容可参考本文第 3.3 节。

Snag_29b85170.png

2.1.2 模板路径

模板路径可选择当前报表服务器%FR_HOME%\webroot\WEB-INF\reportlets目录下的所有模板,包括普通报表、 FVS 可视化看板等。

选择模板后点击打开即可。如下图所示:

Snag_41415eb5.png

2.2 传参设置

点击「设置」弹出传参设置框,在设置框中可添加参数,支持添加多个参数。参数类型支持两种类型:

  • 自定义公式编辑:可使用公式输入,以实现参数动态变化

  • 自定义内容:可直接填写文本

添加的参数将展示在传参设置下方的列表中,要修改或删除参数,仍需点击「设置」在弹出的传参设置框中操作。

注:V1.14.1 版本之前,默认参数值仅支持设置为固定值。

Snag_414a40d0.png

2.3 请求方式

请求方式可选择「使用get传参」或「使用post传参」,作用于传参设置,未设置参数时,该设置项无效。如下图所示:

Snag_86486d7a.png

2.4 显示网页滚动条

在「网页框设置」处,用户可选择是否勾选「显示网页滚动条」。如下图所示:

Snag_864b486f.png

1)若不勾选「显示网页滚动条」,隐藏滚动条。网页框中嵌入的网页,不支持上下左右滚动查看网页内容。如下图所示:

Snag_8650cb04.png

2)若勾选了「显示网页滚动条」,网页框若无法完整展示整个网页:

用户可拖动网页框上的滚动条查看网页内容;也可把鼠标移动到网页框上,使用鼠标滚轮滚动查看页面。

E6625B9C-4087-4033-9C20-2FF95AFC94D6.GIF

3. 示例编辑

3.1 新建模板并添加组件

点击设计器左上角「文件>新建可视化看板」创建一张空白看板。如下图所示:

1696926492272814.png

点击或拖拽组件区「容器>网页框」,在页面中新增一个「网页框组件」。如下图所示:

Snag_7cc753b3.png

3.2 模板路径动态传参示例

3.2.1 添加模板路径

点击下载模板:第一张FVS模板.fvs ,将其保存在工程 %FR_HOME%\webroot\WEB-INF\reportlets 文件夹下。

选择网页框路径地址为「模板路径」,点击「选择模板」,选择刚刚保存的「第一张FVS模板.fvs」。如下图所示:

注:「第一张FVS模板.fvs」制作文档请参见 第一张FVS模板

340371C4-5321-4933-AD0C-A6EC85617256.GIF

3.2.2 设计下拉框组件

「第一张FVS模板.fvs」中设置有参数 area ,可展示不同地区的数据,所以在本模板中添加一个 下拉框组件,以实现网页框动态传参。

设置下拉框组件名称为 area ,即表示参数名为 area ,再设置数据字典为「FRDemo」数据库 「销量」表中的「地区」字段。如下图所示:

1682480829156862.png

3.2.3 网页框传参设置

选中网页框组件,设置传参,添加参数名为 area ,参数类型为「自定义公式编辑」,参数内容则输入公式 $area 。如下图所示:

FBAFC584-C92E-4C3D-85CA-1B8EB8E7D172.GIF

3.2.4 效果预览

1)PC 端 

点击右上角「预览」,效果如下图所示,可以看到选择不同地区时,网页框中的模板内容也跟随变化。

0FA05EBD-74C1-442D-B4D6-536CF44BF7B0.GIF

2)移动端 

预览方式请参考 FVS移动端预览 ,效果如下图所示:

注:移动端的预览效果调整「第一张FVS模板.fvs」页面背景为「颜色」,为图片时重布局效果无法自适应。

3.3 网页路径动态URL示例

在上述模板中新建「页面2」,同样添加「网页框组件」和「下拉框组件」完成以下步骤。

3.3.1 添加网页路径

这里我们使用的是两篇文档作为网页路径的对象:

  • FVS数据可视化更新日志-https://help.fanruan.com/finereport/doc-view-4834.html

  • FineVis数据可视化简介-https://help.fanruan.com/finereport/doc-view-4222.html

要实现动态展示链接,只需要将链接中的「文档id」用公式代替,公式中输入参数值 $a 。如下图所示:

40AE20E5-45BA-4891-9DFA-E34A8BA7B69F.GIF

3.3.2 设计下拉框组件

1)设置下拉框组件名称为 a ,与上一步「文档id」参数一致。

2)设置数据字典为「自定义」,实际值为对应文档id,显示值为对应文档标题。

3)设置默认值为自定义字符串 4834。

如下图所示:

Snag_d99a3108.png

3.3.3 效果预览

点击右上角「预览」,切换到「页面2」,效果如下图所示,可以看到选择不同文档时,网页框中的模板内容也跟随变化。

1)PC 端

D858D5E1-8C72-47C1-9567-639E57698E33.GIF

2)移动端

预览方式请参考 FVS移动端预览 ,效果如下图所示:

注:移动端支持预览,但网页不支持滚动。

4. 模板下载编辑