Series

• Oct 19, 2020
• 3 minutes to read

The Chart dashboard item supports different types of series - from simple bar and line charts to candlestick and bubble graphs.

Name	Description	API
Bar Series	Bar series visualize data using rectangular bars with lengths proportional to the values that they represent.	SimpleSeries
Point and Line Series	Point series visualize data as a set of individual numeric data points. Line series are used to connect numeric data points through different types of line segments.	SimpleSeries
Area Series	Area series connect numeric data points using different types of line segments and fills the space between the line and X-axis/other series.	SimpleSeries
Range Series	Range series are used to show variations in a specified time range like temperature, price, etc.	RangeSeries
Weighted Series	Weighted series allow you to visualize data in three dimensions.	WeightedSeries
Financial Series	Financial series are used to illustrate stock prices.	OpenHighLowCloseSeries

• Change Series Type
• Configure Series Options
• Configure Series Point Label

Change Series Type

A chart visualizes data using the Bar series by default. To switch between series types, click the data item in the Values section and select the series type in the invoked data item menu. Use the ellipsis button to show all the available series types:

In code, obtain the required chart pane (ChartItem.panes) and use the ChartPane.series property for a specific pane. To change the series type, use the seriesType property for the specified series:

Series	Property
Bar Point and Line Area	SimpleSeries.seriesType
Range	RangeSeries.seriesType
Financial	OpenHighLowCloseSeries.seriesType

Configure Series Options

You can use the data item’s Options section to configure the common series options.

Here you can specify whether to plot the current series on the secondary axis, configure point markers behavior, etc.

The following options are available:

Option	Description	API
Caption	Specifies the series’s caption.	DataItemContainer.name
Plot on the secondary axis	Specifies whether the secondary axis is used to plot the current series.	ChartSeries.plotOnSecondaryAxis
Ignore empty points	Specifies whether empty points are ignored when plotting the current series.	ChartSeries.ignoreEmptyPoints
Show point markers	Specifies whether to show point markers for the current series. This option is in effect for the following series: Point/Line: Line, Stacked Line, Full-Stacked Line, Step Line, Spline; Area: Area, Step Area, Spline Area; Range: Range Area. Note Note that point markers are always shown when Master Filtering is enabled for the Chart dashboard item.	ChartSeries.showPointMarkers

Configure Series Point Label

A value data item’s Point Labels section allows you to enable series point labels and manage their settings.

For example, you can specify whether to show point labels or set the label overlap mode.

Use the ChartSeries.pointLabelOptions property to get access to the point label options.

The following options are available:

Option	Description	API
Content	Specifies the type of content point labels display. You can select a single or several values from the list.	PointLabelOptions.contentType
Overlapping Mode	Specifies the label overlap mode. You can hide overlapping labels or disable a resolving algorithm.	PointLabelOptionsBase.overlappingMode
Orientation	Specifies point labels’ orientation. You can set default orientation or rotate point labels 90 degrees clockwise or counterclockwise.	PointLabelOptionsBase.orientation

Bar series has the following additional settings:

Option	Description	API
Show for zero values	Specifies whether to show point labels for zero values.	PointLabelOptions.showForZeroValues
Position	Specifies point labels’ position relative to bars. Note Point labels can be displayed inside or outside bars. When you select the inside position and there is no enough space inside the bars, point labels are not displayed. Switch the position to outside to display labels.	PointLabelOptions.position