Arc

Name

Name that identifies the control. This value is also used for the label of the control.

XML Node

(Required) XML node mapped to the control. Use this value to map a list to a form and a form to a workflow.

• Prefix with @ to use the value of the control as an attribute with the immediate parent node. For example, @FirstName.

• Use forward slash ( / ) for a parent-child node configuration to uniquely identify a control in a form with multiple containers. For example, Employee/FirstName.

  The default value is the value for the Name property without the spaces.

Note:
- If you use / to denote a parent, which is not a container and the parent is at the same level as that of the child, then the XML node for the control is not generated.
- If you edit this value later, then it may affect the mapping between forms, lists, and workflows.

Description

Description for the control.

Enable Column Bindings

Enable this option to set up the lookup source.

• Select Yes to enable use of the lookup source.

• Select No if column binding is not necessary.

  If enabled, specify the column names based on the lookup source definition for Unit of Measurement, Target Value, and Default Value properties.

The default value is No.

Lookup Source

(Required) Name of the item from the lookup list.

Note: This is only visible when the Enable Column Bindings property is set to Yes.

To add a name of the item for the control from the lookup list:

1. Click the Lookup Source button. The Lookup Source Configuration page appears.

2. In the Data Source Type list, select a type of data source.

   Note: Supported datasource types are database and Web API lookup source.

3. In the Data Source box, select a data source.

4. In the Parameters section, select the parameters to include, if applicable.

5. Click Save & Continue. The selected name is set for the control and the Lookup Source Configuration page is closed.

Unit of Measurement

Unit of measurement for the value of the control.

This supports two lines with 12 characters for each line and a tooltip is shown when you hover over this property. An ellipsis is added if it exceeds the 12-character limit.

Target Value

Target value of the control. This is the value that the target indicator points at.
If this property is left blank, the target indicator is not shown at preview or runtime.

Default Value

This is the value of the control.

This supports 10 characters and a tooltip is shown when you hover over this property. An ellipsis is added if the value exceeds the 10-character limit.

Visible

Show or hide the control.

• Select Yes to show the control.

• Select No to hide the control.

  The default value is Yes.

Label Position

Position of the label for the control.

• Select Default to allow the system to align the label. The system aligns the label to the left of the control or as specified by the container control.

• Select Left to align the label to the left of the control.

• Select Top to align the label to the top of the control.

• Select Right to align the label to the right of the control.

• Select Bottom to align the label to the bottom of the control.

• Select Suppress to hide the label for the control.

  The default value is Default.

Note: If the value is Default and the control is placed on a container control, then the value of the Label Position property of the container control determines the position of the label for the control.
For example, if the value is Default and the control is placed on a Base Form with Label Position property set to Top, then the label is aligned to the top of the control.

Label-Control Area

Area occupied by the label and the control in percentage.

• Select Default to allow the system to set the label and the control areas.

• Select Custom to specify the label area. The control area is automatically set based on the label area.

  The default value is Default.

Note: If the value is Default and the control is placed on a container control, then the value of the Label-Control Area property of the container control determines the area of the label for the control.
This is applicable only when the Label Position is set to Left or Right.

Width

Width in pixels for the control.

The default value is 0.

Note: If the value is 0, then the width of the control is set as per the default value of 360.

Retain Space

Reserve or remove space when the control is hidden.

• Select Yes to keep space when the control is hidden.

• Select No to remove space when the control is hidden.

  The default value is No.

Title

Name or information text for the control. It is shown directly above the top-left corner of the control.

This supports two lines with 20 characters for each line and a tooltip is shown when you hover over this property. An ellipsis is added if it exceeds the 20-character limit. If you want to add a line break, use the html tag <br>.

Note: If this property is not configured or blank, nothing is shown, the other control contents use its space, and the control size is adjusted based on the available content within the control. The described behavior also applies to the Unit of Measurement property.

Decimal Places

Decimal places for the default value of the control. It also applies to the values in the Range property.

This displays a maximum number of 3 decimal places.

The default value is 0.

Note: At runtime, if this property is empty or has a non-numeric value, it resets back to 0. If its value is greater than 3, it stays at its maximum value of 3.

Scale Minimum Value

(Required) Minimum value displayed on the scale.

The default value is 0.

Note: At runtime, if this property is empty or has a non-numeric value, its value is set to 0.

Scale Maximum Value

(Required) Maximum value displayed on the scale.

The default value is 100.

Note: At runtime, if this property is empty or has a non-numeric value, its value is set to 100.

Scale Start Angle

Angle at which the scale starts.

The default value is 0, where the angle starts at 9 o 'clock.

This accepts a minimum value of 0 and maximum of 360.

Note: If this property is left blank, it resets back to its default value.

Scale Span Angle

The length at which the angle spans based on the Scale Start Angle property.

The default value is 180 degrees.

This accepts a minimum value of 0 and maximum of 360.

Note: If this property is left blank, it resets back to its default value.

Show Scale

Show or hide the scale in the control.

• Select Yes to show the scale in the control.

• Select No to hide scale in the control.

If this is set to Yes, the Number of Division property is visible.

The default value is No.

Number of Division

Number of division within the scale, from the scale minimum value to the maximum value.

This number divides the difference between the Scale Maximum Value and Scale Minimum Value. For example:

• Scale Minimum Value = 0

• Scale Maximum Value = 200

• Number of Division = 5

So the difference between the scale max and min values is 200. The difference divided by the number of division is 40. The scale tick marks are then shown as 0, 40, 80, 120, 160, and 200.

Note: This is only visible when the Show Scale property is set to Yes.

The default value is 10.

Control Background Color

The color to represent the background of the control.

The default is white.

Background Color

The color to represent the background of the bar in the control.

The default is gray.

Bar Color

The color to represent the bar in the control.

The default is green.

Range

The breakpoint to apply in the control range bar.

Each added row corresponds to a breakpoint and for each breakpoint value, you can assign a color. You can have a maximum of 10 breakpoints.

Note: If the configured range does not cover the full scale, the undefined range takes the color that is set for the Bar Color property.

The value for the breakpoint must be between the specified value for the Scale Minimum Value and Scale Maximum Value properties.

Custom Style Sheet Identifier

Prefix for the CSS class name in the custom style sheet.

For information about using custom style sheets, see Custom Styles.

Note: The value must start with an alphabet and can contain only alphanumeric characters.

On Initialize

Run a script after the control has been initialized, but before it is rendered to the UI.

For more information, see Scripting Guidelines.

ID

Reference identification code for the control. This value is automatically generated and cannot be changed.

Enable Refresh

Enable or disable control refresh.

• Select Yes to enable control refresh and configure the Refresh Rate property.

• Select No to disable control refresh.

  The default value is No.

Refresh Rate

This is how often the control display is refreshed, in seconds, to fetch value from the data source.

Note: This is only visible if the Enable Refresh property is set to Yes.

The default value is 30 seconds and the valid refresh rate is from 5 to 600 seconds.