FVS-V2.x更新日志

移动端接口适配

FVS 插件为 V2.6.0 及之后版本，且 App 版本为 11.0.91 及之后版本，支持在 App 中使用以下接口。

详细介绍可见：移动端专有 、移动端的 JS 接口。

单选按钮组图文按钮支持删除图标

FVS单选按钮组控件 选择「图文按钮」样式模板时，V2.5.1 之前版本不支持删除图标。

V2.5.1 及之后版本，支持鼠标悬浮图标，点击右上角删除按钮删除。

移动端支持收藏FVS模板

使用 V2.5.1 及之后版本的 FVS 插件，在移动端可使用收藏功能，将从目录页中打开的 FVS 模板收藏到「常用」列表。

详情请参见：[通用]常用 。

移动端支持批注分享FVS模板

App 满足 V11.0.91 及之后版本，FVS 插件满足 V2.5.1 及之后版本，FVS 模板支持使用批注分享功能。

详情请参见：[App]模板分享功能 。

数据集名称修改联动组件修改

V2.5.1 版本之前，若组件绑定了数据集，数据集名称变化后，组件需重新绑定数据集；V2.5.1 及之后版本，数据集名称修改可联动组件修改，无需重新绑定。

但需要注意以下几点：

• 使用公式获取的数据集字段，不支持联动修改。

• 场景地图和三维组件，在进入组件编辑界面后，不支持联动修改。

组件报错提示优化

对 FVS 前后台报错进行了统一设计和优化，遇到报错可到 错误代码汇总及解决方案 文档，搜索错误代码查看对应解决方案。

监控视频组件性能优化

V2.5.1 之前的版本中 监控视频组件 使用  RTSP 或 RTMP 协议时，一个页面最多不超过 6 个监控视频组件，否则会导致视频无法播放。

升级 FVS 插件至 V2.5.1 及之后版本且「FineVis流媒体处理依赖」插件至 V1.9 及之后版本；并参考 fine_conf_entity可视化配置 修改 WebSocketConfig.randomSession 参数值为 true ，页面不再限制监控视频组件数量。

三维城市场景开放雾效果开关

三维城市场景环境效果默认有雾效果，但 V2.5.0 之前的版本中，雾效果无设置项，无法关闭。

V2.5.0 版本开放雾效果开关，默认开启，可自行关闭雾。

新增接口getAllPages

V2.4.1 版本对模板分页、表格组件分页、Tab组件标签页相关 API 接口进行了统一设计，V2.5.0 版本补充 getAllPages 接口，可获取所有页面。

FVS统一模板分页、表格分页、Tab标签页API

V2.4.1 版本对模板分页、表格组件分页、Tab组件标签页相关 API 接口进行了统一设计，新增以下接口：

• 获取页：getPage() 、getPreviousPage() 、getNextPage() 、getFirstPage() 、getLastPage() 、getCurrentPage()
  

• 操作页，需结合获取页接口使用：setVisible() 、isVisible() 、goto() 、getName() 、getIndex() 
  

需要注意的是新接口的页索引统一从 1 开始，详细说明参见表格：

详情请参见：FVS页面接口 。

标题组件适配setValue接口

setValue 接口主要用于给控件组件赋值，V2.4.1 及之后版本，该接口也适用于 标题组件 。

三维数据标签支持跟随TRS插值动画

V2.4.1 之前版本，数据标签不支持跟随模型动画移动。

V2.4.1 及之后版本，数据标签支持跟随 TRS插值动画移动，不支持跟随骨骼动画、形态键动画移动。

轮播类型组件悬浮暂停逻辑优化

V2.2.0 版本，FVS 中支持轮播效果的组件或某些动画效果，支持了鼠标悬浮暂停轮播或动画，鼠标超过 3s 无位移或移出组件，轮播或动画继续。

V2.4.0 版本，对该设计进行了优化修改，详情参考下表：

新增查询按钮

FVS 模板使用控件查询时，修改控件值后会自动触发查询。新增查询按钮，关联控件后，可实现点击查询按钮，再触发控件查询。

详情请参见：FVS查询按钮 。

新增点击切换三维自定义视角事件

点击交互事件新增「三维自定义视角」事件，无需复杂 JS ，即可实现三维场景视角切换。

详情请参见：FVS点击切换三维自定义视角 。

三维漫游路径优化

三维漫游动画效果优化，漫游路径中视角参数配置项优化，支持手动修改。

详情请参见：三维场景漫游路径动画 。

轮播器组件升级Tab组件

轮播器组件改造升级为 Tab 组件，支持添加多个标签页，标签页支持组件/组合自由布局，支持最多 3 层 Tab 嵌套。

详情请参见：FVS-Tab组件 。

支持定时调度选择模板

报表服务器满足 11.0.24 版本且 JAR 包版本在 2024-01-26 及之后，支持定时调度选择单个 FVS 模板。

详情请参见：定时调度任务设置 。

目录挂载模板时支持参数设置

FVS 插件 V2.3.1 及之后版本，且报表服务器满足 11.0.25 及之后版本，平台模板挂载模板时支持参数设置。

新增查询面板

FVS 模板新增查询面板设置，启用查询面板后，可以实现控件收缩展开使用，无需添加到画布中使用。

详情请参见：FVS查询面板 。

新增显示/隐藏事件

新增「显示/隐藏」点击事件，通过简单配置即可实现组件显示、隐藏或切换显示/隐藏，无需再通过 JavaScript 事件实现。

详情请参见：FVS显示隐藏组件事件 。

三维组件数据图层标签优化

三维组件数据图层中数据标签样式优化，支持设置边框背景样式等效果。

详情请参见：三维场景组件数据图层 。

组件图层列表交互优化

V2.3.0 组件图层列表选中组件、操作菜单进行交互优化，可实现连选、批量隐藏/锁定/调整层级等等。

详情请参见：FVS组件操作及快捷键 。

新增绝对画布组件

「绝对画布」容器组件相当于一块空白画布，将其他组件拖入绝对画布中，超出绝对画布部分可实现滚动预览。

支持设置「预览时置顶显示」，可实现部分区域冻结于顶部展示。如下图所示：

详情请参见：FVS绝对画布 。

日期时间控件样式优化

日期时间控件内容样式新增快捷按钮，可实现日期前一天（周/月/年）和 后一天（周/月/年）的效果；移动端还支持选择不同样式模板。

详情请参见：FVS日期时间控件 。

下拉框/下拉复选框控件样式优化

下拉框控件和下拉复选框控件 移动端 支持选择下拉样式。

详情请参见：FVS下拉框控件 、FVS下拉复选框控件 。

新增参数全局联动接口

新增接口 linkageGlobal ，无需获取具体组件名称，即可实现参数全局联动。

写法如下：

duchamp.linkageGlobal({a:"参数值",b:"参数值"});

注：V2.2.0 版本暂不支持 数据门户插件 ，请谨慎更新。

新增时间组件

在 FVS 中，一般使用 标题组件 写公式+监控刷新实现实时时间，但频繁请求刷新会对服务器造成较大压力。

因此 FVS 专门推出了「时间组件」，获取客户端本地的时间并默认定时刷新，以满足实时显示日期时间、星期的场景。

详情请参见：FVS时间组件。

三维组件场景视角优化

三维城市场景组件 和 三维自定义场景组件 三维场景视角优化，支持配置缩放距离、垂直角度等基础属性。

支持添加多个相机视角，为视角绑定模型后，可帮助用户快速定位到想要的位置。

详情请参见：三维场景相机视角 。

FVS画布中选中组件交互优化

• 当有多个组件重叠导致组件被遮挡时，鼠标悬浮要选择的组件上方，单击鼠标右键，点击选择图层，展开组件图层列表，即可快速选中组件。

• 按住 Ctrl 键，可使用鼠标左键快速选中组合中子层级的组件。

详情请参见：FVS组件操作及快捷键 。

FVS轮播类型组件支持鼠标悬浮暂停

FVS 中支持轮播效果的组件或某些动画效果，支持鼠标悬浮暂停轮播或动画，鼠标超过 3s 无位移或移出组件，轮播或动画继续。

覆盖场景如下：

• 轮播器组件 自动切换标签页

• 三维组件相机视角 的视角变化运动效果

• 扩展图表类型的轮播或动画效果

• 模板分页自动切换 效果

注：V2.1.1 版本暂不支持 数据门户插件 ，请谨慎更新。

新增PC端移动端模式切换按钮

新增 PC端/移动端 模式切换按钮，根据选择的模式，会展示对应模式下支持的所有配置，预览效果也为对应模式效果。

详情请参见：FVS移动端属性 。

三维场景内模型操作能力增强

三维组件场景编辑界面，针对自定义模型操作能力做了增强优化，操作模型更便捷。

• 支持在列表中或场景编辑界面多选模型，并批量复制粘贴

• Gizmo 工具新增 XZ 平面移动功能，可随意移动模型在水平面的位置

• 移动、旋转和缩放模型后，支持撤销还原

详情请参见：FVS三维自定义场景组件 。

FVS分页支持设置隐藏显示

支持设置分页在预览时隐藏，隐藏后预览时则不显示，不影响设计器内编辑操作。

详情请参见：预览时隐藏分页 。 

FVS设计器内支持画布全屏

支持通过快捷键 Ctrl+\ （Mac 系统为 cmd+\）进入或退出画布全屏，画布全屏作用仅为放大展示，当前模板工具栏、配置项面板等均隐藏，无法进行功能配置，但画布内支持的操作仍可进行。

详情请参见：画布显示比例 。

创建模板交互优化

新建可视化看板 时，可通过双击对应区域快捷创建看板：

• 创建空白看板，可双击尺寸区域快捷创建对应尺寸的看板

• 从模板创建看板时，双击需要的模板，可快捷创建对应看板
  

组件字体支持模糊搜索

标题组件、 富文本组件 以及使用到该字体设置相关的功能，均支持字体模糊搜索，方便快速查找定位字体。如下图所示：

注：若是图表或表格中的字体设置，由于实现方式不同，暂不支持搜索。

接口适配及优化

1）接口 showDialog 优化，支持宽高使用百分比表示占浏览器窗口的比例。

2）适配 setMaxAndMinDate 接口，用于设置日期时间控件的可选日期范围。

组件新增边框线设置

FVS 组件样式新增「边框线」设置，可为组件设置「无、实线、点线、虚线」四种类型的边框线。如下图所示：

详情请参见：FVS组件样式属性 。

控件组件新增内容样式

FVS 所有控件新增「内容样式」，不同的控件内容样式也有些许不同，例如下图所示：

详情请参见：FVS控件组件 。

分页复制粘贴交互优化

分页复制粘贴交互操作优化，提升交互体验。

详情请参见：FVS分页属性 。

下拉树/视图树适配移动端

下拉树、视图树控件支持移动端预览。

详情请参见：FVS下拉树控件 、FVS视图树控件 。

全局接口新增优化

• 接口 showDialog 优化，除居中显示弹出框外，可实现带引导线的动态显示弹出框。

• 新增接口 getCoordinate ，可获取 FVS 模板在预览状态时，组件/模型的坐标。一般结合 showDialog 接口展示动态弹出框时使用。

图表支持导出图片

基础图表 图表特效 工具栏支持「导出图片」按钮功能。请参考如下版本说明：

下拉复选框控件/复选按钮组控件支持全选

下拉复选框控件、复选按钮组控件新增「支持全选」功能，默认勾选，勾选后可通过选项中的「全选」按钮实现一键全选。

详情请参见：FVS下拉复选框控件、FVS复选按钮组控件 。

轮播器组件Tab样式优化

轮播器组件 Tab 栏样式优化，新增更丰富的模板样式。

详情请参见：FVS轮播器组件 。

FVS模板预览新增导航功能

FVS 模板预览时可点击左下角切换按钮处新增的「页面导航」按钮，可快速切页。

详情请参见：FVS分页属性 。

FVS新增三维页面背景

FVS页面背景新增「三维背景」可实现多分页共用一个三维组件，通过在「三维背景」中添加三维组件，设置三维组件效果、事件等，应用到分页后在分页中设置当页效果，即可引用背景页中的模型、数据及动画效果。且无需开启平滑过渡动画，也能实现平滑切换视角效果。如下图所示：

详情请参见：FVS三维背景应用 。

三维组件结构优化

详情请参见：FVS三维城市场景组件 、FVS三维自定义场景组件 、三维场景组件数据图层 。

1）三维城市组件更名为「三维城市场景」；自定义模型组件更名为「三维自定义场景」。

2）数据图层结构变化，更便于独立设置，支持为图层添加「数据更新后」和「单击鼠标左键」事件，实现模型数据展示、联动交互等效果。

3）「三维自定义场景」组件模型管理功能优化，在模型管理页面，上传模型后可进行模型管理，支持删除模型、载入场景、查看模型详细信息、模型预处理等操作。

新增组件刷新功能

FVS 模板设置新增「组件刷新」功能，可实现真正的基于数据变动的推送刷新功能。

详情请参见：FVS组件刷新 。

弹出框、网页链接事件合并为「网页链接/弹出框」事件

弹出框、网页链接事件合并入口为「网页链接/弹出框」事件，原网页链接「对话框」打开方式合并为「弹出框」打开方式。

详情请参见：FVS点击跳转网页链接 。

FVS新增页面加载效果背景色

FVS 模板在加载中用户可以根据模板的主题颜色自定义加载过程中的页面背景色，默认颜色为透明色。如下图所示：

详情请参见：FVS模板加载效果 。

新增导出接口

1）表格组件 支持 exportReportToExcel 接口，可将 FVS 模板中的表格组件导出为 Excel

2）新增 exportTemplate 接口，可将 FVS模板导出为 pdf、ppt、image

详情请参见：报表导出接口 。

接口showDialog优化

showDialog 在 FVS 模板中新增三个参数，分别为

• padding：内边距设置

• titleStyle：标题样式设置

• backgroundStyle：边框背景样式设置

详情请参见：全局接口-FR 。