Overview #

edgeSuite’s Chart Visualization allows you to select from many different chart types. This base chart type determines what options will be exposed when configuring a series.

Icon
Chart Type
Polar Support Multiple Series Render Option

Area

Area Spline

Bar

Bubble

Column

Line

Pie

Scatter

Spline

Chart Configuration #

The Chart Visualization configuration is broken out into five steps:

  1. Base Chart
    Identifies the name and base options for the chart.
  2. Dimensions
    Configures the X-Axis of the chart, which is normally displayed on the horizontal axis.
  3. Measures
    Configures the Y-Axis of the chart, which is normally the vertical axis.
  4. Series
    Determines the values plotted on the chart.
  5. Preview
    Previews the end result based on the choices you made.

Configuration override can by done like this


Step 1:  Base Chart #

Visualization Name #

A symbolic name used to identify this Visualization. This will be the name that appears in the pipeline.

Default Type #

This determines a default chart type. This default chart type will enable/disable certain features on the following wizard screens.

You can override chart type per series on most of the available chart types. This allows you to mix different chart types together. The exception is Pie Chart, which restricts each item in the series to a pie slice.

Show Legend? #

This determines whether a legend will be shown by default for the chart.

Yes The legend will be displayed.
No The legend will be hidden.

Regardless of the default setting, legends can be toggled on/off at run time via that chart icon in the visualization’s header.

Render as Polar? #

Chart types that support a polar chart option will have a property called “Polar”. The chart types that support polar variants are indicated in the table above.

Yes

The chart will be rendered as a Polar chart, which uses a radial axis.

No
The chart will be rendered normally.

Step 2:  Dimensions #

A Dimension of data typically shows up as the X-Axis on a chart, but it can also appear as the Y-Axis in some cases. An example would be a Column Chart (X-Axis) vs. a Bar Chart (Y-Axis). The header on this step will explain which axis will be affected, according to the chart type that you selected.

Type #

This property determines the type of data used for the Dimension axis. It affects how the tick marks along that axis are plotted.

category A Category axis contains STRING values. The tick interval will default to one per category.
datetime A DateTime axis contains DATE values. The tick interval is calculated based the Date Unit property.
linear A Linear axis contains NUMERIC values, and assumes a linear relationship between the values.
logarithmic A Logarithmic axis contains NUMERIC values, and assumes a logarithmic relationship between the values.

Show Labels

This determines whether to show labels on the Dimension axis.

Yes Labels will be displayed along the axis.
No Labels will be hidden.

Attribute #

This determines the attribute to use for the Dimension axis. The configured Axis Type will limit the options available in the Attribute pull-down. If you do not see a specific attribute name in this pull-down, then the Data Type of that Attribute may not be compatible with the Axis Type selected.

Highcharts error #15

When dealing with a date/time dimension axis, the dataset should be sorted by the attribute used as the dimension axis. For performance reasons, the Chart Visualization does not sort data. It assumes the content creator will pre-sort the data. When unsorted, the Chart Visualization will produce browser console errors similar to the example below:

Highcharts error #15: www.highcharts.com/errors/15

Title

This property determines whether a title appears along the Dimension axis.

A null value for this property means that no title will be displayed.

Override User Time Zone #

This is only applicable to an axis type of DateTime. It allows an administrator to override a user’s localized time zone.

ON Displays a Time Zone pull-down. Selecting an explicit Time Zone from this pull-down ensures that all users will see the same times, regardless of where they are physically located.
OFF Date information will be localized, and shown using a GMT offset based upon a user’s location.

Localized Date? #

This is only applicable to an axis type of DateTime. If custom formatting is desired, it can be set globally via a Highcharts adapter.

No Default. The axis date label will always be in YYYY-MM-DD format.
Yes Show the axis date label in localized format based user’s language preference.

Step 3:  Measures #

Title #

This property determines whether a title appears along the Measure axis.

A null value for this property means that no title will be displayed.

Type

This property determines the type of data used for the Measure axis. It affects how the tick marks along that axis are plotted.

category A Category axis contains STRING values. The tick interval will default to one per category.
datetime A DateTime axis contains DATE values. The tick interval is calculated based the Date Unit property.
linear A Linear axis contains INTEGER values, and assumes a linear relationship between the values.
logarithmic A Logarithmic axis contains INTEGER values, and assumes a logarithmic relationship between the values.

Starting Value

This is only visible for numerical axis types (Linear and Logarithmic). This sets the minimum starting value on the axis for the chart.

Static A fixed number can be specified and data points less than this value will be clipped from view.
Automatic Default setting: automatically calculated based on the dataset.
Constraint Choose a numeric constraint in the system in which its minimum value will used. Data points less than this value will be clipped from view.

This allow you to share a calculated minimum value across different datasets, therefore allowing for comparison between different charts on the same page. Only dynamic constraint should be used.

Ending Value

This is only visible for numerical axis types (Linear and Logarithmic). This sets the maximum ending value on the axis for the chart.

Static A fixed number can be specified and data points greater than this value will be clipped from view.
Automatic Default setting: automatically calculated based on the dataset.
Constraint Choose a numeric constraint in the system in which its maximum value will used. Data points greater than this value will be clipped from view.

This allow you to share calculated maximum value across different datasets, therefore allowing for comparison between different charts on the same page. Only dynamic constraint should be used.

Show Labels? #

This determines whether to show labels on the Measure axis.

Yes Labels will be displayed along the axis.
No Labels will be hidden.

Render Option (Optional)

This property determines how series information is grouped together and presented. (Only Area, Bar, Column, and Areaspline chart types have such an option.)

Grouped Groups information for multiple series side by side, allowing for easier comparison of the values within the series.
Percentage Stacks series on top of each other and shows a percentage comparison.
Stacked Stacks series on top of each other, allowing for aggregate comparison across the available Dimension.

Allow Decimals? #

Applicable only to Linear axis type. This determines how the Measure axis tick values will be presented.

Yes Axis tick values might contain decimals.
No Axis tick values will be in integer only.

Step 4: Series #

This step will vary based on what you have selected for the “Dynamic Series” property.

Dynamic Series? #

This option determines has how the series is defined.  The choice made here significantly alters the rest of the series configuration.

Yes The series will be derived based on the numeric attributes available in the underlying data, and a set of rules configured in the following “Series” step.

  • This is a good option when the attributes available in a data set may change, based on variables used in the underlying queries and scripts.
  • This option allows only limited control over how each item in the series will look.
No The series will contain a static set of attributes that are manually configured on the following “Series” step.

  • This is a good option when attributes are constant, and do not change based on underlying queries and scripts.
  • This option allows for greater control over how each item in the series will look.

Static Series Configuration #

Dynamic Series = No

When Dynamic Series is set to no, this results in a “Static Series”.  A static series is good for data sets whose columns stay consistent, and will not vary based upon variables in underlying queries and scripts. Each series lets you explicitly select the attribute (column) you would like to show in your chart, and it gives you total control over how the data for that attribute is presented. Most of the configuration options are oriented around defining how each series will look.

Attribute Name #

The attribute containing the values for this series.

Display Name #

Determines how the attribute name will be displayed in the chart. This allows you to rename attributes to something more meaningful to an end user.

Chart Type Override

Determines the chart type used for each series. Selecting an option different from the base chart type allows you to mix different chart types together. For example, you can overlay a line chart on top of a column chart.

No override is possible when the base chart type is pie.

Renderer #

Determines how a chart series will be rendered. The options available will vary based on the selected chart type.

Dynamic Series Configuration #

Dynamic Series = Yes

Dynamic series configuration is good for data sets whose columns change over time, or vary based on variable queries. A dynamic series is a flexible approach, allowing the number of series to grow or shrink based on what is in the underlying data.  However, what you gain in flexibility you lose in control over presentation.

Inclusion Method #

This lets you limit the numeric attributes used in a dynamic chart. It allows you to filter out attributes like IDs and Zip Codes, things that might show up as INTEGERS, but you would not want to appear in your chart. The options are:

  • All Numeric Columns (Default)
  • Columns Contains
  • Columns End With
  • Columns Start With

Exclusions #

Optionally select one or more columns to be specifically excluded from the Visualization.

Color Palette #

This lets you choose a base color palette to use with a dynamic series. When using a dynamic series, the series information is not known and can grow and shrink based on what is in the data.  Because of this colors cannot be bound to individual attribute names like in statically defined series.

A Dynamic series references a color palette, which is just an array of color values. It will iterate through these colors for each item in the series, moving from left to right in the order that they appear in the preview. If a series is larger than the number of colors in the palette, it will wrap and start reusing colors.

Step 5:  Preview #

This step provides a preview of the resulting Visualization. It exposes upstream variables to test how inherited context changes will affect the display.