Chart
The Chart component provides the ability to include different types of charts within the card.
Theory
- Charts are used to display information visually as opposed to textually as per tables.
- The plot settings in a chart are used to define categorical (bucketing) of values to present.
- The series settings are used to define what sets of numbers are to be displayed per the plot categories.
- Certain chart types, such as scatter plots, do not use categorical bucketing and instead show two continuous scales for both the X and Y axes.
Note:There are five required properties that need to be set before a chart component is rendered.
• Plot Instructions
• Plot X Label
• Series Instructions
• Series Title
• Series Y Value
Common Use Properties
[!] = Essential to Render the Chart Component
[!] Plot Instructions Property The Plot Instructions Property defines the data seen along the x-axis (if the Plot Direction Property is Horizontal) or y-axis (if the Plot Direction Property is Vertical).
[!] Plot X Label Property This is the horizontal label along the bottom of the chart, typically linked to an
ELEMENT()
that is desired to be displayed.[!] Series Instructions Property The Series Instructions Property will be the content or plot of the chart.
[!] Series Title Property The series title makes up what values the chart looks at and, thus, is the main body content of the chart. It will be displayed both as the chart’s visual contents and as a colour-coded legend.
[!] Series Y Value Property Value that links to a cube to utilize the cube’s context and data within the chart. Specific context in this property will override the context defined in the card context panel.
Plot Direction Property With Charts, the
Plot Direction
property will affect the above required properties. The properties will be as named above for the defaultHorizontal
andPlot Direction
.Vertical The following properties are changed to reflect the new chart orientation.
- The "Plot X Label" is replaced with a "Plot Y Label" property
- The "Series Y Value" is replaced with the "Series X Value"
Horizontal The following properties are changed to reflect the new chart orientation.
- The "Plot Y Label" is replaced with a "Plot X Label" property
- The "Series X Value" is replaced with the "Series Y Value"
Both
- The "Plot X Label" and "Plot Y Label" properties are hidden.
- Both the "Series X Value" and "Series Y Value" properties are used to define the chart values.
Series Format Property The Series Format property defines what type of chart displays the data.
INFO
The Pie
and Doughnut
options require additional configuration.* The Doughnut
Format will require an additional configuration in the Overlay Label
Property to add a value to the center of the doughnut.