Read range

Read Range feature enables you to read data from a given range when the range is mentioned explicitly else, reads the entire sheet. This is also applicable for tables as well.


Using Read Range feature

  1. Make sure the prerequisites for using Office 365 activities are met.
  2. In the Canvas Tools pane, click Office 365 Services to expand the tool and view the associated activities. 
  3. Drag the Excel 365 activity inside the Office 365 Application Activity. Ensure that the output token of the OAuth process is passed on to the Excel activity for authentication. For more information, see OAuth Activity.
    1. The validation error symbol disappears when you select relevant values in the particular field from the available list. For example,  Access Token, Read Range, and Output. 

  4. In the Access Token list, select the output parameter holding the value of access token from the OAuth activity to pass in the Excel 365 activity. For more information, see OAuth activity.
  5. In the Feature list, select Read Range.
    1. Click the  (Setting) icon to configure the input configuration. The Input Configuration screen appears.



    2. Ensure to define all the input parameters as an in argument in the Parameter bar for selection in the mandatory and advanced options.
      1. Mandatory Options:
        1. In the workbook, select the parameter holding along with workbook name or name (if workbook is in root folder) of the workbook from which the data is to be read as per the given Office Excel365 range. For example, FolderName/WorkbookName.xlsx. Ensure to add the extension of excel while providing the name of workbook. i.e.xlsx.
        2. In the worksheet, select the parameter holding the name of the Excel sheet from which the data is to be read as per the given range.
      2. Advanced Options:
        1. In the address, select the parameter holding the excel range from which the data is to be read.
        2. Click Delete to remove the input parameter from the list.
    3. You can select the Is Default Value checkbox to set the selected input parameter as the default value.
    4. Once done, click Confirm.
  6. In the Output list, select the argument which should store the result. The argument should be of Out Direction.
  7. Save the process. 
  8. In the Tool bar, click Setup Environment.
  9. Once environment setup is completed perform the Test Run. The studio console will display the successful message with the required output else output will be blank.
    1. Output is of the format : 

      [
      [
      1,
      3
      ],
      [
      2,
      4
      ]
      ]