Formatar string por regex
O robô «Formatar string por regex» para processos de negócios do Bitrix24 executa um PHP preg_replace sobre a string de origem: ele encontra sua expressão regular e a substitui pela sua substituição, onde $0 é a correspondência inteira e $1, $2 são os grupos capturados. Ele retorna o Resultado transformado e um indicador Sucesso (false em caso de erro de regex).
«Formatar string por regex» é um robô de texto para processos de negócios e robôs do Bitrix24 que oferece a substituição completa por expressão regular (PHP preg_replace) diretamente no designer de processos. Você fornece a string de origem, um padrão e uma substituição; o robô aplica o padrão ao texto e retorna o valor reescrito no campo «Resultado». Na substituição, você pode referenciar a correspondência inteira como $0 e os grupos capturados como $1, $2 e assim por diante, o que permite reordenar, reformatar ou extrair partes de um valor. Também é retornado um indicador Sucesso — ele é false quando o padrão é inválido, de modo que você possa ramificar com segurança em vez de salvar uma saída quebrada. Use-o para reformatar números de telefone, normalizar datas, remover ou reordenar partes de uma string ou extrair um fragmento dos dados do CRM. Não é necessária implantação de código nem desenvolvedor.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| String de origem | string | sim | |
| Expressão regular (padrão) | string | sim | |
| String de substituição ($1, $2 para grupos) | string | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Resultado | string |
| Sucesso (false em caso de erro de regex) | bool |
Cenário: reformatar um telefone de 10 dígitos em uma máscara legível.
- Passo 1. Adicione o robô «Formatar string por regex» ao seu processo de negócios.
- Passo 2. Defina String de origem como o campo, por exemplo {=Document:PHONE}.
- Passo 3. Defina o padrão e uma substituição com grupos, por exemplo a substituição "+55 ($1) $2-$3".
- Passo 4. Use o campo Resultado adiante e verifique o indicador Sucesso em uma condição.