Percentage Fields

Using Application Composer, you can extend an application's object model by adding fields to both standard or custom objects.

One such field type is a percentage field, where users in the runtime application can enter a percentage. Application Composer automatically adds the percent sign to the number.

Percentage Field Properties

Create a percentage field by specifying values for the common set of field properties, such as display label and field name. You also set properties for this field that are specific to the percentage field type.

The following properties are common across multiple field types:

Field Property	Field Property Region
Label	Appearance
Help Text	Appearance
Display Width	Appearance Note: Do not use. A field's display width is dynamically calculated based on the field type and resolution.
Name	Name
Description	Name
Required	Constraints
Updatable	Constraints
Searchable	Constraints
Indexed	Constraints
Fixed Value	Default Value
Expression	Default Value

The following properties are unique to only certain field types, including percentage fields:

Field Property	Field Property Region
Decimal Places The number of digits that can be entered and displayed to the right of the decimal point. If at runtime, a user enters more digits after the decimal point, then Application Composer rounds up (using the tie-breaking rule, round half up) to derive the field's value. For example, if you enter 2 for the number of decimal places, then at runtime, an entry of 4.986 is displayed as 4.99.	Constraints
Maximum Length The maximum digits a user can enter in the field. Maximum Length - Decimal Places = the number of digits that can appear to the left of the decimal point. Don't set a maximum length shorter than the number of decimal places.	Constraints

Field Property

Field Property Region

Decimal Places

The number of digits that can be entered and displayed to the right of the decimal point. If at runtime, a user enters more digits after the decimal point, then Application Composer rounds up (using the tie-breaking rule, round half up) to derive the field's value.

For example, if you enter 2 for the number of decimal places, then at runtime, an entry of 4.986 is displayed as 4.99.

Constraints

Maximum Length

The maximum digits a user can enter in the field.

Maximum Length - Decimal Places = the number of digits that can appear to the left of the decimal point.

Don't set a maximum length shorter than the number of decimal places.

Constraints

Additional Percentage Field Specifications

Additional specifications for this field type include the following details:

Data type is NUMBER.
A object can have a total of 625 fields. Of these, 200 are reserved for number, currency, and percentage fields.
Application Composer automatically adds the percent sign.
For custom fields, the percentage value is stored as the absolute value. For example, 100%=1 and 60%=0.6. Application Composer multiplies it by 100 and displays the converted percentage value.