1. 概述编辑
适用场景:安装了「FVS大屏编辑模式」插件的用户,可参考本文了解 FVS 模板的相关功能。
1.1 版本
报表服务器版本 | JAR包 | FVS大屏编辑模式(beta版)版本 |
---|---|---|
11.0 | 2021-11-15 | V1.1.0 |
1.2 功能简介
表格组件(极速版),与普通报表.cpt模板的使用方法基本一致。
注:本文仅为大家介绍表格组件(极速版)特有功能,其他属性不赘述。
组件交互请参见:FVS组件框架交互属性 。表格组件仅支持监控刷新设置。
组件动画请参见:FVS组件框架动画属性 。
组件属性请参见:FVS组件属性 。
2. 组件特点编辑
相比于表格组件,表格组件(极速版)有以下特点:
2.1 加载速度快
表格组件使用 iframe 的方式渲染,表格组件(极速版)使用 canvas 的方式渲染。相同内容,表格组件(极速版)的加载速度更加快。
表格组件:
表格组件(极速版):
2.2 弹出框作用全局
表格组件(极速版)不存在 iframe 的局限性,超链接可直接作用于FVS画布,不会被截断于表格组件内。
2.3 支持直接触发FVS的JSAPI
如果对表格组件的单元格设置超级链接-Javascript脚本,无法传递到外层的FVS模板中。如果必须要传递,则在代码前添加parent.window。
但是表格组件(极速版)的Javascript脚本,支持直接传递到外层的FVS模板中。
例如对单元格设置超级链接-Javascript脚本,以切换分页
表格组件代码为:
parent.window.duchamp.switchStory("页面1");
表格组件(极速版)代码为:
duchamp.switchStory("页面1");
3. 使用方法编辑
3.1 新建组件
新建一张「大屏模板」:
在页面中新增一个「表格组件(极速版)」。如下图所示:
3.2 编辑组件
编辑表格组件(极速版),有两个入口:点击组件右上角的「编辑」按钮;或选中组件,点击右侧配置栏的「编辑组件」按钮。如下图所示:
进入表格组件(极速版)编辑页面后,即可按照普通报表的使用方式进行编辑。
编辑完成后,点击「返回大屏编辑器」,即可自动保存并回到画面界面。
4. 表格自适应编辑
FVS大屏的自适应设置,仅对表格组件(极速版)框架生效,不对内容生效。
表格组件(极速版)内容的自适应,需要在表格组件(极速版)编辑界面配置「PC端自适应属性」。如下图所示:
表格组件(极速版)自带优化滚动条功能。
5. 表格加载结束事件编辑
在表格组件(极速版)编辑区域,选择菜单栏「模板>表格加载结束事件」,支持输入JavaScript代码,对该表格组件生效。
但需要注意,表格组件(极速版)仅支持JavaScript脚本,不支持提交入库、自定义提交、发送邮件。
且表格组件和表格极速版组件的JS写法不完全相同,例如跑马灯:
注:详情请参见文档 FVS表格跑马灯 。
1)表格(极速版)组件写法:
开始跑马灯:
setTimeout(() => {
duchamp.getWidgetByName("表格").startMarquee()
}, 500)
结束跑马灯:
setTimeout(() => {
duchamp.getWidgetByName("表格").stopMarquee()
}, 500)
2)表格组件写法:
开始跑马灯:
_g().startMarquee();
结束跑马灯:
_g().stopMarquee();
6. 不支持的功能编辑
表格组件(极速版)与普通报表.cpt模板的使用方法基本一致。
但以下功能点,表格组件(极速版)均不支持
6.1 菜单栏
菜单栏大部分都支持,但是:
模板:仅支持模板数据集,模板参数,PC端自适应属性。仅支持重复与冻结设置,不支持填报的冻结设置。
单元格:不支持「控件设置」,其余支持。
6.2 预览模式
仅支持强制不分页预览模式,效果同&__bypagesize__=false一致。详情请参见:不分页显示数据
不支持 分页预览、填报预览、数据分析、移动端预览 等等其他预览方式。
6.3 多sheet
不支持多 sheet 。
6.4 控件
不支持控件设置。
6.5 参数
不支持参数界面设置。
6.6 单元格超级链接
单元格中的超级链接,有以下情况均不支持
超链类型 | 是否支持 |
---|---|
单元格超链-邮件 | 不支持 |
单元格超链-动态参数 | 动态参数会直接修改页面url导致页面重新刷新,这种逻辑不适合用在大屏上面 |
单元格超链-联动单元格图表 | 不支持 |
单元格超链-联动悬浮元素 | 新计算引擎不支持 |
单元格超链-JavaScript脚本 | 不支持普通报表的一些JS写法 |
6.7 悬浮元素
不支持悬浮元素。
6.8 图表特效
单元格图表特效中,不支持导出图片,不支持监控刷新,不支持超级链接。
7. 注意事项编辑
7.1 Tomcat 前端报错 400
问题描述
有时预览包含表格组件的 FVS 模板时,前端出现 400 报错,如下图所示:
原因分析
高版本 Tomcat(7.0.76以后)会严格按照对 RFC 3986 规范进行访问解析,而 RFC 3986 规范定义了 URL 中只允许包含英文字母(a-zA-Z)、数字(0-9)、-_.~4个特殊字符以及所有保留字符(RFC3986中指定了以下字符为保留字符:! * ’ ( ) ; : @ & = + $ , / ? # [ ])。传入的参数若不在 RFC3986中 的保留字段中,会报 400 错误。
解决方案
修改 %Tomcat_HOME%/conf/server.xml 文件,增加下面代码:
maxpostsize="209715200"
maxHttpHeaderSize="16384"
relaxedPathChars="[]|"
relaxedQueryChars="[]|{}^\`"<>"
useBodyEncodingForURI="true"
URIEncoding="UTF-8"
如下图所示:
修改后重启工程。
8. 已完成模板编辑
已完成模板请参见:FVS表格极速版组件示例.fvs