Description
Gets a particular row value from the Excel file. The 'Save value to a variable' activity appears automatically when choosing the 'Read Excel Row' activity. It automatically saves the value to a variable. However, the activity is not mandatory and can be removed from the workflow.
Studio Pro supports Microsoft Excel .xls and .xlsx file formats.
As of the 8.3 update, there are two ways of interacting with MS Excel - Microsoft Native and Generic. Navigate to the menu "Settings" → "Microsoft activities" to choose a method.
Microsoft Native uses standard Microsoft methods to interact with the Excel application. It requires Excel to be installed on your computer and extends the capabilities of interacting with all Excel functionalities.
Generic does not require Excel to be installed and may have some Excel functionalities limitations.
Parameters
-
Set a value: enables you to write the desired path directly. Clicking the 'Pick' button allows you to manually choose the path.
-
Save the previous step result: chooses the last result activity as a path.
-
Calculate a value: enables you to use available properties and methods to form a path.
Allows you to specify a row for reading.
-
Set a value: enables you to directly write the desired number of the row.
-
Save the previous step result: chooses the last result activity as a number of the row.
-
Calculate a value: enables you to use available properties and methods to form a number of the row.
By default, the first sheet in an Excel file is used.
-
Set a value: enables you to directly specify the sheet name, for example,
Employees
. -
Save the previous step result: chooses the previous activity result as the sheet name.
-
Calculate a value: enables you to use available properties and methods to form the sheet name.
-
Use table headers: select this option if the header contains words specified by the user.
-
Use column letters: select this option if the header contains the standard 'Excel' column names: 'A', 'B', 'C', and so on.
Contains an annotation of the activity. The input text will be displayed above the activity name.
Result
The excel data is stored in the excel_row_content
variable by default. This variable is an array of objects. Each object of the array represents one cell of the table.
For example, if we read the first row (1) we can get such a record:
{
"Column 1": "Value (1,1)",
"Column 2": "Value (1,2)",
"Column 3": "Value (1,3)"
}