Donut Chart Widgets
Use the Donut Chart widget to display a donut chart. Each slice in a donut chart corresponds to a field in the data received over the associated data channel.
The Data Field and the Chart Colors properties refer to the donut slices using a numbering scheme. Slice number 1 is the top right slice with numbering continuing clockwise:
The Start Angle and Donut Size properties determine the orientation and size of the donut. A default donut chart has a start angle of 0 (zero) and a size of 360 degrees. To create a partial donut, set the start angle to the angle at which you want the first slice to appear and specify the size of the donut, also in degrees.
For example, to create the following gauge-like semicircle donut, set the start angle to 270 and the donut size to 180. The first slice starts at 270 degrees with the data sources organized clockwise.
Widget properties:

The Data Channel property enables you to select the data stream over which you want to feed data into the widget. Before you can select a data stream, you must send data to BVD, addressed to the data channel you want to select for your widget.
Example:
To show the rise and fall of the temperature in your store in New York City, select the following data channel for your widget:
The data received includes the following:
type: Temperature
element: Monitor
value: 20.9 status: #008000

Select one or more data fields in the data that BVD received through the data channel to display in your widget.

Sparkline, line, and area charts as well as status image and text value widgets support only one data field.
For single data fields, BVD assumes that the data includes the data field value
and uses the values received for value
in the widget.
Default: value

Multiple area, bar, and donut charts support multiple data fields. Select a data field for each area, bar, or slice in the chart. If you select more than four data fields, BVD automatically chooses the colors of the additional fields.
Donut charts only. If you select only one data field for a donut chart, a second one will be automatically generated based on the max value. For details, see Max Value in Donut Charts.
Example Donut Chart:
The donut chart in the OMi sample dashboard displays the five data fields representing the number of events per severity, resulting in a donut with five slices:

The Start Angle property determines the location of the first slice in a donut chart. By default, the first slice (or data field) starts at 0 (zero) degrees within the 360 degrees of the circle of the donut chart.
Default: 0 (zero)

The Donut Size property configures the size of a donut chart within the 360 degrees of the circle of the donut chart. By default, a donut completes a full circle (360 degrees). To create a gauge-like semicircle, set the donut size to 180 degrees.
Default: 360

The Donut Hole Size property configures the size (in percent) of the hole in the middle of a donut chart. To create a pie chart, set the donut hole size to 0 percent.
Default: 35


Set Max Value to set the maximum value the chart should display.
Default: 100

Set Max Value to set a maximum value for the chart. Setting the Max Value property is only relevant for donut charts with only one data field. If two or more fields are selected, Max Value is disabled.
Default: 100
Example Donut Chart:
If the current value of the data field is 30 and Max Value is set to 100, the donut chart will display two slices: one slice with the value 30 and the other slice with the value 70.

Line, sparkline, area, and multiple area charts have a min and a max value property. Set Min Value and Max Value to adjust the range of data displayed in the chart. Data outside this range is cut from the chart.
If Chart Autoscale is used, the min and max values are ignored.
Default: 100
Examples:
The following three sparklines have the same size and show the same data. The scaling, however, differs because of different min and max values or Autoscale:

Use the Reverse Order of Data Fields property to change the display order of the donut slices (or data fields) from clockwise to counterclockwise. This property is useful when your donut chart starts at an angle contrary to the natural reading direction.
For example, to create the following gauge-like semicircle donut, set the start angle to 90 and the donut size to 180. The first slice starts at 90 degrees with the data sources organized clockwise. To change the order of the slices to counterclockwise, click the Reverse the Display Order of the Data Fields check box in the donut widget properties.
Default: not selected

The Show Chart Numbers property has the following effect:
-
Bar and donut charts. Shows or hides the numbers.
You can customize the formatting of the numbers (for example, change color or font) by reformatting the number "1" in Visio.
-
Line, area, and multiple area charts. Shows or hides x- and y-axes. See also Showing or hiding x- and y-axes.
You can customize the x- and y-axes by changing the font and color in Visio.
Default: selected
Tip: Use the Number Format property to format or manipulate the values.

The Chart Colors property enables you to set colors for your charts. Provide a semicolon-separated list of RGB color codes in hexadecimal notation.
You can choose the coloring of the first four colors by changing the colors in Visio. However, the colors you specify in the Chart Colors property override the colors defined in Visio.
If you specify only one color, BVD uses this color for the first data field, and uses the Visio-defined colors for data fields two to four. If more than four data fields but no colors are defined, BVD randomly chooses a color for data fields five and higher.
Default: not defined
Example Donut Chart:
The donut chart in the OMi sample dashboard uses the following color codes:
FF0000;FF9933;C8C800;33CC33;B2B2B2
They color the donut chart like this:

Use the Number Format property to format or manipulate the values displayed below the charts.
Number format works as documented here: http://numeraljs.com/
Number format respects the current locale for formatting.
Example:
'$0,0.00'
This example changes the number 1000.234 to the string $1,000.23.

The Visibility Rule property enables you show or hide the widget based on the outcome of a rule.
Tip: You can also use the Status Visible Group widget to show or hide a widget. Use the group widget when you want to show or hide non-BVD shapes, or to show or hide a large number of shapes. Then it is easier to group the shapes with the Status Visible Group and set the visibility rule in the group widget. See also Status Visible Group.
Visibility rules have the following format:
<property><operator><value>
<property>
- The name of the data property to use to calculate the visibility.
<operator>
- The operation that is used to compare the current value of the property with the given value. For a list of operators, see Rule Operators.
<value>
- The value the operator works on.
Example:
errors>=10
If the value of the data field errors
is greater than or equal to ten, the widget is shown in the dashboard. In all other cases, the widget is hidden.

The Hyperlink property enables you to link a widget to another dashboard or to a URL. When a user then clicks the widget, the linked dashboard or URL opens and replaces the current dashboard in the browser.
You can add variables from dashboard templates to the URL. Variables will be replaced by their assigned value when an instance is viewed. Add variables to the URL in the format ${variable}
.
For example, a company uses a URL in a dashboard template to show the floor plan of their company location. They use different instances for each location and want to show the floor plan specific to each location.
The following URL replaces the query value with the value of the variable location
that is assigned to the instance:
https://example.com/office-locations/floor-plans?site=${location}
When viewing the instance with the assigned value Atlanta
, the floor plan for the company location in Atlanta is shown. The location
variable is replaced with Atlanta
in the URL: https://example.com/office-locations/floor-plans?site=Atlanta
If the variable is not defined or the template is converted back into a dashboard, the variable expression in the URL is not resolved.
For more information on templates and variables, see Template Manager.