Numeric Field

Overview

Use the Numeric field to capture single-line numeric data. This field supports positive and negative numbers, and you can customize the following parameters to ensure accurate input:

• Number of decimal places
• Minimum value
• Maximum value

You also have the option to include a prefix (e.g., $, €) or suffix (e.g., %, kg), along with a security setting that hides the entered value in the app.

Note: Alphabetic (e.g., five) and alphanumeric (e.g., 7LBZ281) characters are not supported.

How to Add a Numeric Field

1. Select the Numeric field in the Form Builder in the Add Fields menu on the left.

2. Rename the field on your form to your desired prompt (e.g., Quantity).

3. Optional: Customize any settings in the Numeric Settings menu on the right (see below for more details).

Numeric Settings

• Decimals
  • Set the number of allowed decimal places into the numerical input 
• Min. / Max. Value
  • This will force the user to input a value within the range of the predetermined data set.
• Prefix
  • Set text or characters that will precede the numerical value. This will only be shown in the final reports.
• Suffix
  • Set text or characters that will precede the numerical value. This will only be shown in the final reports.
• Secure
  • This will hide the entered value in the app while being input.

*Beta Setting*

There is an optional beta setting within the numeric field. You can toggle between keyboard and counter inputs in the field settings menu in the portal. Current customers can send in a chat or create a support ticket to enable this feature.

Additional Configuration

Setting	Description
Field Label	The label displayed for the field. This is usually displayed at the top left corner above the field.
Field Key	A Key used to reference the field in submission data. The key is also used to reference the field in rules and calculations.
Hint Text	The text that is displayed if the field has no value set (e.g., "Please enter a value").
Default Value	The value that will be used to pre-populate the field when the form is initially opened.
Decimal Positions	The number of decimal position to show in the value.
Enforce Min./Max.	Requires user to enter a value within your Min./Max. Value settings.
Minimum Value	The minimum allowed value for input.
Maximum Value	The maximum allowed value for input.
Memory Field	If a previous form containing the same Field Key has a value set, its value will be pre-populated for this field when the form is first opened.
Rules	A Rule or JavaScript snippet that allows you to perform actions on fields or sections within the form. The actions can include hide, show, enable, disable, show section, and hide section. Rules are executed on field value changes and when the form is opened. Example: if ($field1$ > 23) { hide(); } else { show(); } (Please see the Introduction to Rules Document for more information)
Required	Sets the field to have required input. You will not be able to submit the form until this field has valid input.
Enabled	If not set the field will be visible but cannot be edited or set to accept new input.
Hide Field Label	Hides the Field Label.
Hidden	If enabled the field and all labels are not visible.
Exclude From Reports	If checked, the field will be excluded from HTML and PDF reports and will also be excluded from Excel and CSV exports.
Capture Geo Location	Capture the current latitude and longitude when the acknowledgment button is clicked.
Capture Time Stamp	Capture the current date and time when the acknowledgment button is clicked.
Alert Type	Choose a theme to change the background and font colors of the field cell as displayed in the apps.
Secure	If checked, the input is masked from view with a * character.

Result Data

Data Type	Domain of Values	Example JSON
Numeric (Integer or Double based on Field Definition)	Any Numeric Value	{ "singlelinenumeric_1": 5.5 }

Note: 

9,223,372,036,854,775,807

 is the maximum value for a 64-bit signed integer in computing.