Extended Chart Plugin

Version

Recommended Configuration

Note:

The configuration requirements are for the client computers that preview extended charts, not for the server.

The following table shows recommended configurations and minimum configurations.

Application Scenario

In order to meet the animation and autoplay effects in large screen and other scenarios, FanRuan developed the Extended Chart plugin based on technologies like WebGL.

The plugin includes some new fascinating charts with impressive visual effects. At the same time, this plugin will be continuously updated, ensuring the extended chart content richness and expanding the chart application range in large screen scenarios.

Usage Instruction

• Extended charts cannot be exported.

• Extended charts are not supported on mobile terminals.

• Any basic chart interfaces cannot be used in extended charts.

• Extended charts can only be previewed in the Chrome.

Extended Chart Type

Currently, the plugin supports 19 extended charts (9 broad types in total), as shown in the following table.

Note:

You can click the following links to obtain detailed descriptions and template examples for each extended chart.

Plugin Installation

The plugin is automatically installed with the FineReport11.0 designer installation. You can directly use extended charts to design reports after opening the designer.

Click to download the plugin: Extended Chart Plugin.

For details about how to install plugins in the designer, see Designer Plugin Management.

For details about how to install plugins on the server, see Server Plugin Management.

Operation Method

1. In Dashboards

Directly drag extended charts from the chart management panel into the dashboard body.

2. In General Reports

Select a cell, click the Insert Chart icon on the top toolbar, and insert the needed extended charts.

Timed Refresh

The Timed Refresh function is supported in the Extended Chart plugin 3.5 and later versions, allowing chart data to be refreshed at regular intervals.

Plugin Authorization

To use extended charts, you need to purchase the corresponding functions in FineReport’s license registration.

The plugin is marked as free in the plugin market, because the plugin can only be directly authorized in the official license file and cannot be purchased through the plugin market.

If the report server project is not registered or the license is expired, a prompt appears in the bottom right corner indicating that you are trying out the function - Extended Chart (or the name of the third-party chart plugin).

Component Refresh

Currently, the plugin does not support the component refresh function. You can achieve the component refresh effect by adding JS in the chart interaction attributes.

JAR Package Dependency

The Extended Chart plugin 4.0 and later versions depend on the related JAR packages starting with jxbrowser in the path %FR_HOME%\lib, as shown in the following figure.

If the JAR package is missing, an error appears after you install the plugin, indicating that the extended chart initialization fails.

If the two JAR packages are missing in your designer installation directory, you need to download the JAR packages based on your own system, unzip them, and copy them to the path %FR_HOME%\lib.

Note:

The current JAR package has been upgraded to 7.22.

Error for Plugin Uninstalled/Disabled

Problem

When you open a template with extended charts, a prompt pops up: "Failed to install the chart plugin (extended chart or chart plugins). If you perform edit and save the template, file corruption will be incurred. Possible reason: During remote design, the chart plugin version is inconsistent, the chart plugin version is too low, or the chart plugin is not installed. You are advised to update the plugin to the latest version before template edit."

The template failed to open, as shown in the following figure.  

Cause

The following paragraphs show possible reasons:

1. The plugin was not installed successfully or has been disabled on the report directory environment.

2. The plugin version is lower than the version in which the extended charts are created in the template.

3. The local and remote extended chart versions are inconsistent during remote design.

4. The plugin has not been fully loaded (namely, not installed) when the designer first starts and the default opened template contains extended charts or other chart plugins.

5. The template is damaged. (Search for "chartx" in the template opened with an editor. If "chartx" can be searched, the template is damaged.)

Solution

1. If the error is caused by the first three reasons, you need to keep the Extended Chart plugin versions consistent or update them to the latest version synchronously. Then reopen the template directly or click Retry to open the template to edit.

2. If the error is caused by the fourth reason, you can perform the following operations:

Install the Performance Optimization plugin, which allows the template not to be opened by default, thus avoiding the error. You can double-click to open the template.

Close the default opened template and reopen it.

3. If the error is caused by the fifth reason, you are advised to recreate a template.