All Products
Search
Document Center

DataV:Display query results on a treemap chart

Last Updated:Dec 02, 2024

This article describes the meaning of each configuration items of a rectangular hierarchy chart.

Chart style

Rectangular hierarchy chart is suitable for displaying data with hierarchical relationships and can intuitively reflect the comparison between peers. Compared with traditional tree structure diagrams, rectangular hierarchy chart can make more effective use of space and have the function of displaying the proportion. image.png

Style Panel image.png

  • Search Configuration: Click the Search configuration items icon imagein the upper-right corner of the Style panel. In the Search Configuration panel, enter the name of the configuration items that you want to search for and locate the configuration items. Fuzzy match is supported. For more information, see Search configuration items.

    • Size: the width and height of the widget. Unit: pixels.

    • Positioning: the x-axis and y-axis of the component. Unit: pixels. X-coordinate indicates the pixel distance between the upper-left corner of the widget and the left border of the canvas. Y-coordinate indicates the pixel distance between the upper-left corner of the widget and the upper border of the canvas.

    • Rotate: The widget is rotated around the center of the widget. Unit: degrees.

      • Directly enter the degrees in the Rotation Angle spin box or click the plus sign (+) or minus sign (-) to increase or decrease the value in the Rotation Angle spin box.

      • Click the imageicon to flip the widget style.

      • Click the imageicon to flip the widget style.

    • Opacity: Valid values: 0 to 1. If this parameter is set to 0, the widget is hidden. If this parameter is set to 1, the widget is completely displayed. Default value: 1.

  • Chart name

    Metric

    description

    Custom Margins

    Click the 开关图标icon to control the display of custom margins. If you turn on the switch, you can configure the distance between the rectangular hierarchy chart area and the four boundaries of the widget. Unit: px by default.

    Nested Levels

    Sets the maximum number of nested levels for the rectangle hierarchy chart.

    Value tag

    Click the 开关图标icon to display or hide the custom tag value. Sets the font style, text weight, font size, and color of the rectangle hierarchy chart value label text.

    UI page

    Click the 开关图标icon to control the display of the legend style of the rectangle hierarchy chart.

    • Page Flip Allowed: If you turn on the switch, the page number style and arrow style of the legend are enabled. If you turn off the switch, the legend content is displayed on one page and cannot be flipped.

    • Layout: the position of the legend relative to the start coordinates of the widget. Valid values: Top Left, Top Center, Top Right, Bottom Left, Bottom Center, and Bottom Right.

    • Legend Marker: the shape type and size of the legend. Unit: pixels.

    • Legend Text: Rectangle hierarchy chart the font style, weight, font size, and color of the legend text.

  • Series: Rectangular hierarchy chart series style description.

    data series: Click the imageor imageicon on the right to add or delete a data series. Click the imageor imageicon to configure the arrangement style of multiple data series. Click the imageicon to copy the selected data series configurations and add a data series with the same configurations.

    Color: the color of each series.

  • Level: Rectangle hierarchy chart level style description.

    Click the imageor imageicon on the right to add or delete a hierarchy. Click the imageor imageicon to configure the arrangement style of multiple hierarchical series. Click the imageicon to copy the current level series configuration and add a level series with the same configuration.

    Rectangle Style: the rectangle style of each layer, including the stroke color, stroke thickness, and transparency.

  • Others: the dialog box style of the rectangular hierarchy chart. The dialog box style appears when you move the pointer over or click the heatmap icon on the preview or publish page. You can click the 开关图标icon to turn the dialog box on or off.

    Metric

    description

    Offset value

    Sets the size of the offset value for the dialog box.

    Text Style

    The style of the text in the dialog box, including the font style, weight, font size, and color.

    Background Box Style

    The style of the background box in the dialog box.

    • Background Color: the color of the background frame.

    • Pin: the padding value of the background frame. Unit: pixels.

    • Border: the border thickness and border color of the background box.

Data Sources panel image.png

Column

Description

name

Used to configure the category name in the rectangle hierarchy chart.

children

Used to configure the values of different categories in the rectangular tree chart.

Configure data items

Description

Data sources

You can use the code editor or visual editor to view the data fields contained in the widget. You can also modify the data type to flexibly configure the component data.

Data Mapping

If you need to customize chart field configurations, you can set different field mapping content in the Data Mapping module and field mapping these content to the corresponding fields of the widget. This allows you to match data without modifying the fields in the data source. You can also click the imageicon to configure the field style.

Configure a filter

Turn on Filter, select an existing data filter or create a data filter, and configure a data filter script to filter data. For more information, see Manage data filters.

Data Response Result

The Data Response Result section displays widget data in real time. If the data source of the widget changes, this section displays the latest data. If the system response is delayed, you can click the imageicon on the right to view the data response result. You can also click the imageicon on the right to obtain the latest data of the widget. You can also click View Example to view an example of the response result of the current component.

Forbid Loading

If you select the check box, you will not see the loaded content during component initialization when you update the component and preview the data kanban. If you select the check box, the opposite is true. By default, the status is deselected.

Controlled Mode

If you select the check box, the component does not request data in the initialized state, and only requests data by using global variables or the method configured in Blueprint Editor. If you clear the check box, you can use automatic update to request data. By default, the status is deselected.

Auto Data Request

Select the check box to manually enter the time frequency of polling to set dynamic polling. If you clear the page, the page is not automatically updated. You need to manually refresh the page or use Blueprint Editor and global variable events to trigger a request to update data.

Advanced Panel image.png

Interaction Occurrences

Description

When a data item is clicked

Turn on the switch to enable the widget interaction feature. When the Rectangle option of the Rectangle hierarchy chart is clicked, a data request is triggered and a temporary variable is thrown to dynamically load data for different Rectangle options. By default, the name, value, and children values in the data are displayed. For more information, see Component interaction configuration.

When you click the legend

Turn on the switch to enable the widget interaction feature. When you click the legend of the rectangle hierarchy chart, a data request is triggered, and a temporary variable is thrown to dynamically load the data of different legends. By default, the name, value, brank, and children values in the data are displayed. For more information, see Component interaction configuration.

Blueprint Interaction

  1. Click the imageicon in the upper-left corner to go to the Blueprint page.

  2. On the Layer Nodes tab, add the widget to the main canvas.

  3. View blueprint configuration parameters. image.png

    • Event

      Event

      Description

      When the rectangle hierarchy chart interface request completes

      The event is triggered with the processed JSON data after a data interface request is responded and processed by a filter. For more information about specific data examples, see the Data Response Result section of the Data Source tab in the right-side configuration panel of the canvas editor.

      When a data item is clicked

      The event that is raised when a Rectangle option of a Rectangle hierarchy chart is clicked, along with the data item corresponding to that Rectangle option.

      When you click the legend

      The event that is raised when the legend of the rectangle hierarchy chart is clicked, along with the data item corresponding to the legend.

    • Action

      Action

      Description

      Request Rectangular hierarchy chart Interface

      This action is performed to request the server data again. The data sent by an upstream data processing node or layer node is used as a parameter. For example, if the API data source for a rectangular hierarchy chart is https://api.test and the data passed to the request rectangular hierarchy chart interface is { id: '1'}, the final request interface is https://api.test?id=1.

      Import Rectangular hierarchy chart Interface

      After data of a widget is processed in accordance with its drawing format, the widget is imported for redrawing. You do not need to request server data again. For more information about specific data examples, see the Data Response Result section of the Data Source tab in the right-side configuration panel of the canvas editor.

      Move

      Move a widget to a specified location. For more information, see the data example.

          {
            // The positioning type. to indicates absolute positioning, whereas by indicates relative positioning. The default value is to. 
              "positionType": "to",
            // The location, which is indicated by the x and y coordinates. 
            "attr": {
              "x": 0,
              "y": 0
            },
            // The animation type. 
            "animation": {
              "enable": false,
              // The duration in which animation is displayed. 
              "animationDuration": 1000,
              // The animation curve, which can be set to linear|easeInOutQuad|easeInOutExpo. 
              "animationEasing": "linear"
            }
          }

      Switch to the implicit state

      Specifies whether to show or hide a widget. No parameters are required.

      Display

      Display the widget. For more information, see Data example.

      {
        "animationType": "",// The animation method. Valid value: fade. If you do not specify this parameter, no animation is generated. 
        "animationDuration": 1000,// The animation delay. Unit: ms. 
        "animationEasing": ""// animation curve
      }

      Hide

      Hide the component. For more information, see Data example.

      {
        "animationType": "",// The animation method. Valid value: fade. If you do not specify this parameter, no animation is generated. 
        "animationDuration": 1000,// The animation delay. Unit: ms. 
        "animationEasing": ""// animation curve
      }

      Update component configurations

      Style configurations of widgets are dynamically updated. In the Style panel, click Copy Configuration to Clipboard to obtain the configuration data of the widget. After that, change the style field for the data processing node in Blueprint Editor.