Buscar e Substituir

Buscar um valor dentro de um arquivo texto e substitui por outro

Visão Geral

O objeto Buscar e Substituir é utilizado para localizar e substituir trechos de texto em um arquivo de texto ou objeto de texto durante a execução de um robô.

Esse objeto permite realizar modificações automáticas em conteúdos textuais, substituindo palavras, expressões ou padrões específicos por novos valores definidos na configuração.

A funcionalidade é útil em automações que exigem tratamento, padronização ou atualização de dados textuais, especialmente em arquivos ou variáveis manipuladas pelo robô.

---

Funcionamento

O objeto Buscar e Substituir realiza uma busca por um valor específico e substitui esse valor por outro definido pelo usuário.

Fluxo de funcionamento:

1. O robô executa o objeto Buscar e Substituir.

2. O campo Arquivo de Texto define o arquivo ou objeto de texto que será processado.

3. O campo Pesquisar define o valor que será buscado no conteúdo.

4. O campo Substituir define o novo valor que substituirá o texto encontrado.

5. O sistema percorre o conteúdo do texto.

6. Sempre que o valor pesquisado for encontrado, ele será substituído pelo valor definido.

Após a execução, o conteúdo atualizado poderá ser utilizado nas próximas etapas da automação.

Quando usar

• Quando for necessário substituir palavras ou expressões em textos automaticamente.

• Quando o robô precisar padronizar conteúdos textuais.

• Quando processos automatizados exigirem edição ou tratamento de arquivos de texto.

Quando não usar

Não utilizar quando não houver necessidade de modificar conteúdos textuais ou quando o conteúdo não estiver disponível em arquivo ou objeto de texto.

---

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ô.
Arquivo de Texto	Define o arquivo ou objeto de texto que será utilizado na busca e substituição.
Pesquisar	Texto ou expressão que será buscada no conteúdo.
Substituir	Texto que substituirá o valor encontrado.

---

Exemplos

Exemplo simples

Fluxo básico para substituir uma palavra em um texto:

1. Inserir o objeto Buscar e Substituir no fluxo do robô.

2. Informar o arquivo no campo Arquivo de Texto.

3. Definir no campo Pesquisar a palavra que será localizada.

4. Informar no campo Substituir o novo valor.

5. Executar o robô.

Após a execução, todas as ocorrências do texto pesquisado serão substituídas.

Exemplo aplicado

Cenário: um robô processa arquivos de texto que contêm informações desatualizadas.

Fluxo:

1. O robô abre ou carrega um arquivo de texto.

2. O objeto Buscar e Substituir identifica termos específicos no conteúdo.

3. O robô substitui os termos por valores atualizados.

4. O conteúdo atualizado é utilizado nas etapas seguintes da automação.

---

Retornos

---

Erros comuns e como evitar

Texto pesquisado não encontrado

Se o valor informado no campo Pesquisar não existir no conteúdo, nenhuma substituição será realizada.

Como evitar:

• Confirmar que o texto pesquisado corresponde exatamente ao conteúdo existente.

Arquivo de texto inválido

Se o arquivo informado não existir ou não puder ser acessado, a operação pode falhar.

Como evitar:

• Garantir que o caminho ou objeto de texto informado esteja correto.

---

Boas práticas

• Definir claramente os valores utilizados nos campos Pesquisar e Substituir.

• Validar o conteúdo antes de executar a substituição em arquivos importantes.

• Utilizar esse objeto para padronização ou tratamento de textos em processos automatizados.

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