Pie Widget

Pie chart widgets provide a quick way to compare the relative size of parts to a whole. Each part is visualized as a percentage of the whole. If you are working with more than about five data sets, consider using a bar or column widget instead, as it will be easier to visually compare the data.

The pie chart is useful when:

  • You are visualizing just one data series
  • You want to see how much one series contributes to the whole

You select this icon in the widget editor to display the column or bar chart properties:

Example pie chart widgets

This sample pie chart shows how easy it is to visualize the parts of a single data series. This chart reveals the top five failure response codes for a given month. You could create another widget using the same data to look at how the response code rates trend over multiple months, or a table widget showing more detail about the codes themselves, such as the response code descriptions.

Screen shot of a pie chart widget

This example is a standard pie widget showing the percentage of preview lookups by the top 10 mobile operators.

Screen shot of a pie chart widget

How to build it

In the procedures below, we will create a pie widget showing the percentage of lookups performed by mobile operators. We'll base the widget on the report, Preview Daily Detailed report - Yesterday. The steps assume you've already created a dashboard to hold the widget.

Set required properties

  1. From your dashboard, select Add Widget and then select Custom.

    This displays the Add Custom Widget pop-up, which lets you create widgets based on the reports available to you.

    Screen shot of the Add Custom Widget window

  2. Select the plus sign (+) next to the report you want to use for the widget. You can add multiple widgets to the dashboard at once, but in this example we're going to add just one.
  3. Select Done.

    Since we added just one widget, the Edit Widget page displays next. If we had added multiple widgets, then we would be returned to the dashboard and the widgets would be added in the default List style.

  4. Under Properties and Type, select the pie icon.

    Note that the widget inherits the name of the report you based it on. You can change this if you like. The widget name will eventually display in the upper left. This can function as the only name for the widget or you can also give the widget a title. See step 1 under "Set Optional Properties".

  5. For Data Series, select the data to be represented by each 'slice' of the pie. For our example we'll select Message Originator.

  6. For Series Values, select the report column you want to use for your data series.

Set optional properties

  1. Give your widget a Title. This will display in the center of the widget. We'll call our example, Percent Delivered Messages by Originator.
  2. Specify whether the widget will span the Full width of the page or Half width.
  3. Apply a specific Color Theme to the chart.
  4. Specify which Report Instance to use. By default this is set to Most Recent, meaning the data displayed by the widget is based on the most recent run of the report.

Once you click Save, you will be returned to the dashboard and your widget will display at the bottom. You can drag it to another position on the dashboard or move it to another dashboard if you wish.

Finished widget

Screen shot showing a sample pie widget