activities
latest
false
UiPath logo, featuring letters U and I in white
Productivity Activities
Last updated Nov 21, 2024

Write Column

UiPath.GSuite.Activities.Sheets.WriteColumnConnections

Description

Write a column in a selected Google Sheets file using an Array Column or a Data Column. You can map individual fields to target columns using the individual fields option under Data Column.

Scopes

This activity requires the following scopes:

  • https://www.googleapis.com/auth/drive

OR

  • https://www.googleapis.com/auth/spreadsheets

Project compatibility

Windows | Cross-platform

Configuration

  • Google Sheets connection - The connection for the Google Workspace account to use in the activity.
  • Spreadsheet - The Google spreadsheet to use. Click the Folderdocs image icon to browse Google Drive folders and select a spreadsheet. This option accepts input as IResource. Use the See more button menu to switch to Use variable or Url or ID input (String) modes.
    • If you select Use variable, you can use the output variable from other activities, such as Create Spreadsheet.
    • Spreadsheet URL - The URL or ID of the spreadsheet of interest. This field is available when Url or ID is selected as the input mode. This property supports String variables and string formatted values. For details, see How to retrieve spreadsheet IDs.
    • Spreadsheet sample - Select a file with the same ranges as the variable file. The field is visible after clicking Use spreadsheet template. Browse the Google Drive folders and select a spreadsheet. In Studio Desktop, the option is available from the Plus docs image button menu next to Range. This field accepts IResource input. To learn more, see Working with templates.
    • Select the Reload File Data option if you've modified your folders and need to retrieve the latest data.

  • Range - The range to write in. This field is prepopulated with information retrieved from the selected spreadsheet or spreadsheet sample. This property supports String variables and string formatted values.
    • Select the Update Ranges option if you've modified your sheets and need to retrieve the latest data.

    • Select the Update Fields option if you've modified your workbook and need to retrieve the latest data.

  • How to write - Specifies how to add the data to the specified range. The available options are:
    • Overwrite - Overwrite any previous data that exists. Writes the column in the exact place. If a range with multiple cells is selected, write on the first column.
      • Column Position - The column index position where the activity overwrites the column. The index can be used from iterating on the range columns using Read Range. Columns starts from 0.
    • Append Right - Append data to the right. Default option. Looks for the first empty column to write to, from left to right.
      Note: Appending data does not currently support named ranges.
    • Insert - Insert a column.
      • Column Position - The column index position where the activity overwrites the column. The index can be used from iterating on the range columns using Read Range. Columns starts from 0.
  • What to write - The data in a DataTable that will be written in a workbook. The available options are:
    • Data Column - Use a Data Column as input data.
    • Array Column - Use an Array Column as input data.
    • Individual Fields - Map data to individual target fields.
  • Data Column to write / Array Column to Write - The data in a Data Column or Array Column that will be written in the workbook.
  • Manage Target Individual Columns - Select additional fields for the current object. This field is displayed if you select the What to write - Individual Fields option and if you select a spreadsheet and range. If you use variables, a spreadsheet sample is required.

Example



  • Description
  • Project compatibility
  • Configuration
  • Example

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.