right-leftObter Texto com Regex

Realiza a busca de expressão regular (Regex) dentro do texto

Visão Geral

O objeto Obter Texto com Regex é utilizado para extrair informações específicas de um texto utilizando Expressões Regulares (Regex) durante a execução de um robô.

Esse objeto permite localizar padrões dentro de um texto e retornar apenas os trechos que correspondem ao padrão definido. Essa funcionalidade é especialmente útil em automações que precisam identificar, extrair ou validar informações dentro de conteúdos textuais, como números, códigos, datas ou identificadores.

O resultado encontrado é armazenado em uma variável de retorno, permitindo que o valor seja utilizado nas etapas posteriores da automação.


Funcionamento

O objeto Obter Texto com Regex analisa um texto utilizando uma expressão regular para identificar padrões.

Fluxo de funcionamento:

  1. O robô executa o objeto Obter Texto com Regex.

  2. O campo Texto recebe o conteúdo que será analisado.

  3. O campo Insira sua Expressão Regular (Regex) define o padrão que será buscado no texto.

  4. O sistema processa o conteúdo utilizando a expressão regular definida.

  5. O trecho correspondente ao padrão encontrado é armazenado na variável de retorno configurada.

Caso a opção Especificar Match e Group esteja habilitada, é possível definir qual correspondência e grupo da expressão regular será retornado.

Quando usar

  • Quando for necessário extrair informações específicas de um texto.

  • Quando o robô precisar identificar padrões dentro de conteúdos textuais.

  • Quando processos automatizados exigirem validação ou captura de dados estruturados em texto.

Quando não usar

Não utilizar quando não houver necessidade de identificar padrões em texto ou quando o conteúdo já estiver estruturado de forma direta.


Configuração

CAMPO
DESCRITIVO

Título

Nome do objeto dentro do fluxo do robô.

Nome Identificador do Objeto

Identificador único do objeto dentro do robô.

Nome da Variável de Retorno (string)

Variável que armazenará o valor encontrado pela expressão regular.

Texto

Conteúdo textual que será analisado.

Insira sua Expressão Regular (Regex)

Expressão regular utilizada para localizar o padrão desejado.

Especificar Match e Group

Permite definir qual correspondência ou grupo da expressão regular será retornado.


Exemplos

Exemplo simples

Fluxo básico para extrair um número de um texto:

  1. Inserir o objeto Obter Texto com Regex no fluxo do robô.

  2. Informar o conteúdo no campo Texto (ex.: "Pedido número 12345 aprovado").

  3. Definir a expressão regular no campo Insira sua Expressão Regular (Regex) para localizar números.

  4. Executar o robô.

Após a execução, o valor 12345 será retornado na variável configurada.

Exemplo aplicado

Cenário: um robô precisa extrair um código de protocolo presente em um texto de confirmação.

Fluxo:

  1. O robô recebe um texto contendo informações da transação.

  2. O objeto Obter Texto com Regex identifica o padrão do código utilizando Regex.

  3. O valor extraído é armazenado na variável de retorno.

  4. O robô utiliza o código em etapas posteriores do fluxo.


Retornos


Erros comuns e como evitar

Expressão Regex inválida

Se a expressão regular estiver incorreta, o padrão não será identificado.

Como evitar:

  • Validar a expressão regular antes da execução.

Texto incompatível com o padrão

Se o texto analisado não contiver o padrão definido, nenhum valor será retornado.

Como evitar:

  • Garantir que o texto contenha o padrão esperado.


Boas práticas

  • Testar a expressão regular antes de utilizá-la na automação.

  • Utilizar Regex apenas quando necessário para identificar padrões complexos.

  • Definir variáveis de retorno com nomes claros para facilitar a manutenção do fluxo.

  • Validar o conteúdo antes da aplicação da expressão regular.

Last updated

Was this helpful?