Microsoft Excel

Find in Range

Fill the WorkbookName position with custom internal name of your Excel file. Put the worksheet name in appropriate textbox in properties window. The search area is determined by the columns and rows indicated in the application parameters: Left and Right, Top and Bottom.

Put the string (or variable) you want to find in TextToFind textbox and choose MatchingType – whether it is all or part of the cell contents.

Use two variables for column and row (in Output part of properties window) – they will store found values - coordinates (numbers of column and row) of the cell, where searched string is located. Wizlink searches a given range of cells by rows and returns first occurrence of searched string. The search is case insensitive.


NOTE: by default, Excel uses the A1 reference style, which refers to columns as letters (A, B, C, ...) and to rows as numbers (1, 2, 3, ...). These letters and numbers are called row and column headings.
Wizlink uses R1C1 reference style only, in which both the rows and the columns on the worksheet are numbered.

You can use the R1C1 reference style in Excel (it is useful if you want to compute row and column positions in macros). In Microsoft Excel: Tools menu > Options > Formulas, and under Working with formulas check the box to allow R1C1 reference style.

Parameter NameParameter TypeIn/OutDescription
Alternative Scenario If FailedBooleanInputcheckbox; default is "on"
Bottom RowInt32Inputrow number in Excel, searching area ends here
Display NameLiteralInputchanges display name of the activity
Exclude from Transaction CheckBooleanInputcheckbox; default is "off"
Left ColumnInt32Inputcolumn number in Excel, left border of the searching area
Matching TypeDropdownInputselect type to match from the dropdown list
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)
Text to FindStringInputthe string to find
Top RowInt32Inputrow number in Excel (upper boundary)
Workbook NameStringInputcustom internal name Wizlink will use to identify the workbook
Worksheet NameStringInputname of the Excel sheet
Out ColumnInt32Outputnumber of Excel column (column numbers start from 1)
Out RowInt32Outputnumber of the Excel row found (row numbers start from 1)
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 it will return 1, the extended result code will show only in several chosen activities