Number field
The number field is used to represent numerical values in documents.
Note: On mobile devices, BizzStream uses native numeric input fields. These fields use the locale of the device rather than the locale specified by the user.
Properties
| Setting | Required | Description |
|---|---|---|
| Label | Yes | The label is used for users of BizzStream. The label is shown in documents left to the value of the field. Labels can always be edited. |
| Translation key | No | Can be used to replace the field label with a translation. If set, BizzStream will try find the translation associated with the key set in this field. If no translation can be found, the label set in the Label field will be used. |
| Name | Yes | The name is a BizzStream system field. Once the Document Definition is persisted, this field cannot be edited anymore. Unless there are no documents based on this document definition. |
| Required | No | By checking the Required-option, you force the user to fill out the field. By not checking this option, the option to fill out the field is to the discretion of the user. |
| Decimals | Yes | The value can range from 0 to infinity. This value also specifies the decimals properties of the fields: Step, min / max and initial value. |
| Minimum Value | No | In this field you can enter the minimum value of the field. |
| Dynamic Minimum | No | In some cases, the minimum value of a numeric input may depend on other numeric inputs or (notably) formula fields. This field can contain BizzStream Expressions referring to other fields. If there is both a minimum value and a minimum placeholder, the lowest of both values is the minimum that is enforced. |
| Maximum Value | No | In this field you can enter the maximum value of the field. |
| Dynamic Maximum | No | In some cases, the maximum value of a numeric input may depend on other numeric inputs or (notably) formula fields. This field can contain BizzStream Expressions referring to other fields. If there is both a maximum value and a maximum placeholder, the lowest of both values is the maximum that is enforced |
| Step | Yes | The steps size of the value that can be changed up or down. Needs to be a number of zero or higher. |
| Enforce step | No | In this field you can enter the maximum value of the field. |
| Prevent Entering Values Outside Range | No | Prevents entering values outside of the minimum / maximum range. If a number lower than the minimum value is entered, BizzStream rounds to the minimum value. If a number higher than the maximum value is entered, BizzStream rounds to the minimum value. This functionality is only supported in the desktop interface. |
| Initial Value | No | By providing an initial value to the field, upon creation the field or linefield will have this value. This field cannot refer to values placed in other fields. A user/visitor can overwrite this value. |
| Initial Placeholder | No | When you provide an initial placeholder, the field will get the value of the field to which the placeholder refers. Users/visitors can update this value. Unlike placeholders, the field will not updated when the field to which the placeholder refers updates. This field can contain BizzStream Expressions referring to other fields. |
| Placeholder | No | By providing a placeholder, you ensure that the value of this field is replaced by the value of the field to which the placeholder refers when the referenced field updates. |
How the data is stored
Number fields will be saved accordingly in the database:
numberField: 9.1234