Pesquisar Texto

Busca um texto dentro de um arquivo

Visão Geral

O objeto Pesquisar Texto é utilizado para localizar a ocorrência de um texto específico dentro de um componente de texto ou arquivo durante a execução de um robô.

Esse objeto permite identificar se um determinado conteúdo está presente em um texto ou documento, possibilitando que o robô execute validações ou tome decisões com base no resultado da pesquisa.

O resultado da busca é disponibilizado através da propriedade FoundText, que indica se o texto pesquisado foi encontrado.

---

Funcionamento

O objeto Pesquisar Texto realiza uma busca por um trecho específico dentro de um conteúdo textual.

Fluxo de funcionamento:

1. O robô executa o objeto Pesquisar Texto.

2. O usuário define a origem da busca, podendo ser:

   • Componente de Texto

   • Arquivo

3. O campo Pesquisar recebe o valor que será procurado no conteúdo.

4. O sistema analisa o conteúdo informado.

5. Caso o texto seja encontrado, o resultado será disponibilizado na propriedade FoundText do objeto.

Esse resultado pode ser utilizado em decisões dentro do fluxo do robô.

Quando usar

• Quando for necessário verificar se um texto específico existe em um conteúdo.

• Quando o robô precisar validar informações em arquivos ou textos.

• Quando processos automatizados exigirem verificação de conteúdos antes de executar ações.

Quando não usar

Não utilizar quando não houver necessidade de realizar buscas em conteúdo textual ou quando o conteúdo já estiver estruturado em variáveis ou tabelas de dados.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô.
Componente de Texto	Define o componente ou objeto de texto onde a busca será realizada.
Arquivo	Permite realizar a busca diretamente em um arquivo de texto.
Pesquisar	Texto ou expressão que será buscada no conteúdo.

---

Exemplos

Exemplo simples

Fluxo básico para verificar se um texto existe em um conteúdo:

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

2. Selecionar o Componente de Texto que será analisado.

3. Informar o valor no campo Pesquisar.

4. Executar o robô.

Após a execução, a propriedade FoundText indicará se o texto foi encontrado.

Exemplo aplicado

Cenário: um robô precisa verificar se um arquivo contém uma palavra específica antes de continuar o processamento.

Fluxo:

1. O robô carrega o conteúdo de um arquivo.

2. O objeto Pesquisar Texto realiza a busca por um termo específico.

3. Caso o texto seja encontrado, o robô executa ações adicionais.

4. Caso contrário, o fluxo segue para outra etapa.

---

Erros comuns e como evitar

Componente de texto não definido

Se nenhum componente ou arquivo for definido, a busca não poderá ser realizada.

Como evitar:

• Garantir que o Componente de Texto ou Arquivo esteja corretamente configurado.

Texto não encontrado

Se o conteúdo pesquisado não existir no texto analisado, o resultado será negativo.

Como evitar:

• Confirmar que o valor informado corresponde ao conteúdo esperado.

---

Boas práticas

• Definir claramente o conteúdo que será pesquisado.

• Utilizar o resultado da propriedade FoundText para controlar decisões no fluxo do robô.

• Garantir que o texto ou arquivo esteja disponível antes da execução da pesquisa.

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