Pie Chart Configuration


a!pieChartConfig( primaryGrouping, measures, sort, dataLimit, link )

Contains configuration for how to display data in a pie chart. See the Pie Chart Component page for examples on using this configuration supporting function.

See also:


Name Keyword Types Description

Primary Grouping



Defines the field labels to display for each slice of the pie chart, configured using a!grouping().




Defines the numerical calculations for data in the chart, configured using a!measure(). If no measure is provided, a count of records shows as the measurement in the chart.




Use a!sortInfo() to define a sort. Use the alias of any groupings or measures, and sort in ascending or descending order. If an alias is not defined, use the record field references from groupings or measures.

Data Limit



Maximum number of data points to display on the chart. Default: 100. Valid values: 1-5000.



Any Type

Link to execute when a user selects a data point on the chart. Use fv!selection to pass context from the selection made on the chart to the link. Create a link using a!dynamicLink().

Usage considerations

Using a!pieChartConfig()

  • a!pieChartConfig() is always used within a pie chart component.
  • This configuration is used when a record type is defined as the data source for a pie chart in the data parameter of a!pieChartField().
  • If no measure is provided, the chart displays a count of records. Also, the label displays as Count of <primary key field name>.

Using groups and data limits parameters

  • The primaryGrouping is required to display data on the chart.
  • The dataLimit determines the total number of slices displayed in the chart.

Using the sort parameter

  • You can sort by any field used in the groupings or measures.
  • When configuring sort in Design Mode, you must sort by an alias. In Expression Mode, you can use an alias or a field name if an alias is not provided.
  • When a dynamic link is added to the link parameter, the current selected data is available using fv!selection. This variable returns a map that contains each of the field aliases as the key and the unformatted value as the value. Since the alias is used for the key, aliases are required for each grouping and measure when using a link. See Chart Configuration Using Records for an example of how to configure a link.

The following patterns include usage of the Pie Chart Configuration.

  • Aggregate Data and Display in a Chart (Reports, Charts, Query Data, Records): Aggregate data, specifically the total number of employees in a given department, to display in a pie chart.
Open in Github Built: Wed, Aug 16, 2023 (04:37:39 PM)

On This Page