On line guide/help
You are on page 27 of the online help. Navigate sequentially through the guide pages or search for a topic of interest to you.
Index Prev. NextGaugechart
Draw a gauge chart
A gauge chart is a type of data visualization that looks a lot like a speedometer you'd see in a car. It's designed to show a single value on a scale to let you quickly see how it's performing against a goal or a target.
Parameters
Elements / attributes of the <gaugechart> element:
Coordinate parameters (required) that define the print area of the chart
<x1> Starting X coordinate (upper/left corner)
<y1> Starting Y coordinate (upper/left corner)
<x2> Ending X coordinate (bottom/right corner)
<y2> Ending Y coordinate (bottom/right corner)
The coordinates can also be set with <x>, <y>, <width>, <height> instead of x1, y1, x2, y2 (one of the two methods is required).
Parameters that define the appearance of the graph:
<minValue> (numeric, float) Chart min value (default 0)
<maxValue> (numeric, float) Chart max value (default 100)
<value> (numeric, float, required) Chart value to display. Placeholders are supported, eg. {kpi.margin} or {MY_VALUE} (version 1.0.11 or later)
<border> Border of the gauge: 0 hide (default), 1 show
<radius> (numeric, float) Graph radius (0 : auto, the radius will be calculated so that the graphic fills the print area)
<title> (string) Chart title
<titlefont> Font of the title (if not set, the default font is used)
<style> Chart style: DONUTS (default), RING or GAUGE = ring gauge; any other value (eg. CLASSIC) = full semicircle
<format> Format mask of the displayed value, eg. F2 or P0 (default: 1 decimal) (version 1.0.11 or later)
<axisfont> Font of the min / max labels (default: Helvetica 8 black) (version 1.0.12 or later)
<axisformat> Format mask of the min / max labels, eg. C0 $. If not set, the labels use the separators of the number format variables (version 1.0.12 or later)
<showaxis> yes (default) or no: hides the min / max labels (version 1.0.12 or later)
<legend> Optional legend: it lists the chart segments with their colors (version 1.0.11 or later)
<segmentlist> Defines the segments that represent the different sections of the chart. Optional. If no segments are defined, a single default segment will be used.
Optional parameters:
<printif> Optional expression: the element is printed only if the expression is true, eg. {doc.type}=1. See the Conditional printing page.
Example
A gauge chart with three segments: the color of the gauge depends on the segment that contains the value. The legend lists the segments.
Gauge chart example