Doughnut Chart

The Doughnut chart allows you to showcase the proportionality of each item to the total in the form of doughnut slices. It works best to display data with a small number of categories.

How to configure table data in the Doughnut Chart

The Doughnut chart needs a minimum of one value element and one column element to showcase. The measure or expression field that you want to analyze can be dropped into the Values block. The dimension for which you want to categorize the measure can be dropped into the Columns block. To categorize based on a series, drop the respective dimension into the Rows block.

Follow the steps below to configure the data for the doughnut chart:

1. Drag and drop the Doughnut chart onto the canvas and resize it to your required size.

2. Click the Data Source icon in the configuration panel.

3. Click the CREATE NEW button to launch a new connection from the connection type panel.

4. In the connection type panel, click any one of the listed connection type buttons shown. Here, the Microsoft Excel connection type is selected for demonstration.

5. In the NEW DATA SOURCE configuration panel, choose the file path and click the Preview & Connect button.

6. Drag your preferred table or view from the left pane in the data design view and click the Save button.

7. Click the Properties icon in the configuration panel. The property pane opens.

8. Now, switch to the ASSIGN DATA tab.

9. The ASSIGN DATA tab will open with available measures and dimensions from the connected data source.

10. You can add the required data from Measures and Dimensions sections to the required field.

Adding values

You can add more than one measures section to the Value(s) field by dragging the required data.

The doughnut chart will be rendered as follows.

Click Settings to change the required summary type from the available summary types shown in the settings.

You can filter the data displayed in the Doughnut Chart by using the Filter option. For more details, refer to the filter.

You can format the data displayed in the Doughnut Chart by using the Format option. For more details, refer to the measure format

To remove the added value fields, click Remove.

Adding columns

You can add data from the Dimension field to the Column(s) field.

The Doughnut chart will be rendered as follows.

Add more than one value to the Columns field. The following alert message will open.

You can enable this option to get further details about the selected chart region. To enable drill down, click Yes.

NOTE: If you click No, a single value will be added to the Columns field.

The drilled view of the selected chart region will be as follows.

You can change the Settings.

You can sort the dimension data using the Sort option under the Settings menu list. To apply sorting for data, refer to the Sort.

You can apply filters by selecting the filter option in settings.

For more details, refer to the filter.

NOTE: By default, the filter will be set for the top 5 records.

Similarly, you can add the Measures and Expression Columns to the Column field.

Renaming fields

The configured field names can be edited by using the Rename option provided in the settings menu.

Hidden Column

Hidden columns are useful in cases where we don’t want the fields to take part in the visualization, but only to be used for linking, filtering and view data.

We can configure both measure and dimension fields into the hidden column. For measure, we will have all the settings we have for the measure fields except formatting and filtering.

In the case of dimension fields, we will have the following options only. In Date fields, we will have all available types except sorting, relative date filter, settings, and filters.

Linking

The primary use case of hidden columns is linking. On configuring hidden columns, we can see below that the fields configured in hidden columns are listed in the linking section. On configuring the column in linking, we can pass the corresponding column value in the linking parameter.

Measure Based Example: If we wish to pass the number of Matches played as a URL parameter but do not want it to influence the visualization, we can configure the Matches in the hidden columns and incorporate them into the link.

Dimension Based Example: If we wish to pass the number of Team Name played as an URL parameter but do not want it to influence the visualization, we can configure the Team Name in the hidden columns and incorporate them into the link.

Filtering

You can use hidden columns to filter data in the visualizations. Configure hidden columns and click the below filter icon.

Click the Custom button highlighted in the filter configuration dialog image below. It will list all the fields configured in the widget. Keep the field configured in the hidden column and remove the other fields, then click the Update button.

Now, we can see in the below image, the data is filtered based on the hidden column field instead of the actual column that we bound in the widget.

For more details about filtering the widget data, refer to the Cross Filter Configuration documentation.

View Data

You can view the data in the hidden columns in the underlying data view. This is useful for checking the data in more detail and can help you to identify any issues with the data.

NOTE: We don’t recommend configuring lower hierarchy data in hidden columns as we can see in the info icon in the Hidden Column section denotes the same.

The below chart displays the goals by each team without hidden columns.

If we configure lower hierarchy data (Player Name) in hidden columns compared to column and Row filed data, the data configured in the widgets gets duplicate. This affects the chart visualization as we can see in the below image.

Assigning rows

You can drag and drop the Dimension field into the Rows field.

You can apply filter and sort options for the rows field if required.

This will render a Doughnut chart in a series.

Scroll down to see all charts.

How to format Doughnut Chart

You can format the Doughnut Chart for better illustration of the view by using the settings available in the Properties tab.

To configure data in the Doughnut Chart, follow these steps:

1. Drag and drop the Doughnut Chart into the canvas and resize it to your required size.

2. Configure data in the Doughnut Chart.

3. Focus on the Doughnut chart and click the Widget Settings icon.

The property window will be opened as follows.

You can see the list of properties available for the widget with default value.

General Settings

Name

Allows you to set a title for the Doughnut chart widget.

Subtitle

Allows you to set a subtitle for the Doughnut chart widget.

Description

Set a description for the Doughnut chart, whose visibility will be denoted by an icon, and hovering over it will display the description in a tooltip.

Basic settings

Chart type

Switch the widget view from the current chart type to another chart type.

Enable animation

It animates the measure values when you enable the Enable Animation.

Show value labels

Toggle the visibility of value labels.

If you disable the Show Value Labels properties, the dependent properties, which are color, value label position, value label rotation, and value label suffix, will be hidden.

Value Label Color

This allows you to customize the value label’s color.

Data label

You can define the display format as a category, value, percentage, category and value, value and percentage, category and percentage, or all details.

Category

Value

Percentage

Category and Value

Value and percentage

Category and Percentage

All Details

Value labels suffix

This allows you to show or hide the suffix value of value labels.

Suffix Value

This allows you to customize the suffix value of value labels.

Chart Size

This allows you to customize the size of the doughnut chart. Values can be between 0.1 and 1.

Series Settings

The Series Settings option is enabled only when you configure the series in the Assigned Data tab.

Fixed rows and columns

If you enable the Fixed rows and columns, you can customize the rows and columns. The rows and columns are fixed based on the container size and size of the doughnut chart.

Row count

By enabling the Row Count, you can set the count of the rows.

Column count

By enabling the Column Count, you can set the column count.

Note: If invalid columns and rows are given, the rows and columns reset to their default value. For example, if you are given the number of rows as 6 and the number of columns as 5 but your data count is only 20. In this case, the rows and columns will reset to their default value.

Tooltip Settings

The Tooltip Settings section allows you to customize the appearance and behavior of tooltips in widget visualizations.

Show Tooltip

This option allows you to toggle the visibility of the tooltip in the pie chart.

Customize Tooltip

This option allows you to customize which columns are visible in the chart’s tooltip.

Enable RTL

This option allows you to display fields and their data from right to left.

Legend Settings

Show legend

A legend is a text used to describe the plotted data. It allows you to toggle the visibility of the legend in the chart and change the legend text position by selecting through the combo box.

Enabling the Custom Legend Text option will allow you to define custom text through the text area to display for each legend series by selecting through the combo box in the chart.

Legend Interactivity

The chart legend interactivity option allows you to control the behavior of the chart legends. This provides an option to make chart legends non-clickable, which can be especially useful in scenarios where you do not want users to hide or show series data by clicking on the legend. This might also be useful when displaying critical pieces of data that should always be present for accuracy and context purposes.

Disabling the Interactivity feature in the Legend Settings category does not allow you to click on the legends.

Enabling the interactivity feature in the Legend Settings category allows you to click on the legends.

Label Color

This allows you to change the chart legend title and label colors.

Customize

You can customize the legend text through the Custom Legend Settings dialog. This dialog will show the legend text list as labels on the left and corresponding text area on the right to add the formatted text to display instead.

After customize the legend

Position

You can change the position for the legend to Top, Left, Right, and Bottom.

Legend Item as Dropdown

Legends can be displayed as a dropdown menu when the legend position is set to dropdown. When you hover over a chart, a legend icon appears. Clicking on this icon will bring up a legend dropdown. This feature allows you to toggle the visibility of the legend in the chart.

This option will hide the legends in the chart area, resulting in increased chart space and enhanced visibility.

The chart legend dropdown option can be used to simplify viewing complex charts with multiple data sources. For example, if you have a chart displaying sales data for the different years, you can use the legend dropdown to deselect all other years and focus only on a specific year.

Legend Alignment

Legend Alignment enables you to control how the legend is positioned within its allocated space. For detailed guidance, refer to the Legend Alignment section.

Shape

This allows you to change the shape of the legend.

Circle

This option allows you to change the shape of the legend in a Circle.

Series Type

This option allows you to change the shape of the legend in Series.

Title

This allows you to add the legend title for the chart. It will reflect with the Show Legend.

Text Overflow

This option allows you to customize legend text based on the ‘Text Width’ property value.

None

This option allows you to render legend items without any wrap and trim.

Trim

This option allows you to trim the legend items if its legend exceeds the ‘Text Width’ value.

Wrap

This option allows you to trim the legend items if its legend exceeds the Text Width value.

Text Width

This option allows you to set the maximum width for the Legend Items and is applicable only if text-overflow is set as Trim or Wrap.

If you uncheck the Show Legend property in the property panel, the dependent properties Legend color, Legend position, customization button, and Legend title are also hidden.

Filter

Act as Master Widget

It defines the Doughnut chart widget as a master widget so that its filter action will be shown in other widgets of the dashboard.

Ignore filter actions

It defines the Doughnut chart widget to ignore the filter actions applied to other widgets in the dashboard.

Hierarchical Filter

Through this option, you can enable or disable hierarchical Top N filtering. When applying the Top N filter with multiple dimension columns, the data returned can be customized based on whether the filtering needs to be done as flat or based on the hierarchy of added dimension columns.

When the Hierarchical Filter option is enabled, the Top N will be applied for each individual column separately based on the number set for each column.

Show Filter

This feature allows you to toggle the visibility of the Filter icon for the doughnut chart widget when the Act as Master Widget option is enabled.

Link

You can enable linking and configure navigating to a general URL with or without parameters. For more details, refer to the Linking.

Series palette

By toggling the series palette, you can customize the colors of the proportion series segments.

Font settings

This section allows you to customize the font size of chart elements.

Based On

Color Mapping Type

Using the Color Mapping type, you can apply colors to the series either based on data or index.

Data

It allows you to apply color for chart series based on data. If you want to apply a specific color to specific data, you can use Data based color mapping. By default, the Color Mapping Type will be Data.

IMPORTANT: Only top 100 records will be listed in the dialog.

Index

It allows you to apply color for chart series based on Index. Such that the colors are maintained based on the index even if the data is changed. It shows only 15 different colors. After that, the color will be repeated from above colors.

For example, If you are displaying the countries based on the increasing order of the case count, then the index-based color mapping will be useful to set the colors based on the rank. Say red color to the top, then the red color will be maintained for the country having the largest case count.

Note: We prefer to use Index based color customization only for minimum data(upto 15 series).

Use Default Palette

This option shows when you add more than one measure field to the Value(s).

By toggling off the Use Default Palette, you can customize the colors of the proportion series segments by clicking the colored squares.

Container Appearance

Title Alignment

This allows you to handle the alignment of the widget title to either left, center, or right.

Title Color

This allows you to apply the text color to the widget title.

Title Auto Font Size

On enabling Auto Font Size, the font size of the title will be adjusted automatically if the resolution of the screen varies.

Font Size

This allows you to apply the specified size of the font to the widget title if the Subtitle Auto Font Size is disabled. The value can be between 10 and 32.

Subtitle Auto Font Size

On enabling Auto Font Size, the font size of the subtitle will be adjusted automatically if the resolution of the screen varies.

Font Size

This allows you to apply the specified size of the font to the widget title if the Subtitle Auto Font Size is disabled. Value can be between 10 and 32.

Auto Padding

On enabling Auto Padding, the padding of the widget container will be adjusted automatically if the size of the widget varies.

Padding

This allows you to customize the padding of the widget container if the Auto Padding is disabled. The value can be between 0 and 25.

Show Border

This allows you to toggle the visibility of the border surrounding the widget.

Corner Radius

This allows you to apply the specified radius to the widget corners if the Show Border is enabled. The value can be between 0 and 100.

Show Background Image

This allows you to set the background image for the spline area chart widget.

Background Color

This allows you to set the background color of the spline area chart widget.

Transparency

This property allows you to specify the transparency for the background color.

Show Shadow

This allows you to toggle the visibility of the shadow surrounding the widget.

Mobile Height Factor

This option allows you to resize widgets specifically for mobile view.

Container actions

Show Header

This allows you to enable or disable the widget title of the spline area chart.

Allow Maximize View

This allows you to enable or disable the maximized mode of the spline area chart widget. The visibility of the maximize icon in the widget header will be defined based on the setting in the viewer.

Allow CSV Export

This allows you to enable or disable the CSV export option for the spline area chart widget. Enabling this allows you to export the summarized data of the widget view to CSV format in the viewer.

Allow Excel Export

This allows you to enable or disable the Excel export option for the spline area chart widget. Enabling this allows you to export the summarized data of the widget view to (.xlsx or .xls) format in the viewer.

Allow Image Export

This allows you to enable or disable the Image export option for the spline area chart widget. Enabling this allows you to export the view of the widget to image format (.jpg), (.png), or (.bmp) in the viewer.

Allow PDF Export

This allows you to enable or disable the PDF export option for the spline area chart widget. Enabling this allows you to export the view of the widget to pdf format in the viewer.

Enable Comments

This allows you to enable or disable comment for the dashboard widget. For more details, refer to the Commenting Widget.

Allow View Underlying Data

This allows you to visualize the raw data associated with a widget at runtime.

Allow Pin

This allows you to pin the widget.