Bar Chart

A Bar chart enables you to compare values for a group of items that are not in any specific order across different categories, using vertical bars.

How to configure the table data to bar chart

The Bar chart needs a minimum of one value element and one column element to showcase. The measure column or expression column that you would like to analyze can be dropped into the values block. The dimension column that you would like to categorize the measure column can be dropped onto the columns block. If you would like to categorize based on a series column, then the respective dimension column can be dropped onto the Rows block in addition. These blocks are composed into a data pane.

The following steps explains the data configuration of bar chart:

1. Drag and drop the icon for the column chart control from the toolbox into the design panel. You can find the control in the toolbox by searching.

2. Resize the widget as required.

3. Click the Data Source button in the configuration panel.

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

5. In the connection type panel, click on any one of the listed connection type buttons. (Here, the Microsoft Excel connection type is selected for demonstration.)

6. In the NEW DATA SOURCE configuration panel, please fill in the connection type and the related details. Then, proceed to click the Preview & Connect button.

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

8. Click the Properties icon in the configuration panel.

9. The properties panel of the widget will be displayed as shown in the following screenshot.

10. Now, switch to the ASSIGN DATA tab.

11. The ASSIGN DATA tab will be opened, displaying the available columns from the connected data source.

Adding fields to Value(s)

Bind column by dragging and dropping the element from sections to values.

IMPORTANT:

• The field that is added in this section will act as a measured value.
• It is a mandatory section for the widget visualization, and any number of fields can be configured in this section.

Settings menu options

You can filter and format the data displayed in the widget from the settings menu options. To open the settings menu, click the settings icon.

The following screenshots show the various options in the settings menu, based on the type of field configured in the section.

Changing the aggregation type

You can change the aggregation type of the measure section from the settings menu, as shown in the following screenshot. Please refer to this section for more details.

Filtering data

You can use filters to change the values by selecting the Filter option. For more details, refer to the Measure filter and dimension filter.

Removing the fields

To remove the added value fields, click on the highlighted button.

Adding fields to Column(s)

Please drag and drop the elements from the sections to the columns.

IMPORTANT:

• The field added in this section will serve as a dimension value.
• This section is optional, and adding more than one value will enable drill down.

Settings

You have the ability to change the settings.

Renaming fields

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

Sorting

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

Filtering data

You can apply a filter by selecting the Filter(s) option in the settings. For more details, refer to the filter.

The chart will be displayed in this manner.

Similarly, you can add the Measures and Expression Columns into the column field.

Adding fields to Row

Please drag and drop the elements from the sections to the Row.

How to format bar chart widget

You can format the bar chart for a better illustration of the view you require by using the settings available in the Properties tab.

General settings

Name

This allows you to set the title for this bar chart widget.

Subtitle

This feature enables you to establish a subtitle for the bar chart widget.

Description

This feature enables you to provide a concise explanation for this bar chart widget.

Basic settings

Show Tooltip

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

Enable animation

It animates the measure values by toggling the Enable Animation feature.

Show value labels

This feature enables you to switch 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 color of the value label.

Value Label Position

This option allows you to customize the position of the value labels in the chart. By default, it is set to Auto, so the label position for the area chart will be set as Top.

Value label rotation

This allows you to define the rotation angle for the value labels to be displayed.

Column Width

This option allows you to increase or decrease the width of the column by using the Column Width.

Column Spacing

This option allows you to increase or decrease the space between the columns by using the Column Spacing.

Legend Settings

Show legend

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

Enabling the Custom Legend Text option will allow you to define a custom text, using the text area, to display for each legend series selected in the combo box in a chart.

Legend Interactivity

The chart’s legend interactivity option allows you to control the behavior of the chart legends. This option provides the ability to make chart legends non-clickable, which can be particularly useful in scenarios where you do not want users to hide or show series data by clicking on the legend. This feature might also be helpful when displaying critical pieces of data that should always be present for accuracy and contextual 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.

Legend Label Color

This enables you to modify the title and label colors of the chart legend.

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.

Legend 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.

Legend 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 wrapping or trimming.

Trim

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

Wrap

This option allows you to wrap legend items based on the value of Text Width.

Text Width

This option allows you to set the maximum width for the Legend Items, and it 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, which are Legend color, Legend position, customization button and Legend title are also hidden.

NOTE: For single series, Legend wont be visible.

Axis Format

This option allows you to format the values of the primary and secondary axes using the formatting details provided by using the Format button. For more information, please refer to this measure format.

Axis settings

This section allows you to customize the axis settings in the chart.

Title color

This feature enables you to customize the color of the axis title.

Label color

This enables you to customize the color of the axis label.

Show category axis

This feature allows you to switch the visibility of the category axis.

If you disable the Show Category Axis option, dependencies properties, which are Show axis title, Axis title text, Trim overflow mode, Trim axis labels, Label Rotation and Auto Interval option will be hidden.

Category axis title

This allows you to edit the title of the category axis for the chart. It will be reflected as the name of the x-axis on the chart.

If we uncheck the Show Axis Title property, the Axis title text box property will be hidden.

Label overflow mode

This feature allows you to manage the display mode of the overlapping labels on the category axis.

Trim

This option trims the end of the overlapping label on the axis.

Hide

This option hides the overlapping label on the axis.

Trim Axis Labels

This option allows you to trim the axis labels based on the value of the Maximum Label Width property.

Label Maximum Width

This option allows you to set a maximum width for the axis labels, and it can also be customized when the trim axis label option is enabled.

Category axis label rotation

This allows you to define the rotation angle for displaying the category axis labels.

Auto Interval and Interval

By default, the Auto Interval property is enabled. The Auto Interval property is used to automatically set intervals based on the number of data points for category axis labels. If a user wants to customize the interval, they need to disable the auto interval and set the desired interval.

Primary value axis

If you disable the Show Primary Axis option, dependencies properties, which are Axis title, Axis title text, Axis type and Axis Format properties will be hidden.

This feature allows you to enable the primary value axis for the chart.

Primary axis title value

This allows you to edit the title of the primary value axis. It will be reflected in the y-axis name of the chart.

Inverse Axis

By default, the chart axis shows positive values at the top and negative values at the bottom. However, there are times when we need to invert the axis and display negative values at the top and positive values at the bottom. For example, when we bind temperature data to the chart and want to display negative values at the top, we can utilize this property.

Enabling this property will cause the chart to display negative values on the top and positive values on the bottom.

Axis range settings

This feature allows you to manually set the minimum, maximum, and interval values of the primary value axis through the Axis Range Settings dialog.

It will be reflected in the primary value axis of the chart.

Parameter Support in Axis range:

This feature allows you to dynamically set the minimum, maximum, and interval values of the primary value axis using the Axis Range Settings dialog and the values of dashboard parameters. Only number-type dashboard parameter values can be used in the axis range properties. It is possible to create multiple types of dashboard parameters.

1. Single parameter value.
2. Range parameter value.
3. Data source field based parameter values.

For more details about dashboard parameter, refer to the Dashboard parameter documentation.

Single Parameter Value:

A single value is stored in this type of parameter.

1. Create a dashboard parameter in the number type as shown below.

Click on the axis range settings dialog and enter @ in the textbox. Select the parameter value (Numeric parameter values are only allowed in the minimum, maximum and interval).

Now the parameter value is reflected in the chart axis.

Range Parameter Value:

If you want to set the same ranges in multiple cases, create the parameter value for the range type. This type of parameter includes the start and end values.

1. Create a parameter in range type.

2. Click on the axis range settings dialog and enter @ in any textbox (minimum, maximum, and interval). The range parameter is divided into start and end parameters. The value of the first textbox is stored in the start parameter, and the value of the second textbox is stored in the end parameter. Select the parameter value (only numeric values are allowed).

3. The value of the parameter is reflected on the chart axis.

Data Source Field Based Parameter Value:

1. Create a parameter in the data source type, choosing any field. The value should be based on the selected field value.

2. Click the axis range settings dialog and enter @ in any textbox(minimum, maximum and interval). Select the parameter value.

3. The value of the parameter is reflected on the chart axis.

Axis Type

This allows you to change the type of axis in the bar chart.

Linear

This option allows you to specify the type of axis as linear.

Logarithmic

This option allows you to handle the logarithmic axis, which uses a logarithmic scale. It is very useful for visualizing data with values that have both a lower order of magnitude (e.g., 10-6) and a higher order of magnitude (e.g., 106).

Axis Format

This option allows you to format the values of the primary and secondary axis using the formatting details provided through the Format button. For more information, please refer to this measure format.

Gridlines

You can toggle the visibility of each axis gridlines using the property.

Primary Value Axis

This feature allows you to enable the gridlines for the Primary Value Axis in the bar chart.

Secondary value Axis

This enables you to enable the gridlines for the Secondary Value Axis in the bar chart.

Category Axis

This enables you to enable the gridlines for the Category Axis in the bar chart.

Font settings

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

Auto font Size and font size

By default, the ‘Auto Font Size’ property is enabled. Auto font size property is used to set font size based on the dashboard viewing client machine resolution. If the user wants to customize or set fixed font size, then the user needs to disable auto font size and set the required font size.

Container Appearance

This sections allows you to customize the Container Appearance for the bar chart widget.

Title Alignment

This allows you to handle the alignment of 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 based on the screen resolution.

Font Size

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

Subtitle Auto Font Size

`On enabling Auto Font Size, the font size of the subtitle will be adjusted automatically based on the screen resolution.

Font Size

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

Auto Padding

When Auto Padding is enabled, the padding of the widget container will be automatically adjusted 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 feature enables you to switch the visibility of the border that surrounds 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 10.

Show Background Image

This feature allows you to set the background image for the bar chart widget.

Background Color

This feature enables you to define the background color for the bar chart widget.

Transparency

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

Show Shadow

This feature enables you to toggle the visibility of the shadow surrounding the widget.

Container actions

This section allows you to customize the Container actions for the bar chart widget.

Show Header

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

Allow Maximize View

This allows you to enable or disable the maximized mode of the bar 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 bar 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 bar 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 bar 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 bar 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.

To learn more about viewing the underlying widget data, refer to the view data documentation.

Pin widget

This allows you to pin the widget.

Responsive Behavior

We hide the widget elements based on the size of the widget for better readability.

When the chart is displayed with fewer than 7 columns on the X-axis, the X-axis labels and titles will be hidden.

When the chart has been placed with fewer than 6 rows, the Y-axis labels, Y-axis titles, and gridlines of the chart will be hidden.