扩展图表插件

1.1 版本

注：建议使用 2020-09-04 之后版本的 JAR 包，获得更好的大屏体验。

1.2 推荐配置

注：该配置是对预览的客户端电脑的要求，不是指服务器。

推荐配置和最低配置如下表所示：

1.3 应用场景

为了满足大屏等场景下的动画及自动播放效果，帆软官方团队基于 WebGL 等技术新开发了扩展图表插件。

插件中包含了一些展示效果酷炫的新图表类型，同时此插件将持续更新，确保扩展图表内容的丰富性，拓展图表在大屏场景下的应用范围。

1.4 使用须知

• 扩展图表不支持导出。

• 扩展图表不支持移动端展示。

• 扩展图表不支持使用任何图表接口。

• 扩展图表只支持在 Chrome 浏览器预览。

1.5 扩展图表类型

目前支持的扩展图表类型有 9 大类共 19 种，如下表所示：

注：每种扩展图表的详细介绍和模板示例可以点击下表中的链接直接查看。

2.1 插件安装

FineReport10.0 设计器安装后就已经默认安装了扩展图表插件，用户启用设计器后，可以直接使用扩展图表设计报表。

点击下载插件：扩展图表插件

设计器插件安装方法参照： 设计器插件管理

服务器安装插件方法参照： 服务器插件管理

2.2 操作方法

1）决策报表

直接从图表管理面板将扩展图表拖拽到决策报表设计主体中。

2）普通报表

选中单元格，点击插入图表按钮，插入相应的扩展图表即可。

2.3 监控刷新

扩展图表 3.5 及之后版本开始支持监控刷新功能，每隔一定时间可以刷新图表数据。

3.1 插件授权

如果想使用扩展图表，需要在 FineReprt 的 License 注册中购买对应的功能。

插件上提示免费，是因为目前不支持在插件商城购买，只支持直接在正式授权文件里给该插件授权。

如果报表服务器工程没有注册或 License 过期，则预览对应的扩展图表时，右下角会提示：正在试用功能—扩展图表( 或第三方图表插件名称 )

3.2 组件刷新

目前扩展图表不支持组件刷新功能，用户若需要，可以通过在图表交互属性中添加 JS 来实现组件的组件刷新效果，详情参见文档：扩展图表组件刷新

3.3 JAR 包依赖

扩展图表插件 4.0 及之后版本依赖于%FR_HOME%\lib下以jxbrowser开头的 2 个 JAR 包，如下图所示：

如果缺少这 2 个 JAR 包，安装扩展图表 4.0 及之后版本，会有报错：扩展图表初始化失败

如果用户发现自己的设计器安装目录下缺少这 2 个 JAR 包，需要根据自己的系统下载 JAR 压缩包，解压后拷贝到目录%FR_HOME%\lib下。

• Windows-32 用户请下载：Win32 JAR

• Windows-64 用户请下载：Win64 JAR

• macOS 用户请下载：mac JAR

3.4 未安装或禁用插件提示

1）打开包含「扩展图表」的模板时，若存在以下三种情况中任意一种：

• 报表目录环境下插件未安装成功或被禁用

• 插件版本低于模板中扩展图表创建版本

• 远程设计时本地与远程扩展图表版本不一致

则会弹出提示：图表初始化失败，无法打开模板。 可能的原因：远程设计扩展图表插件版本不一致、扩展图表插件版本过低或未安装扩展图表插件。建议扩展图表插件同步更新至最新版本后，再进行模板编辑。

且模板打开失败。如下图所示：

此时需使「扩展图表插件」版本保持一致（或同步更新至最新版本）后，再重新打开模板或点击「重试」即可正常打开模板进行编辑。

2）当包含「扩展图表」的模板已经正常打开，此时再禁用或删除扩展图表插件，则「扩展图表」禁止编辑，其他图表可正常编辑，保存模板时保存扩展图表原编辑内容，但此时无法正常预览模板。

3）当包含「扩展图表」的模板已经正常打开，此时切换到远程目录，若远程目录环境下插件未安装成功或禁用，或远程目录下插件版本与扩展图表创建版本不一致，则「扩展图表」禁止编辑，其他图表可正常编辑，保存模板时保存扩展图表原编辑内容，但此时无法正常预览模板。