Pie/Donut chart

Pie charts (also circle graphs or pie diagrams) represent the values as pieces of a whole. This is visualized as parts of a circle.

Simple pie chart:

images/download/attachments/189435554/dbdoku43-version-1-modificationdate-1729583762441-api-v2.png

If several measured values are available, they are displayed as rings of a circle. In the following image, 2 measured values are displayed:

images/download/attachments/189435554/dbdoku44-version-1-modificationdate-1729583762445-api-v2.png

The following additional options apply to pie charts:

(1) Donut max. outer radius: These are the outer dimensions of the circle specified in % of the available area.

(2) Donut max. inner radius: This is the inner cavity, the 'center hole in the donut' specified in % of the available area.

(3) Donut gap: This is the spacing of the rings specified in % of the available area.

The width of the rings is automatically determined by the above parameters. Again, meaningless values can visually disfigure the pie chart.


images/download/attachments/189435554/dbdoku42-version-1-modificationdate-1729583762438-api-v2.png


The 'Enable 3D' setting is also available for pie charts. However, it is important to note here that optical errors can very easily occur in the interaction with several measured values (i.e. the display of the measured values in rings). The display does not model the real spacing, but draws the rings one after the other.

images/download/attachments/189435554/dbdoku40-version-1-modificationdate-1729583762432-api-v2.png

images/download/attachments/189435554/dbdoku41-version-1-modificationdate-1729583762435-api-v2.png

As can be seen in the example on the left, this results in an incorrect spatial representation.

This cannot be prevented in principle, but a good compromise can be found by adjusting the parameters (1)-(3), as shown in the example on the right.

Processing input data

The data of a measured value can be processed further via the 'Item click' and 'Item double click' triggering behaviour.
The object that is passed to the configured behaviour as input data is primarily a data provider, which contains all raw data sets that have been aggregated to the clicked value.
Tip: With the action 'Show raw data of dashboard' this raw data can be displayed in a grid.

Furthermore, this object offers other data fields:

Data field

Description

value

The value that was clicked

category

The value of the category

categoryLabel

The category label

series

The series configuration, which in turn contains the following data fields:

Data field

Description

label

The label of the series

aggregator

The aggregator used (dynamic enumeration)

attribute

The configuration of the attribute used.
The data field name can be read out via the 'dataField' data field

Example

images/download/attachments/189435554/image-2024-7-23_10-1-17-version-1-modificationdate-1729583762411-api-v2.png


images/download/attachments/189435554/image2020-11-4_16-0-31-version-1-modificationdate-1729583762447-api-v2.png

Click on a series value.

images/download/attachments/189435554/image2020-11-4_15-55-33-version-1-modificationdate-1729583762453-api-v2.png

As configured in the behaviour on the far left, the note shows 'category' as the title, and 'series.label' and 'value' as the message.

Special legend settings

In addition to the general legend settings, the appearance of the value ("Value appearance") can also be configured for a pie chart.
You can choose between three modes:

Mode

Explanation

Example

Value

Only displays the value of the category

12

Percent

Only displays the percentage value of the category

35%

Value and percent

Displays value and percentage of the category

12 (35%)