Microsoft Excel

Get Range

Activity retrieves cell values from an indicated range of data.

getrange1
getrange2

Fill in Workbook Name position with custom internal name of your Excel file. Fill in Worksheet Name in properties window.

Fill in Top and Bottom Row, as well as Left and Right Column to determine the limits of data range.

Check FIltered Only to ignore hidden and filtered cells, otherwise activity will retrieve the entire range.

Activity returns a 2-dimensional array of String values.

By default, activity will format the retrieved data according to local system settings. To force an en-us format choose US from Local Settings.

If any of the Excel cells in range were merged, they will be split, with value placed in the top-left cell. The remaining cells that used to be part of the merge will return an empty string.

NameTypeCategoryDescription
Filtered OnlyBooleanInputcheckbox; default is "off"
SettingsDropdownInputselect the appropriate option from the dropdown list
Bottom RowInt32Inputrow number in Excel (bottom boundary of the area)
Left ColumnInt32Inputcolumn number in Excel (left border of the area)
Retry Timeout [s]DoubleInputdetermines behaviour if the activity fails to execute. value < 0: try executing once, 0: try indefinitely; value >0: time in seconds during which the activity repeatedly tries to execute (if time elapses without success then Result = False, end activity)
Right ColumnInt32Inputcolumn number in Excel (right border of the area)
Top RowInt32Inputrow number in Excel (upper boundary)
Workbook NameStringInputcustom internal name Wizlink will use to identify the workbook
Worksheet NameStringInputname of the Excel sheet
Alternative Scenario If FailedBooleanMisccheckbox; default is "on"
Display NameLiteralMiscchanges display name of the activity
Exclude from Transaction CheckBooleanMisccheckbox; default is "off"
ResultBooleanOutputreturns a Boolean value. True if no error in activity, otherwise will return False
Result CodeInt32OutputResult Code will return 0 if there is no error in activity, otherwise in most cases will return 1. See the table of Extended Result Codes for more info
ValuesString[][]Outputvalues retrived from Excel sheet
FullscreenBooleanScreenshotcheckbox; default is "off"
Screenshot PathStringScreenshotdirectory path to save location
Show CursorBooleanScreenshotcheckbox; default is "off"
Window ScreenshotsBooleanScreenshotcheckbox; default is "off"