# Buscar e Substituir

## Visão Geral

O objeto **Buscar e Substituir** é utilizado para **localizar um texto específico dentro de um documento do Microsoft Word e substituí-lo por outro valor** durante a execução do robô.

Esse objeto permite automatizar alterações em documentos Word, possibilitando a substituição dinâmica de informações dentro do conteúdo do arquivo.

A funcionalidade é amplamente utilizada em automações que geram ou atualizam documentos, permitindo que valores padrão sejam **substituídos por dados dinâmicos provenientes do fluxo do robô**.

Esse recurso é frequentemente utilizado em automações que envolvem:

* Geração automática de documentos Word
* Atualização de conteúdos em documentos existentes
* Substituição de placeholders em modelos de documentos

***

## Funcionamento

O objeto executa a **busca de um texto específico dentro de um documento Word e substitui esse texto por outro valor configurado**.

O fluxo de funcionamento ocorre da seguinte forma:

1. O usuário seleciona um **objeto do tipo Word previamente aberto no fluxo do robô**.
2. Define o **texto que será localizado no documento**.
3. Informa o **novo valor que substituirá o texto encontrado**.
4. Durante a execução do robô, o sistema percorre o conteúdo do documento e realiza a substituição conforme configurado.

### Quando usar

* Quando for necessário **substituir textos dentro de um documento Word automaticamente**.
* Quando a automação utiliza **modelos de documentos com placeholders**.
* Em processos que exigem **atualização automática de informações em documentos**.

### Quando não usar

* Quando não houver necessidade de **alterar o conteúdo do documento Word**.
* Quando o documento não estiver **aberto no fluxo da automação**.

***

## Configuração

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FCfH6WV7ebekzkTtQQf9w%2Fimage.png?alt=media&#x26;token=35c898e8-4925-493e-9f1a-545666bc0edb" alt=""><figcaption></figcaption></figure>

| CAMPO                              | DESCRITIVO                                                                               |
| ---------------------------------- | ---------------------------------------------------------------------------------------- |
| **Título**                         | Nome do objeto dentro do fluxo do robô. Permite identificar a etapa da automação.        |
| **Selecionar objeto do tipo Word** | Define o objeto Word previamente aberto que será utilizado para realizar a substituição. |
| **De**                             | Texto que será localizado dentro do documento Word.                                      |
| **Para**                           | Valor que substituirá o texto encontrado no documento.                                   |

Observação:

* O objeto realiza a substituição diretamente no **conteúdo do documento Word utilizado no fluxo do robô**.

***

## Exemplos

### Exemplo simples

Substituir um texto em um documento Word.

Fluxo:

1. Utilizar o objeto **Abrir Word** para abrir um documento.
2. Adicionar o objeto **Buscar e Substituir**.
3. Selecionar o **objeto Word** aberto.
4. Informar o texto que será buscado no campo **De**.
5. Informar o novo valor no campo **Para**.
6. Executar o robô para atualizar o conteúdo do documento.

### Exemplo aplicado

Gerar documentos personalizados a partir de um modelo Word.

Fluxo possível:

1. Utilizar um **modelo de documento Word** contendo placeholders, como:\
   `{{nome_cliente}}`, `{{data}}`, `{{valor}}`.
2. Abrir o documento utilizando o objeto **Abrir Word**.
3. Utilizar **Buscar e Substituir** para substituir cada placeholder pelos valores reais.
4. Gerar um documento final com **dados personalizados**.

***

## Retornos

Este objeto **não retorna valores diretamente**.

Ele realiza a **substituição de texto dentro do documento Word utilizado no fluxo do robô**.

***

## Erros comuns e como evitar

| Erro                        | Como evitar                                                          |
| --------------------------- | -------------------------------------------------------------------- |
| Objeto Word não selecionado | Garantir que um **objeto Word válido esteja aberto no fluxo**        |
| Texto não encontrado        | Verificar se o **texto informado no campo "De" existe no documento** |
| Substituição incorreta      | Confirmar se o **valor informado no campo "Para" está correto**      |

***

## Boas práticas

* Utilize **placeholders padronizados** em modelos de documentos Word.
* Verifique se o texto utilizado na busca corresponde exatamente ao conteúdo do documento.
* Utilize nomes claros para os valores que serão substituídos.
* Execute a substituição após abrir corretamente o documento Word.