# Obter dados de um intervalo

Ler valores de um intervalo de células de um documento Excel.

<table data-header-hidden><thead><tr><th width="201"></th><th width="358"></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 coincidir com o 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 requerida está localizada. A numeração começa<br>a partir de 1.</td></tr><tr><td>Intervalo</td><td>[Texto] Intervalo de células de onde os dados devem ser lidos (por exemplo, "B4", "A1:C4"). Ao especificar apenas a célula inicial, os dados serão lidos até o final das linhas/colunas preenchidas (as células são consideradas preenchidas se estiverem formatadas ou se houver um valor na célula). O valor também aceita <code>*</code> em padrões (por exemplo, "B4:*", "A1:*4", "A1:E*").</td></tr><tr><td>Tem cabeçalhos</td><td>Se ativado, a primeira linha do intervalo lido será considerada o cabeçalho das colunas da tabela.</td></tr><tr><td>Considerar vazios</td><td>Se ativado, ao contar o número de linhas e (ou) colunas, os valores vazios das células serão considerados.</td></tr><tr><td>Considerar ocultos</td><td>Se ativado, ao contar o número de linhas e (ou) colunas, as linhas ou colunas ocultas serão consideradas.</td></tr><tr><td>Resultado</td><td>[Tabela de Dados] Retorna o conteúdo do intervalo de células.</td></tr><tr><td>Nível de processamento</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, será utilizado o valor do bloco "Início" deste diagrama.</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, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td>Texto de 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/poluchit-dannye-iz-diapazona-getexcelrange.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.