a!chartSeries( label, data, links, color, showWhen )
Defines a series of data for a bar, column, line, or pie chart.
See also:
Name | Keyword | Types | Description |
---|---|---|---|
Label |
|
Text |
Name that corresponds to the data value or data values to display in the legend. |
Data |
|
Decimal Array |
Value displayed for the related series.label. |
Links |
|
Array of Links |
Array of values that determine what occurs when a user clicks a data point in the chart. Create links with: |
Color |
|
Text |
Overrides the auto-assignment of series color with a specific value. Valid values: Any valid hex color or |
Visibility |
|
Boolean |
Determines whether the series is displayed on the interface. When set to false, the series is hidden and is not evaluated. Default: true. |
The color of chart series can be defined by an overall chart color scheme or it can be configured individually. If a user has selected or created a color scheme, they can swap out the color of any individual series.
Users can choose between the assigned color scheme color, the environment’s accent color, a color such as "SKYBLUE"
or "BLUEGRAY"
, or a custom color defined by a hex code. Any series configurations will take precedence over the assigned color scheme colors.
Use the interactive editor below to test out your code:
The a!chartseries() component is always used within a chart component.
The following patterns include usage of the Chart Series Component.
Aggregate Data and Conditionally Display in a Chart or Grid (Reports, Charts, Query Data, Grids): Aggregate data and conditionally display it in a pie chart or grid. In this pattern, we will calculate the total number of employees in each department and display it in a pie chart and a read-only grid. Then, we'll use a link field to conditionally display each component.
Aggregate Data from a Data Store Entity and Display in a Chart (Reports, Charts, Query Data): Aggregate data from a data store entity, specifically the total number of employees in a given department, to display in a pie chart.
Aggregate Data from a Data Store Entity using a Filter and Display in a Chart (Reports, Charts, Query Data, Filtering): Aggregate data from a data store entity, specifically the total number of employees for each title in the Engineering department, to display in a bar chart.
Configure a Chart to Grid Toggle (Charts, Grids): Display a column chart with a toggle to display an alternate grid view of the data.
Drilldown Report Pattern (Grids, Charts, Reports): The drilldown report pattern consists of a bar chart and column chart, which each drill down into a grid.
Filter the Data in a Grid Using a Chart (Charts, Grids, Filtering): Display an interactive pie chart with selectable sections so that a user may filter the results in a grid.
Refresh Until Asynchronous Action Completes (Auto-Refresh): Use a refresh interval to display the results of an asynchronous action automatically.
Trend-Over-Time Report (Charts, Reports): This report provides an attractive, interactive design for exploring different series of data over time.
Use a Filter to Adjust Chart Reference Lines (Filtering, Charts): Using a dropdown, filter the results of a data set while also adjusting a chart reference line.
Year-Over-Year Report (Charts, Reports, Formatting): This is a feature-rich, interactive report for sales and profits by products over select periods of time.