# Get Data from Range

Read values from a range of cells in an Excel document.

<table data-header-hidden><thead><tr><th width="201"></th><th width="358"></th></tr></thead><tbody><tr><td>Document Link</td><td>[Link] The link to the document currently being worked on. The variable name in this property must match the variable name in the "Document Link" property of the "Create Document" or "Open Document" blocks from the Excel group that were previously used to create or open this document.</td></tr><tr><td>Sheet</td><td>[Number/Text] ID (ordinal number) or name of the sheet where the required cell is located. Numbering starts<br>from 1.</td></tr><tr><td>Range</td><td>[Text] The range of cells from which data needs to be read (for example, "B4", "A1:C4"). If only the starting cell is specified, data will be read to the end of filled rows/columns (cells are considered filled if formatted or if there is a value in the cell). The value also accepts <code>*</code> for patterns (for example, "B4:*", "A1:*4", "A1:E*").</td></tr><tr><td>Has Headers</td><td>If enabled, the first row of the read range will be treated as the column headers of the table.</td></tr><tr><td>Include Empty</td><td>If enabled, empty cell values will be counted when calculating the number of rows and/or columns.</td></tr><tr><td>Include Hidden</td><td>If enabled, hidden rows or columns will be counted when calculating the number of rows and/or columns.</td></tr><tr><td>Result</td><td>[Data Table] Returns the contents of the range of cells.</td></tr><tr><td>Error Handling Level</td><td><p>Select the error handling level. Possible values:</p><ul><li>"Default" - by default;</li><li>"Ignore" - errors are ignored;</li><li>"Handle" - errors are handled.</li></ul><p>If "Default" is selected, the value from the "Start" block of this diagram will be used.</p></td></tr><tr><td>Message Level</td><td><p>Select the message level that blocks will output during operation. Possible values:</p><ul><li>"Default" - by default;</li><li>"Release" - output is disabled;</li><li>"Debug" - main information output;</li><li>"Detailed" - detailed information output.</li></ul><p>If "Default" is selected, the value from the "Start" block of this diagram will be used.</p></td></tr><tr><td>Error Text</td><td>[Text] Returns detailed information about the error in case of incorrect execution of the block's work.</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/en/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.