Chart Plot

Introduction

A Plot in ActiveReportsJS Charts is the graphical representation of data on a chart. It organizes and displays data visually by drawing graphical shapes based on the Data Series and Grouping Configuration.

For example, in the Territory Sales Report, the Bar Plot displays sales data for different regions over the past year. Each bar represents a region (Category Group), such as “Australia” or “Canada”, with the bar's length indicating the sales value (Data Series).

Common Plot Properties

Name

A String value that defines the plot name, which you can reference within the axes configuration.

Data Series Collection

The Data Series collection defines the individual sets of data points plotted on the chart. Each item in the collection represents a series and includes several customizable properties to control its appearance and behavior. Below is a description of these properties:

Common

• Name: The name of the data series.

• Values: The data values that the series represents. Depending on a plot type, it could include one or more data values. Each data value exposes the caption and the value itself. Both properties are expressions.

• Tooltip Template: An expression for customizing the content displayed in tooltips when hovering over the series.

Action

Specifies an interactive action to perform when a report reader clicks on a graphical shape representing the data value. Check the Interactive Reports page for more information.

Label Text

• Template: Defines the text to display in labels for the series.

• Offset: Adjusts the position of the label relative to the geometrical shape representing data point.

• A subset of Style Properties and Text Properties indicates the visual appearance of labels.

• Text Position: Determines the position of the label relative to the geometrical shape representing data point:

  • Auto

  • Center

  • Inside

  • Outside

Label Border

Line Properties in this section indicate the appearance of the border around the label.

Connecting Line

Line Properties in this section indicate the appearance of the line connecting the label to the geometrical shape representing the corresponding data point

Category Groupings and Series Groupings

Category Groupings and Series Groupings define how the data is structured and organized for visualization in a plot.

• Category Groupings: Define the categories or groups along which the data is segmented, such as product categories, regions, or time periods.

  Series Groupings: Represent additional levels of segmentation, often used to compare multiple data series within each category.

Each plot type may interpret Category Groupings and Series Groupings differently. For detailed explanations and examples, refer to the individual plot type pages listed below.

Plot Template

Determines the plot type to be used for visualizing the data. The selected plot type defines how the data is represented and may introduce additional properties specific to that plot type. Refer to the following pages for detailed information about each plot type:

• Column and Bar Plots

• Line Plot

• Area Plot

• Pie and Doughnut Plots

• Scatter and Bubble Plots

• Spiral Plots

• Polar Plot

• Radar Lines Plot

• Radar Area Plot

• Radar Scatter and Bubble Plots

• Financial Plots

• Gauge Plot

Overlays

In addition to geometrical shapes, such as columns, bars, or lines, that represent the data, a plot can include additional elements called overlays. Overlays provide extra information or context to help understand the data better.

Each plot can include multiple overlays, and you can modify them using the Overlays Collection Editor. For more information, refer to the Overlays page.