Table of Contents
- Gauge Visualization
- Gauge Configuration Steps
- Step 1: Base Gauge
- Step 2: Renderers
- Label Formatter
- Value Strategy
- Additional Options
- Arc Gauge Options
- Legacy Linear Horizontal Gauge
- Step 4: Sort Options
A new Visualization type, called Bullet Chart, was first included in edgeSuite v3.5. It has many similarities to the Linear Gauge Visualization. For more information on the Bullet Chart Visualization, see Bullet Chart.
The following documentation is for the updated Gauge Visualization in edgeSuite v3.5 and higher. If you are using an edgeSuite version prior to v3.5, see Legacy Gauge Visualization.
Thresholds and Comparative Values are no longer supported.
Specifically, the Linear Gauge Visualization from a pre-v3.5 system is not compatible with the current Linear Horizontal Gauge. Any older Liner Gauge Visualization should be reviewed when you are upgrading to v3.5 or higher. It might have to be manually converted to a Bullet Chart Visualization.
Gauge Visualization #
This section contains details on how to configure the Gauge Visualization in edgeSuite v3.5 or higher.
The Gauge Visualization displays one or more values, along with any number of attributes/icons.
Arc Gauge #
Linear Horizontal Gauge #
Linear Vertical Gauge #
Gauge Configuration Steps #
The Gauge Visualization configuration is broken out into five steps:
- Base Gauge
Identifies the name and appearance of the Visualization.
Configures where and how labels, values, icons, and gauges will appear.
Determines some additional options based on the type of gauge.
Determines the default sort for the gauge.
Preview of the gauges based on the choices made.
Step 1: Base Gauge #
Visualization Name #
A symbolic name used to represent this Visualization. This is the name that will show up in choosers when adding a Visualization to a page.
The type of gauge. Choices are:
|Arc||Gauges are radial|
|Linear – Horizontal||Gauges are horizontal.|
|Linear – Vertical||Gauges are vertical.|
List Orientation #
The type of layout. Choices are:
|flow||Flow layout produces a horizontal list. List items will have a set width, and flow left to right. List items will wrap to the next line if needed.|
|horizontal||Similar to a flow layout. List items will have a set width, and flow left to right. List items will not wrap and will scroll horizontal if needed.|
|vertical||Vertical layout produces a vertical list. This list will render a single record per row, and each row will fill 100% of the available space.|
Number of pixels between the list item and its border.
Number of pixels between list items. Not applicable in vertical list orientation.
List Item Width #
Determines width of each list item in flow or horizontal list orientation.
Show Border #
Determines whether a border will appear for each item in a flow or horizontal list orientation.
|Yes||A border will appear around gauges|
|No||Gauges will not have a border|
Gauge Size #
Determines the size of the arc gauge.
Gauge Spacing #
Determines the distance in pixels between the outer edge of the chart (Gauge Size) and the content. The numbers designate top, right, bottom, and left respectively. If the start or end point label is cut off, consider adding a little padding. For example 0,10,10,5.
Gauge Length #
Determines the length of the linear gauge.
Gauge Width #
Determines the width of each linear gauge – combine width of axis label and the bar.
This property is available with “Flow” list orientation. It works in conjunction with list item width, and determines whether list items should grow to fill any remaining space. This option basically turns the list item width property into a Min-Width property.
Item Background Color #
Determines the background color of each item.
Step 2: Renderers #
This step configures the attributes to display as part of each list item. It also defines the renderer to use when presenting the values for the specified attributes.
Attribute Name #
Determines the record values that will appear in each list item.
This property determines whether a label will appear next to a value within a list item.
|Yes||A label will be shown to the left of the value.|
|No||Only the value will be shown.|
Label acts as a description for values that appear in a list. The Label defaults to the Attribute Name, but can be overwritten with something better optimized for display.
Determines the renderer to use with the associated attribute. The value renderer determines how record values for each attribute are presented. The available renderers will vary based on the data type of the each attribute.
See “Renderers” for more information.
Label Formatter #
Determines how labels will appear inside list items. The label formatter is a global setting, and will be used for all labels within the List.
Determines the color of labels. See Color Picker
Determines the font size of labels.
Determines the font style of labels.
Step 3: Options
The options properties displayed depend on the type of gauge selected.
Value Strategy #
Minimum Strategy #
Configure what the minimum value will be shown on the axis of the chart.
|Static||Type in a value that will be used to set the minimum value of the chart’s axis.|
|Calculated||Automatically calculate an appropriate minimum value of the chart.|
|From Field||Choose a field in the data that will set the minimum value on each chart.|
Maximum Strategy #
Configure what the maximum value will be shown on the axis of the chart.
|Static||Type in a value that will be used to set the maximum value of the chart’s axis.|
|Calculated||Automatically calculate an appropriate maximum value of the chart.|
|From Field||Choose a field in the data that will set the maximum value on each chart.|
Additional Options #
Inline Content Alignment #
By default all non-icon and gauge items will be part of inline content, which property controls how these items are aligned within its container.
|center||Item will be center aligned.|
|left||Item will be left aligned.|
|right||Item will be right aligned.|
Arc Gauge Options #
Arc Thickness #
Determines the thickness of the Arc. The four options are:
Arc Start Angle #
Determines where the gauge value starts
Arc End Angle #
Determines where the gauge value ends
Start and End Example 1 #
Start and End Example 2 #
Legacy Linear Horizontal Gauge
The following setting will be shown if there is only one Gauge renderer, it is not rendered as part of inline content, and list orientation is vertical. This is to support the upgrade of pre-3.5 version of Linear Gauge. User should consider convert this to a Bullet Chart or adjust the chart’s setting to avoid using legacy rendering which will be discontinued in the near future.
Show as Legacy Linear Gauge #
Determines whether to show a comparative measure on the linear gauge, indicated by a vertical line.
|Yes||Deprecated. This is to replicate pre 3.5 version of Linear Gauge where the gauge auto expand horizontally to the available width in a vertical list layout. The label and value column is restricted to a fixed width.|
|No||Turn off legacy linear gauge rendering style.|
Inline Content Fixed Width #
Deprecated. The width of the label and value column.
Step 4: Sort Options #
This step configures how the gauge items are sorted.
Select an attribute from the underlying dataset, whose values will be used to determine the sort.
Controls how the values will be sorted.
|Ascending||A → Z|
|Descending||Z → A|