Skip to content

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 default Horizontal and Plot 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.