Donut / Pie Chart Section

Overview

The Donut/Pie Chart displays the aggregation of Attribute/Metric data or the count of work items.

When reviewing charts, you can:

• Hover over any data series in the chart to view the values for that slice.
• Export your chart as a PNG file by selecting the settings gear on the section and choosing the “Export” option.

Adding a Chart

1. On a layout in Design mode, open the Add Section dialog.
2. Select the Chart option from the left panel.
3. Choose either the Donut or Pie option under the Single Axis category. The Chart will be added to the layout.

Configuring Donut / Pie Chart Settings

After successfully creating a new Chart section, follow the steps below to fully configure the section. These options can be edited on an existing Chart section via the Settings dialog while in Configure mode on a layout.

Data

1. Click on the Settings icon (gear) at the top right of the Chart.
2. Select Settings.
3. Define the Datasource: the template(s) where the data is defined or the type(s) to count. In the Type field, open the drop-down menu to see all available templates. Select one or more templates to define the type.
4. Optionally, locked Filters can be set when configuring a Chart section. These filters will apply to all content in the Chart and cannot be seen or edited by end users viewing the Chart. Page Filters can be referenced using the injected expression syntax: {!toFilter(API_Name__f)}. Refer to the Page Filtering article for more details on configuration.
   1. The Attribute drop down menu will show attributes from the template(s) type selected. Select an Attribute.
   2. If the Attribute has Data Sets enabled, define the Data Set. Otherwise, it will default to ‘Actual’.
   3. Enter a value into the Value field. Filtering syntax can be found here.
   4. Add another filter by clicking Add Filter.
   5. Remove a filter by clicking the trash icon next to the filter.

Display

On the Display tab, you can adjust the type of Chart to display, the aggregation type (Attribute Aggregation or Record Count), select values to display (Attribute Aggregation), format the values, and configure additional chart display options.

Follow the steps below to configure the Chart Display:

1. Select a Chart Type.
   • Donut Chart: Displays a Donut chart with the total value/count in the middle.
   • Pie Chart: Displays a Pie chart with no total visible.
2. Determine the Values in the Chart by selecting either Attribute Aggregation or Record Count.
   • Attribute Aggregation: Aggregate attribute/metric values from the specified template(s). Select the Attribute (Number, Name/Value Pick List, Name/Value/Icon Pick List) or Metric and Data Set. The Aggregation method will always be Sum.
     • Note: Only the Numeric Value from the Pick List will be displayed on the Card section
   • Record Count: Counts the total number of instances for the specified template(s).
3. (Optional) Enable the ‘Format Values’ toggle to modify the Label displayed when hovering over the Chart. If left default, the Label will be the Value (Attribute/Metric) name.
4. Select a Grouping from the Slice By (Group By) from the drop-down menu. This setting determines the slices of the Donut/Pie Chart. You can slice by Association, Item Name, Pick List or Checkbox. Depending on your selection, you will be able to format the values via the toggle.
   • Sliced by Association: Enable the ‘Label for Empty Values’ checkbox to include items with empty Association values and define their Label & color.
   • Sliced by Pick List: Pick List options can be re-ordered by clicking and dragging on the grabber icon. Individual Pick List options can be disabled from being displayed in the Chart by de-selecting the checkbox left of the Value. Labels and colors can be modified as well.
   • Sliced by Checkbox: Options can be re-ordered by clicking and dragging on the grabber icon. Labels and colors can be set as well.
   • When slicing by an Item Name or Association, the Out-of-the-box Color attribute will be used for the respective work item’s value in the chart.
5. Under the Options accordion, you can define whether the chart values or labels are displayed at all times.
6. Save and Publish your changes.