Gauges

The gauge is suitable for displaying speed, volume levels, pressure, temperature or filling levels.

An example of how the gauge is used to display users logged into the portal can be seen in one of our Tips and Tricks posts.

The "Gauge" application element is part of the "Images and files" element category.

The gauge element can be found in the "Elements" section of the "Applications" module. A new gauge can be created by dragging & dropping the element from here and positioning it on the workspace.

More information on creating elements can be found here.

The properties dialog of a gauge element opens automatically when a new gauge is created. The properties dialog of an existing gauge can be opened by double clicking on the element on the workspace, via the "Properties" context menu, or via the "Edit/Properties" main menu if the gauge is selected on the workspace.

General

In the properties dialog of the gauge, you will find the following settings under the "General" tab:

Title

Provide the gauge with a title here. Click here for information on multilingual titles.

Document template

Here you can choose from a total of nine templates that can be used to select a background image for the gauge. Select "Custom View" (10) if you want to include your own background image.

Background image

The path to the background image is shown here.

Select background image

Opens a dialog for selecting an image.

Delete background image

Deletes the link to the currently selected background image.

Display text if no data record is found

If this setting is active, a text will be displayed when there is no data available for the gauge.

Use global text

Use global text Uses the text stored in the language constant DR_NO_RECORD.

Text if no data record is found

Here you can enter your own static text, including multilingual text.

Gauge

In the properties dialog of the gauge, you will find the following settings under the "General" tab:

Description

This is shown as a title above the gauge.

Starting value / Ending value

The first and last value of the gauge's scale are defined here.

Displayed value

The data field, which provides the values for the gauge, is entered here.

Value description

Here, the units of the values can be specified, for example. The value description is displayed within the gauge.

Scale increments

Determines the increments the scale is displayed in. Scale increments cannot be defined for the In the 6th to 9th template, which you can find on the "General" tab in the speedometer properties dialog, the scale graduation marks cannot be set. If one of these templates is selected, then this setting will be hidden.

Edit

Opens the dialog for editing values.

Edit values

Data Field

If the gauge control is on a view page in a data group, a data field can be selected here that provides data being displayed. However, this is not possible on top-level view pages.

Static value

A static value can be entered here.

Calculations

A formula can be entered here.

Edit

Opens the formula editor.

System value

A system value can be used as the data source here. Three options are available here:

Value

Enter the name of the parameter here.

Default

If the system value does not return a value, the value entered here is used.

Markings

Markers can be used to color part of the scale in the gauge. Set the area and color you want to use here.

"From/To" columns

Displays the start and end value of the highlighting.

"Width in %" column

Displays the width of the highlighting as a percentage. This column is not displayed here if one of the 6th to 9th templates has been selected for the speedometer on the "General" tab in the properties dialog.

"Color" column

Shows the color used for highlighting.

Deletes the currently selected highlighted range

Deletes the currently selected highlighted range.

Add Marker/ Edit Marker

Opens a dialog in which a marker can be created or edited.

Define the values of a marker in the gauge here.

From / to

Define the start value and end value of the highlighting.

Edit starting/ending value

Opens a dialog where the data source for these values can be selected.

Width in %

Defines the width of the value range. The width cannot be set if one of the 6th to 9th templates has been selected for the speedometer on the "General" tab in the properties dialog.

Color

The hexadecimal value of the color used for the highlighting is shown here.

Edit color

Opens a color palette where the color can be selected.

Options

Show XML names

Displays the gauge's layout properties in XML.

Show real names

Displays the names of the gauge's individual layout properties

For more information on customization options, see the API from the third-party solution "amCharts".