Substituir Texto

Realiza a substituição de um texto dentro de uma cadeia de caracteres.

Visão Geral

O objeto Substituir Texto é utilizado para substituir trechos específicos dentro de um texto durante a execução de um robô.

Esse objeto permite localizar um valor dentro de um conteúdo textual e substituí-lo por outro valor definido. Essa funcionalidade é útil em automações que precisam corrigir, padronizar ou transformar dados textuais antes de utilizá-los em outras etapas do fluxo.

---

Funcionamento

O objeto Substituir Texto analisa um texto e substitui todas as ocorrências de um valor específico por outro valor definido.

Fluxo de funcionamento:

1. O robô executa o objeto Substituir Texto.

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

3. O campo De define o trecho que será localizado dentro do texto.

4. O campo Para define o valor que substituirá o trecho encontrado.

5. O sistema percorre o conteúdo e realiza a substituição das ocorrências encontradas.

Após a execução, o texto atualizado poderá ser utilizado em etapas posteriores da automação.

Quando usar

• Quando for necessário substituir palavras ou trechos específicos em um texto.

• Quando o robô precisar padronizar valores textuais.

• Quando processos automatizados exigirem ajustes ou correções em conteúdos textuais.

Quando não usar

Não utilizar quando não houver necessidade de alterar o conteúdo textual ou quando a substituição depender de padrões complexos que exigem o uso de expressões regulares.

---

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ô.
Texto	Conteúdo textual que será analisado e modificado.
De	Valor ou trecho que será localizado no texto.
Para	Valor que substituirá o trecho encontrado.

---

Exemplos

Exemplo simples

Fluxo básico para substituir um valor em um texto:

1. Inserir o objeto Substituir Texto no fluxo do robô.

2. Informar o texto no campo Texto (ex.: "Olá Mundo").

3. Definir "Mundo" no campo De.

4. Definir "Usuário" no campo Para.

5. Executar o robô.

Após a execução, o resultado retornado será:

Olá Usuário

Exemplo aplicado

Cenário: um robô precisa padronizar valores dentro de um texto antes de enviar os dados para um sistema.

Fluxo:

1. O robô recebe o valor "Status: Pendente".

2. O objeto Substituir Texto identifica a palavra "Pendente".

3. O valor é substituído por "Em processamento".

4. O texto resultante passa a ser "Status: Em processamento".

---

Retornos

---

Erros comuns e como evitar

Texto não encontrado

Se o valor informado no campo De não existir no texto, nenhuma substituição será realizada.

Como evitar:

• Garantir que o texto contenha o valor que será substituído.

Texto vazio

Se o campo Texto estiver vazio, nenhuma operação será executada.

Como evitar:

• Validar o conteúdo antes de aplicar a substituição.

---

Boas práticas

• Definir claramente os valores que serão substituídos.

• Validar o conteúdo do texto antes de realizar alterações.

• Utilizar nomes claros no campo Título para facilitar a manutenção do fluxo do robô.

• Utilizar o objeto em conjunto com outros objetos de manipulação de texto para tratamento completo de dados.