Number Element Properties

The Number element creates a simple form field for entering a number. Although you can select a Number Format from the drop-down box, you can also type a format into the field using the following syntax:


            0 = Digit
# = Digit, zero shows as absent
. = Decimal separator
- = Negative sign
, = Grouping Separator
% = Percent (multiplies number by 100)
        

For example:

,###.## 1,234.56

####.## 1234.56

#,###.00 1,234.50

Back to Form Elements

Related topic: Element Properties

Name

Value Type

Description

Name

Text

The internal name for an element in the form.

Binding

Menu selection

The name (not the label) of the form field to which an element is bound.

Element Type

TextBox | Text Area | Dropdown | ComboBox | Date Picker | Number | Email | Checkbox | Radio Button

Lets you quickly change a basic element (such as a Text Box) to another, similar type of basic element, such as a Dropdown or Combo Box.

Required

True | False

True: Requires input from the user and marks the form field with a red asterisk.

False: Element will not require user input.

Read Only

True | False

True: Element is read-only and cannot be modified.

False: Element can be modified.

Max Characters

Number

The maximum number of characters a user will be allowed to type into the field. Default value is 512.

Min Characters

Number

The minimum number of characters a user will be allowed to type into the field. Default value is 0.

Placeholder Text

Text

Placeholder text is a short description or hint that that describes the expected value of an input field. (For example, "Enter phone number xxx-xxx-xxxx"). The short hint is displayed in the input field before the user enters a value.

Rules

Special

Click to view (or create) any Rules (logic, formulas, etc.) applied to an element.

Promote to Solution Field

Text

Name of the solution field to which this field is promoted. If the field name provided here does not exist in the solution fields, then a field with provided name will be created in the solution fields.

Default Value

Number/Text

The default value for an element.

Refresh Default Value

True | False

True: Forces the element to re-evaluate any applicable default values when a field value changes.

False: (default) - Element will not re-evaluate default values when a field changes.

Number Format

Menu selection

Allows you to change the format of the numbers added to this element.

Encrypt

True | False

When the Field Encryption property is set to True for a form field, data entered into the field is stored in an encrypted format in the form XML and log files.

Note: If the field is in a form view to be rendered, or the field needs to post to SAP or any 3rd party web service, the field is decrypted by the Server and sent in plain text format. In order to ensure complete security, the data transmission should occur via https.

Class Names

Text

Space separated Names of CSS classes to be used to customize the look of the element.

Propagate Changes to all Views

True | False

When you change style or properties for common labels in a Composer form with multiple views, you will be prompted by a dialog box asking if you want to apply the changes to all views. Setting this option to True automatically propagates style or property changes to all applicable views without prompting.

Width (%)

Number (%)

The width of the element in the form, expressed as a percentage (1-100%).

Changing the default number type

By default the Number element has the data type of Decimal (which is a floating point representation).

But if you need to use an Integer or Whole Number you can change the data type:

  1. Click the Solution tab.

  2. In the Solution pane, right-click the number element field, and then click Properties.

  3. Under Data Type, click the drop arrow and select the required data type--Whole Number (integer) in this case and then click OK.

    Note:

    You can set any field's Data Type the same way, i.e. using the Form Data tree in the Solutions pane and accessing the properties for the field.