FVS Component Refresh

This document is applicable to users who have installed the FineVis Data Visualization plugin to learn plugin functions.

Version

Application Scenario

The Monitor Refresh function of FVS components initiates a refresh request at set intervals. This function reduces performance somewhat and frequent requests may stress the database.

After Data Push Refresh is enabled, if you enable Monitor Refresh for a component (meeting the data push refresh conditions), the component can realize instant refresh based on data changes.

The effect is shown in the following figure.

Environment Preparation

To realize the data push refresh of a component, ensure that all datasets used by the component meet the data push permission.

Note:

To determine whether a 3D component meets the data push permission is based on its data layers, not requiring all datasets to meet the permission.

That is, the corresponding database needs to be MySQL, SQL Server, or Oracle, and needs to be configured for authorization. 

Function Entry

You can select Enable Data Push Refresh and Enable Only Data Refresh under Template > FVS Template Setting > Component Refresh.

Enabling Data Push Refresh

After selecting Enable Data Push Refresh, you can click Verify Now to verify whether all components (with Enable Monitoring Refresh selected) in the current template meet the data push permission in real time. Then a permission verification list pops up. 

Display fields in the list include the name of Database/Database Table/Dataset, whether the data push permission is met, and the name of Related Component (prefixed with the page name by default).

Data Push Refresh Rule

1. Data push is based on connected WebSocket. The designer platform requires you to log in first and connect to the WebSocket.

Therefore, you need to log in to the decision-making platform for data push refresh to take effect. Otherwise, data push refresh does not take effect and the original monitor refresh rule is retained if you access the template.

2. Enable Monitor Refresh and Data Push Refresh for a component:

·       If the data push refresh permission is met, during preview, the component monitors its data table and refreshes itself only when the component re-requests the updated data.

·       If the data push refresh permission is not met, the component follows the original monitor refresh rule. That is, the component requests data at set intervals.

3. If multiple tab pages are opened in the browser during template preview, the data push refresh may not be realized by default because WebSocket cannot be shared.

In this case, you need to set System Parameter Name to WebSocketConfig.randomSession and System Parameter Value to true through the FINE_CONF_ENTITY Visual Configuration plugin.

Enabling Only Data Refresh

The function takes effect only on the components including custom 3D scene components, 3D city scene components, and Unity components.

The function effect: Only data is refreshed (with real-time interaction retained) when a monitoring refresh or data push refresh is performed. For example, scene perspectives and model animations are unaffected by refreshes.

Note:

Ensure that you have completed environment preparation in above section before performing the following steps.

Creating a FineVis Visualization Dashboard

Choose File > New FineVis Visualization Dashboard in the upper left corner of the designer, click Create a Blank Dashboard, and click Create Dashboard.

Data Preparation

Define the data connection according to the actual database type.

Create a database query.

Designing Components

Designing a Table

1. Choose Text > Table in the component area, drag the Table component into the canvas, and click Edit Component on the configuration panel to open the editing page.

2. Drag the fields in the dataset directly into the cells and click Return to FineVis Visualization Dashboard.  

Designing a Column Chart

Choose Chart > Column Chart in the component area, drag the Column Chart component into the canvas, and bind the data.

Setting Refresh

Enabling Component Monitoring Refresh

Select a component, click Interaction on the right configuration panel, and select Enable Monitoring Refresh. (The functions of both components need to be enabled.) 

Enabling Data Push Refresh

Choose Template > FVS Template Setting > Component Refresh and enable Data Push Refresh. Then the two components added above meet the data push permission.

Demonstration

Log in to the decision-making platform and preview the template. The effect is shown in section "Application Scenario."

Note:

The document takes a local MySQL database as an example and does not provide template examples.