Gauge Percentage

On This Page

SAIL Design System guidance available for Gauges

What gets measured gets done. So measure what matters with gauges. Learn how to configure and display gauges on your interface designs so you can visualize progress on your most important goals and initiatives.

Function

a!gaugePercentage()

Displays the configured percentage of the gauge as an integer for use within the gauge field primaryText parameter.

See also: Gauge design guidance

Parameters

This component does not take any parameters. Instead, it captures the percentage value from its parent gauge and displays that value in the center, rounded to an integer.

Examples

To experiment with examples, copy and paste the expression into an interface object.

Use the interactive editor below to test out the example code.

a!gaugeField(
  label: "Evaluations Completed",
  percentage: (25 / 26) * 100,
  primarytext: a!gaugePercentage()
)

Feature compatibility

The table below lists this component's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Compatible
Offline Interfaces	Compatible
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible	Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports	Incompatible	Cannot be used to configure a process report.
Process Events	Incompatible	Cannot be used to configure a process event node, such as a start event or timer event.
Process Autoscaling	Incompatible	Cannot be used in autoscaled processes.
Event Consumer Filter Conditions	Compatible	Can be used in filter conditions.
Event Consumer Event Handlers	Compatible	Can be used in event handler expressions.

The following recipes include usage of the Gauge Percentage.

Percentage of Online Sales (Records, Reports, Formatting):
This pattern illustrates how to calculate the percent of sales generated from online orders and display it in a gauge component.
Use the Gauge Fraction and Gauge Percentage Configurations (Formatting, Reports):
This recipe provides a common configuration of the Gauge Component using a!gaugeFraction() and a!gaugePercentage(), and includes a walkthrough that demonstrates the benefits of using design mode when configuring the gauge component.

Feedback

Was this page helpful?