Skip to main content
Version: 8.1

Report Component - Bar Chart


A Bar Chart is used to display data in a chart using bars. A Bar Chart typically contains a single string column that gets used as the Domain with as many other columns representing the Range axis values. The order of the dataset matters, and the string values used for the domain should be in the first column of the dataset.

Report Design Component Palette Icon:

Properties

Property Inspector - Configure Tab

PropertyDescription
Data KeyUnique identifier or placeholder to the data source that will populate the chart.
Extract OrderThe order in which the data should be extracted from the data key. Two options are available:
Row: Data is extracted by row. Use this when columns in the data key define the series of data.
Column: data is extracted by column. Use this when rows in the data key define the series of data; each column is a new value for the same series. This is sometimes referred to as data 'turned on its side'
Options3D: Columns and bars with 3D appearance using angle and depth.
Pareto: When enabled, turns the chart into a Pareto chart. Contains both lines and a bar graph where values are in descending order.
Render StyleProvides three rendering styles:
Bars: Displays data as individual colored bars.
Stacked: Displays data as a stacked bar in different colors.
Layered: Displays data as a layered bar in different colors.
Segment ColorsA unique color in the RGBA color space for each segment (bar).
Color Wheel Tool for creating color combinations for bars.
Add Segment Adds a color / row.
Remove Segment Deletes a color / row.
Scripting EnabledEnables the script for this component to run.
Edit Script Allows the chart to be modified before the report is rendered.

Property Inspector - Properties Tab

PropertyDescription
Data KeyData key of the dataset that drives this bar chart.
Category MarginSpacing between groups of bars on the chart.
Extract OrderDetermines whether the series are defined by rows or columns in the underlying dataset.
Item MarginSpacing between bars within a group.
Render StyleStyle for this bar chart. Options are bars (0), stacked (1), or layered (2).
3D BarsIf true, use 3D bars to draw chart.
Show LegendIf true, show the chart's legend.
Legend FontFont to use for the chart's legend.
Vertical ChartIf true, draw bars vertically.
ParetoIf enabled, the chart will act as a pareto chart; ordering the bars descending and adding a percentage line.
80% LineIf true, draw a line showing where 80% of the total is.
Pareto ColorColor for the Pareto line and 80% line.
Pareto Series LabelText to use in legend for the Pareto line.
Axis AutorangeIf true, set the axis range automatically, otherwise use the Axis Low and Axis High values.
Axis FontFont to use for axis and axis label.
AxisFormatA optional number format string to override the automatic formatting on the y-axis.
Axis LabelText to place on the axis label. May be blank.
Axis LowIf autorange is turned of, the low value to use for the axis.
Axis HighIf autorange is turned off, the high value to use for the axis.
Label PositionOrientation of category labels.
Bar LabelsIf true, add labels to each bar.
Label ColorColor to use for bar label text.
Label FontFont to use for bar labels.
Label OffsetSpace to add between the end of the bar and the label. Negative numbers will put the label onto the bar.
OpacityHow opaque the fill color is, between 0 and 1.
Stroke StyleWhat style of stroke or border to use: Hidden, Shape Outline, Border, or Double. To learn more about stroke styles, refer to Stroke and Fill Properties.
StrokeDetails for the chosen stroke. Each Stroke has its own properties depending on the Stroke Style chosen.
RollNumber of degrees this shape is rotated clockwise.
Scale XAmount to scale the width of this shape. 1 is scale to 100%.
Scale YAmount to scale the height of this shape. 1 is scale to 100%.
URL
New in 8.1.19
A link to attach to this reporting component. Will be a clickable hyperlink if the report is exported as a PDF. You can use the values below to link to internal pages.
  • Page:Next - Navigates to the next page.
  • Page:Back - Navigates to the previous page.
  • Page:Number - Replace "Number" with a numeral. Navigates to the specified page.
  • VisibleIf true, the shape will be visible.
    WidthWidth of this shape in pixels.
    HeightHeight of this shape in pixels.
    XHorizontal distance in pixels between the left edge of this shape and the left edge of the page.
    YVertical distance in pixels between the top edge of this shape and the top edge of the page.

    Example

    Bar Chart Sample CSV Data
    Fruit, Quantity, AvgWeight
    Apples, 150, 183
    Bananas, 56, 151
    Mango, 190, 300
    Oranges, 33, 77

    PropertyValue
    3D BarsTrue
    Render StyleStacked