Formatar número
O robô «Formatar número» converte um número em uma cadeia legível em processos de negócios e robôs do Bitrix24 (Alaio): definem-se as casas decimais, o separador decimal e o separador de milhares. Entende «1 500,50» na entrada. Retorna a cadeia formatada, o número normalizado e um indicador «Número reconhecido» Y/N.
O robô formata um número para olhos humanos — de «1234567.5» sai «1 234 567,50», digno de um e-mail ou documento. A entrada é o número (a vírgula decimal e os espaços internos são entendidos), as casas decimais (2 por padrão), o separador decimal (vírgula por padrão) e o separador de milhares: space — espaço, none — sem separador, ou qualquer caractere próprio. Casos típicos de uso: colocar o valor do negócio em uma proposta; mostrar um orçamento em uma notificação sem uma cauda de seis dígitos; normalizar um número antes de gravá-lo em um documento. Se o valor não for um número, são retornados «Número reconhecido» = N e uma cadeia vazia. Retorna a cadeia, o número normalizado e o indicador Y/N — use-os nas próximas etapas do processo de negócios.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Número | string | sim | |
| Casas decimais (padrão 2) | string | — | |
| Separador decimal (padrão vírgula) | string | — | |
| Separador de milhares: space — espaço, none — sem separador, ou um caractere próprio (padrão espaço) | string | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Cadeia formatada | string |
| Número (normalizado) | double |
| Número reconhecido (Y/N) | string |
Cenário: um valor na proposta comercial
- Um negócio gera um documento com o valor 1234567.5
- O robô formata o número: 2 casas, vírgula, espaço entre os milhares
- O documento recebe «1 234 567,50» — o valor se lê de relance