历史版本9 :FVS表格组件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:
注:本文内容仅适用于插件版本为 V1.4.0 之前的「表格组件(极速版)」。V1.4.0 版本及之后的插件,不再适用。

目录:

1. 概述编辑

适用场景:安装了「FVS大屏编辑模式」插件的用户,可参考本文了解 FVS 模板的相关功能。

1.1 版本

报表服务器版本
JAR包FVS大屏编辑模式(beta版)版本
11.02021-11-15V1.1.0

1.2 功能简介

表格组件(极速版),与普通报表.cpt模板的使用方法基本一致。

注:本文仅为大家介绍表格组件(极速版)特有功能,其他属性不赘述。

组件交互请参见:FVS组件框架交互属性 。表格组件仅支持监控刷新设置。

组件动画请参见:FVS组件框架动画属性 。

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

2. 组件特点编辑

相比于表格组件,表格组件(极速版)有以下特点:

2.1 加载速度快

表格组件使用 iframe 的方式渲染,表格组件(极速版)使用 canvas 的方式渲染。相同内容,表格组件(极速版)的加载速度更加快。

表格组件:

普通表格组件.gif

表格组件(极速版):

极速版表格组件.gif

2.2 弹出框作用全局

表格组件(极速版)不存在 iframe 的局限性,超链接可直接作用于FVS画布,不会被截断于表格组件内。

局限性.gif

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 报错,如下图所示:

1615797923419212.png

原因分析

高版本 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"

如下图所示:

1618987868871203.png

修改后重启工程。

8. 已完成模板编辑

已完成模板请参见:FVS表格极速版组件示例.fvs