Format a number
The "Format a number" robot turns a number into a readable string in Bitrix24 (Alaio) business processes and robots: you set the decimal places, the decimal point, and the thousands separator. It understands "1 500,50" on input. It returns the formatted string, the normalized number, and a Number recognized Y/N flag.
The robot formats a number for human eyes — "1234567.5" becomes "1 234 567.50", fit for an email or a document. The input is the number (a comma decimal separator and inner spaces are understood), the decimal places (2 by default), the decimal point (comma by default), and the thousands separator: space, none, or any custom character. Typical use cases: put the deal amount into a quote; show a budget in a manager notification without a six-digit tail; normalize a number before writing it into a document. If the value is not a number, Number recognized = N and an empty string are returned. It returns the string, the normalized number, and the Y/N flag — use them in the next steps of the business process.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Number | string | yes | |
| Decimal places (default 2) | string | — | |
| Decimal point (default comma) | string | — | |
| Thousands separator: space, none, or a custom character (default space) | string | — |
What does the robot return?
| Parameter | Type |
|---|---|
| Formatted string | string |
| Number (normalized) | double |
| Number recognized (Y/N) | string |
What errors can the robot return?
The robot writes these messages to the business process log when it cannot complete a step. The text tells you what to fix in the settings or the data.
- Error: the value is not a number
Scenario: an amount in a quote
- A deal builds a document with the amount 1234567.5
- The robot formats the number: 2 decimals, a dot, a space between thousands
- The document receives 1 234 567.50 — the amount reads at a glance