Data Layer in 3D Scene Components

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

Version

Function Description

For both the 3D City Scene component and the Custom 3D Scene component in the FVS template, you need to bind data to the model through the data layer function for realizing events such as model data display and data linkage.

The data layer functions and operation methods of the two components are basically the same. The main difference lies in the data layer type, which causes partial differences of the setting items.

Prerequisite

Before reading this document, you have read FVS 3D City Scene Component and FVS Custom 3D Scene Component in advance to understand the basic functions of these two 3D components.

Four types of data layers (Point-Data Layer, Line-Data Layer, Column-Data Layer, and Model-Data Layer) are available in the 3D city scene component, as shown in the following figure.

Only one data layer (Model-Data Layer) is available in the custom 3D scene component, as shown in the following figure. 

On the Data Layer Setting panel, you can set Layer Name, Dataset, or Style of the data layer.

Layer Name: The name of an added layer is in the LayerX format (among which X represents a numerical suffix) by default. You can modify the layer name. Layer names cannot be duplicate in a 3D scene component.

The setting items vary according to the data layer types. The following specifically describes the setting items of different data layers respectively.

Point-Data Layer

Point-Data Layer allows you to set Dataset and Style, as shown in the following figure.

Line-Data Layer

Line-Data Layer allows you to set Dataset and Style, as shown in the following figure.

Column-Data Layer

Column-Data Layer allows you to set Dataset and Style, as shown in the following figure.

Model-Data Layer

Model-Data Layer only allows you to set Dataset, as shown in the following figure.

The dataset field selected for Model Name on the Data Layer Setting panel of Model-Data Layer must be the same as the model name in the model list for correct matching so that other layer events can be configured normally.

The data layer allows you to add Layer Update events, including Data Label and Data Alert.

Note: Line-Data Layer in the 3D City Scene component does not support the Layer Update events.

Data Label

A maximum of one data label can be added to a data layer, as shown in the following figure.

Note: In versions earlier than V2.4.1, data labels cannot follow the movement of model animations. In V2.4.1 and later versions, data labels can follow the movement of TRS interpolation animations, but cannot follow the movement of skeletal animations or morph target animations.

Label Name

You can customize data label names based on the data layer requirements. The content cannot be empty.

Content

You can select Default or Custom in Content on the Execution Setting panel of data label.

When Default is selected, you can determine whether to display a certain item by selecting/deselecting the button on the left. Click Format on the right to set the format type for data display, as shown in the following figure.

When Custom is selected, you can click Edit Custom Content, and select data fields or enter the text in the rich text editing pop-up box, as shown in the following figure.

Display Form

When Visible is selected, the label will always be displayed on the page. When Hover is selected, the label will only be displayed when you hover the mouse over the data layer during the template preview.

Content Margin

All the text constitutes the content. The distance from the content to the border is called the content margin. That is to say, the size of the border background changes with the content, but the content margin remains unchanged.

Overall Zoom

You can set the overall zoom ratio (ranging from 0.1 to 10) of the label.

Border Background

The default value Resource Center is used. The setting method is the same as that of the component border background setting item. You can select None, Color, Resource Center, or Custom Upload from the drop-down list of Border Background.

Data Alert

Multiple data alerts can be added to a data layer so that different alert messages are displayed when specific execution conditions are met.

You can enable or disable the added data alert, as shown in the following figure.

Note 1: If multiple conditions configured conflict with each other, the condition at the bottom of the list prevails.

2: The alert label only takes effect after the data label has been created.

Alert Name

You can customize the execution action name according to the data layer requirements. The action name cannot be empty, or duplicate in the same layer.

Execution Condition

Click Execution Condition Setting to enter the condition setting page. Then click Add Condition (AND) to add and edit the condition content.

1. The names or content bound to the current data layer can be selected as the alert object. In V2.10.0 and later versions, the field content will be displayed behind the names or content bound to the data layer.

You can select Field, String, or Formula for the value of the alert condition, as shown in the following figure.

2. When multiple conditions need to be met at the same time, you can click Add Condition (AND) to add a condition, click xxx to switch to Add Condition (OR), and add another condition.

On the left of the added conditions, you can switch the relationship between the conditions to be And or Or. You can also add and delete conditions, as shown in the following figure. 

3. When you hover the mouse over + on the right of a certain condition, a sub-condition can be added to the current condition, as shown in the following figure.

Alert Content

You can select Default or Custom in Alert Content on the Execution Setting panel of the data alert. The following figure shows the configured alert condition(s).

Note: Column Height in Alert Style is grayed out and cannot be set for Column-Data Layer.

The effect of Data Alert will replace the original effect of Data Label, as shown in the following figure.

Choose Add Event > Click, select the required event type in the interaction event option pop-up box, and proceed with the specific settings.

The following table shows each event type.

1. The click event of the hidden layer in the past template cannot be triggered after the upgrade, which needs to be manually adjusted.

2. For a dataset field (with empty content) bound to a data label, the data label is not displayed before the upgrade, but displayed with an empty value after the upgrade (which needs to be manually adjusted).

3. If the content is selected for a data label but not selected for a data alert in the past template, the label will be empty for the data alert after the upgrade, which needs to be manually adjusted.