Extrair por expressão regular
O robô «Extrair por expressão regular» procura em uma string correspondências de um padrão definido em processos de negócios e robôs do Bitrix24. Recebe a string de origem, uma expressão regular e o número do grupo de captura (0 significa a correspondência inteira). Retorna a primeira correspondência, a lista de todas as correspondências e um indicador «Encontrado» (Y/N).
O robô aplica uma expressão regular à string de origem e coleta todas as correspondências. O padrão pode ser informado sem delimitadores — o próprio robô o envolve em /…/u, então texto Unicode é tratado corretamente. O número do grupo de captura permite retornar uma parte específica do padrão em vez da correspondência inteira, por exemplo um valor capturado entre parênteses. Casos típicos: extrair um número de pedido como ORD-12345 do assunto do e-mail a partir do qual o lead foi criado, ou extrair todos os links de um comentário do negócio. O robô retorna a primeira correspondência, a lista completa de correspondências (valor múltiplo) e o indicador «Encontrado» (Y/N). Nas próximas etapas do processo de negócios, grave o valor extraído em um campo da entidade ou ramifique pelo indicador Y/N quando não houver correspondência.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| String de origem | string | sim | |
| Expressão regular | string | sim | |
| Número do grupo de captura (0 = correspondência inteira) | int | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Primeira correspondência | string |
| Todas as correspondências | string |
| Encontrado (Y/N) | string |
Cenário: extração do número do pedido do assunto de um e-mail
- Um lead é criado a partir de um e-mail recebido — o título contém «Pedido ORD-12345: dúvida sobre a entrega»
- O robô aplica o padrão ORD-\d+ e retorna a correspondência ORD-12345
- O processo de negócios grava o número do pedido em um campo do lead e localiza o negócio relacionado