# Busca de texto

Busca de texto em um documento Excel. Para encontrar a próxima célula com o texto especificado, o bloco pode ser reutilizado.

<table data-header-hidden><thead><tr><th width="202"></th><th width="347"></th></tr></thead><tbody><tr><td>Link para o documento</td><td>[Link] Link para o documento com o qual está sendo trabalhado no momento. O nome da variável nesta propriedade deve corresponder ao nome da variável na propriedade "Link para o documento", dos blocos "Criar documento" ou "Abrir documento" do grupo Excel, que foram usados anteriormente para criar ou abrir este documento.</td></tr><tr><td>Planilha</td><td>[Número/Text] ID (número sequencial) ou nome da planilha onde a célula desejada está localizada. A numeração começa em 1.</td></tr><tr><td>Texto</td><td>[Texto] String que precisa ser encontrada.</td></tr><tr><td>Ordem de busca</td><td><p>Especifica a ordem de busca. Valores possíveis:</p><ul><li>ByColumns - a busca é realizada por colunas;</li><li>ByRows - a busca é realizada por linhas.</li></ul></td></tr><tr><td>De linha</td><td>[Número] Número da linha a partir da qual a busca começa. A numeração começa em 1. Se o valor estiver vazio, o número será igual ao valor mínimo.</td></tr><tr><td>De coluna</td><td>[Número] Número da coluna a partir da qual a busca começa. A numeração começa em 1. Se o valor estiver vazio, o número será igual ao valor mínimo.</td></tr><tr><td>Célula inteira</td><td>Se ativado, o conteúdo da célula deve corresponder a todo o texto da busca.</td></tr><tr><td>Linha</td><td>[Número] Se o texto for encontrado, o número da linha é retornado na propriedade. A numeração começa em 1.</td></tr><tr><td>Coluna</td><td>[Número] Se o texto for encontrado, o número da coluna é retornado na propriedade. A numeração começa em 1.</td></tr><tr><td>Endereço da célula</td><td>[Texto] Endereço da célula.</td></tr><tr><td>Nível de tratamento</td><td><p>Seleção do nível de tratamento de erros. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Ignore" - erros são ignorados;</li><li>"Handle" - erros são tratados.</li></ul><p>Se o valor "Default" for selecionado, o valor do bloco "Início" deste diagrama será utilizado.</p></td></tr><tr><td>Direção de saída</td><td><p>Seleção da direção de saída do bloco em caso de erro. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Right" - para a direita;</li><li>"Bottom" - para baixo.</li></ul><p>Esta propriedade permite determinar a direção de saída em caso de erros para blocos que não contêm o conector "Se erro" (por exemplo, o bloco "Condição"). Se o valor "Default" for selecionado, o valor do bloco "Início" deste diagrama será utilizado.</p></td></tr><tr><td>Nível de mensagens</td><td><p>Seleção do nível de mensagens que os blocos exibirão durante a execução. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Release" - saída desativada;</li><li>"Debug" - saída de informações principais;</li><li>"Detailed" - saída de informações detalhadas.</li></ul><p>Se o valor "Default" for selecionado, o valor do bloco "Início" deste diagrama será utilizado.</p></td></tr><tr><td>Texto do erro</td><td>[Texto] Retorna informações detalhadas sobre o erro em caso de execução incorreta do bloco.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/spravochnik-blokov/excel-excel-automation/poisk-teksta-findtextexcel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.