[]
        
(Showing Draft Content)

Chart

A Chart data region helps you to visualize your data graphically. It is a data visualization control primarily based on slicing data through encodings.

This article provides information about the chart elements and other aspects of charts that will help you design a chart.

Chart Elements

The below image illustrates the elements that make up the Chart data region. These elements help you analyze the visual information and interpret numerical and relational data in a chart.

chart-elements

You can view all the chart elements in the Explorer and access properties through the Inspector Panel as described in the below sections.

Note: You should enable advanced properties.

show-advanced-properties

Plot Area

The plot area is the area of the chart where the data is plotted graphically. It also includes the chart axes and legend.

Property

Description

Common

Axes

Axes for the plot that constitutes the Plot area.

Background

Color

Select a color for the background of the Plot area.

Border

Width

Set the width of the border of the Plot area.

Style

Select a style for the border from the following options: Dotted, Dashed, Solid, Double, Groove, Ridge, and Inset.

Color

Select a color for the border of the Plot area.

Layout

Padding

Set padding values for each side of the Plot area - Top, Left, Right, and Bottom.

Plot

The plot is where the actual chart encodings are configured and converted to visual attributes, that is, graphs. It also includes other configuration settings such as applying Rules, adding Overlays, setting clipping mode, offset, etc.

Property

Description

Common

Name

Enter the chart plot name.

Values

Add values or a collection of values for the plot.

Tooltip Template

Select the settings of the tooltip template from the list of predefined chart template tokens or enter an expression.

Plot Template

Select a chart plot type from the available types.

Opacity

Set the opacity of the plot; 100% opacity means that the plot is opaque and 0% opacity means that the plot is transparent.

Action

Type

Select any of the following actions to perform on preview, when the user clicks the plot.

Apply Parameters: Select the name of the parameter, type (Set, Reset, Toggle), and the value of the parameter to be passed.

Jump to Report: For drill-through reporting, select this option and provide the name of a local report, the relative path of a report in another folder, or the full path of a report on another server.

Jump to Bookmark: Select this option and provide a valid Bookmark ID to allow the user to jump to the report control with that Bookmark ID.

Jump to URL: Select this option and provide a valid URL to create a hyperlink to a Web page.

Encodings-Common

1Category

The Category Encoding for Column and Bar plots forms the axis of the plot across which distinct categories are arranged.

Category Sort Expression

Specifies the sort expression on which the sorting is based.

Category Sort Direction

Defines the ascending or descending order in which the categories should be sorted.

Category Sorting Aggregate

The aggregate to use for sorting the categories.

Details

The Details encoding breaks down the data values into subcategories and produces additional groups. The Details property is the collection of items and each item includes the following properties that define the Details encoding:

Values: The Values property is the collection and takes the field as a subcategory.

Exclude Nulls: The Exclude Nulls property determines whether to exclude the null details values in the dataset field.

Group: The Group property determines how the columns or bars are arranged when divided into subcategories.

  • None: It is the default value.

  • Cluster: Creates a cluster of groups for the subcategories. Note that a clustered plot can be created by providing two data field values, that is, two items in the Values encoding collection.

  • Stack: Stacks the subcategories, for example, vertically in the case of column plots and side-by-side in the case of bar plots, to configure a stacked plot.

Sort Expression: Defines the order in which the subcategories are displayed.

Sort Direction: Defines the ascending or descending order in which the subcategories should be sorted.

Sorting Aggregate: Specifies the aggregate to use for sorting the subcategories.

Text Encodings

The Text Encoding displays additional info on the chart from a dataset field as chart labels and tooltips. When two text encodings are added, they are displayed by default with the ";" delimiter. A text encoding includes the following properties:

Value

A field, constant, or expression that should be displayed.

Template Key

A unique key that is used in the chart plot's Labels > Template and Tooltip Template to access the text encoding value.

Target

Specifies whether this text is for a Label or a Tooltip Label. The label format is controlled with the chart's Labels > Template property or Tooltip Template property.

Aggregate

Aggregates the value of the Text expression.

Encodings-Color

The Colors Encoding enables the color legend of the Details or Category Encoding.

Show Values Names in Legend

If set to True, the legend is displayed based on the value specified in Details encoding or Color encoding.

Color

It is the collection where the value of the Color expression is specified.

Color Aggregate

Aggregates the value of the Color expression.

Action Type

The action to take out of the following on preview, when the color legend is clicked.

Apply Parameters: Select the name of the parameter, type (Set, Reset, Toggle), and the value of the parameter to be passed.

Jump to Report: For drill-through reporting, select this option and provide the name of a local report, the relative path of a report in another folder, or the full path of a report on another server.

Jump to Bookmark: Select this option and provide a valid Bookmark ID to allow the user to jump to the report control with that Bookmark ID.

Jump to URL: Select this option and provide a valid URL to create a hyperlink to a Web page.

2Encoding-Shape

The Shape Encoding enables the shape legend of the Details or Category Encoding and includes the Aggregate function and shape expression.

Shape

The collection and usually takes a bound field. Most of the plots take the first item from the collection.

Shape Aggregate

To show aggregated values such as Average, Count, and Sum instead of individual values, specify an Aggregate function.

Action Type

The action to take when the shape legend is clicked.

2Encoding-Size

The Colors Size enables the Aggregate function and Size expression. The Size Encoding works solely with numeric values and breaks down data values into ranges that determine the symbol size.

Size

It is the collection and usually takes a bound field. However, the Line plots take the first item from the collection.

Size Aggregate

To show aggregated values such as Average, Count, and Sum instead of individual values, specify an Aggregate function.

Action Type

The action to take when the size legend is clicked.

1Category Encoding does not apply to Pie and Doughnut Charts.

2Size and Shape Encodings are available in Line, Scatter, Bubble, Radar Scatter/Radar Bubble, Radar Line, Polar

Axes

Typically, a chart consists of two axes that are used to plot the data - the vertical axis (also known as Y-axis) and the horizontal axis (also known as the X-axis). You can change the axis type, hide the axis label or title, customize the line appearance, etc.

Property

Description

Column

Axis Type

Designates the type of Axis, X or Y.

Title

Represents the title of the Axis.

Plots

Designates the plot in which the X or Y Axis exists.

Appearance

Height

Represents the height of the Axis in percentage relative to the overall chart height. This property applies to the horizontal axis.

MaxHeight

Represents the maximum height of the Axis in percentage relative to the overall chart height. This property applies to the horizontal axis and its default value is 100%.

MaxWidth

Represents the maximum width of the Axis in percentage relative to the overall chart width. This property applies to the vertical axis and its default value is 100%.

Width

Represents the width of the Axis in percentage relative to the overall chart width. This property applies to the vertical axis.

Title

Color, Font, Text Decoration, Padding

Use these settings to modify the color, font, etc. of the Title.

Line

Width, Style, Color, Visible

Use these settings to control the appearance of the axis line, or to control its visibility.

Labels

Color, Font, Text Decoration, Padding

Use these settings to modify the color, font, etc. of the Label.

Format

Represents the formatting string used for rendering dates and numbers in Labels.

Label Angle

Represents the rotation angle of the axis of the Labels in degrees.

Label Field

Represents customized labels for the X-axis.

Visible

Indicates whether to show or hide axis Labels.

Writing Mode

The horizontal (lr-tb) or vertical direction (tb-rl) of the label text. The default value is lr-tb (left to right top to bottom). If set to tb-lr (top to bottom left to right), the chart axis labels appear vertically.

Label Row Count

Sets the number of rows for X-axis labels for a multi-row arrangement. The allowed value ranges from 1(default) to 10. See the Customizations topic to see the implementation. The Label Row Count property is not supported for the axes as described in the following cases:

  • Horizontal X/Y axis of all charts with polar coordinates: Gauge, Pyramid, Funnel, Spiral, Polar, Radar Area, Radar Scatter, Radar Line, Radar Bubble and Pie, Doughnut.

  • X-axis for Gantt, Bar, Range Bar charts.

  • Vertical Y-axis of all charts.

  • If more than one category field exists.

Major/Minor Grid

Show Grid Lines

Indicates whether or not to show the major/minor gridlines.

Width, Style, Color

Width, Style, and Color of the major/minor gridlines.

Major Interval

Frequency of major/minor grid lines.

Major/Minor Ticks

Tick Size

Length of the major/minor ticks.

Width, Style, Color

Width, Style, and Color of the major/minor ticks.

Tick Marks

Positioning of major/minor ticks: inside the plot area, outside the plot area, or across the axis.

Scale

Scale Type

Represents the scale type of the axis.

Linear: In the Linear scale type, the values are evenly distributed along the axis. It is the default scale type.

Logarithmic: In the Logarithmic scale type, the axis uses the logarithm of values rather than the values themselves. This scale type is best suitable for displaying a wide range of numerical values compactly. When using a logarithmic scale, the axis can use a logarithmic base.

Ordinal: In the Ordinal scale type, the values are evenly distributed along the axis according to their order. It applies to non-numerical values like product categories.

Percentage: In the Percentage scale, the values are represented as a percentage.

Min

Shows the minimum axis value.

Max

Shows the maximum axis value.

Layout

Position

Indicates the axis position: Far, Near, None.

Origin

Represents the value or ordinal number at which both the axes cross each other.

Reversed

Indicates whether the axis is reversed from top to bottom, or left to right.

Overlapping Labels

Indicates whether the labels can be overlapped.

Legend

The legend serves as a key to the specific colors or patterns being used to show series values in the chart. To display legends for each plot on a chart, enable Show Values Names of the plot to True.

Header/Footer

The chart header is used to display a title for the chart and appears above the plot area. The chart footer is used to add a footer for the chart and is displayed below the plot area. The text for the header and footer is set in the Caption property. Use other properties to control the text formatting, padding, background color, alignment, etc. for the chart header/footer.

Chart Wizard

The Chart Wizard guides you through the process of creating a chart. When you drag and drop the Chart data region onto the report design surface, the Chart Wizard is displayed.

Note: The Chart Wizard is displayed only if a report is already bound to a data set.

Select data and chart type

The first screen of the Chart Wizard asks you to select a data set and a chart type.

chart-wizard-dataandtype

Settings

In the second screen of the Chart Wizard, specify the plot properties to configure the data values, category, detail encodings, etc., specific to the chart type.

chart-wizard-settings

Preview

Select a chart palette from the drop-down list. Click Finish to add the chart to the report or choose any of the advanced customization options.

chart-wizard-preview

For information on how to create a chart, see the walkthrough Report with Chart.