写入范围

UiPath.GSuite.Activities.WriteRangeConnections

描述

将数据表写入所选电子表格中的指定范围。

作用域

此活动需要以下作用域：

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

项目兼容性

Windows | 跨平台

配置

• “Google 表格连接”- 要在活动中使用的 Google Workspace 帐户连接。

• Spreadsheet - Select the Google Sheet file to write in. You can also use a variable and define a spreadsheet template. With a template, the activity can generate the ranges dropdown list. Click the Folder icon to browse Google Drive folders and select a spreadsheet. This option accepts input as IResource. Use the Plus button menu to switch to Use variable or Url or ID (String) input modes.

  • 如果选择“使用变量” ，则可以使用其他活动（例如“创建电子表格”）中的输出变量。
  • 电子表格 URL - 相关电子表格的 URL 或 ID。当选择 URL 或 ID 作为输入模式时，此字段可用。此属性支持 String 变量和字符串格式的值。 有关详细信息，请参阅如何检索电子表格 ID。
  • 电子表格示例- 选择与变量文件具有相同范围的文件。单击使用电子表格模板后，该字段可见。浏览 Google 云端硬盘文件夹并选择一个文件。在桌面版 Studio 中，该选项可从“范围 ”旁边的加号按钮菜单选择。该字段接受IResource输入。要了解更多信息，请参阅使用模板。
  • 如果您已修改文件夹并需要检索最新数据，请选择“重新加载文件数据”选项。

• 范围- 指定要写入或附加数据的范围。您可以添加自定义范围（例如Sheet1!C5:F10 ）或命名范围名称（例如 ）。Clients 。此字段已预先填充从所选电子表格或电子表格示例中检索到的信息。此属性支持String变量和字符串格式的值。

  • 如果您已修改电子表格并需要检索最新数据，请选择“更新范围”选项。

• “包含标头” - 如果选中，则数据表的标头也会插入到电子表格中。此属性支持“布尔值”。

• 如何写入- 指定如何将数据添加到指定范围。可用选项包括：

  • “覆盖” - 覆盖以前存在的任何数据。
  • “附加” - 将数据写入找到的第一个空行。
  • “附加到右侧” - 将数据写入找到的第一个空列。有关更多信息，请参阅下面的附加部分。
  • 插入 - 插入行。

• 写入内容- 将写入电子表格的DataTable数据。此属性支持DataTable变量。例如，您可以使用“读取范围”活动的输出变量。

附加

范围类型	附加（到底部）	附加到右侧
普通范围（A1 表示法）	将范围写入目标范围中找到的第一个空行。 它会创建必要数量的行，并用输入范围填充范围。 如果范围中没有空行，则通过插入必要数量的行并添加输入范围，将范围附加到底部。	将范围写入目标范围中找到的第一个空列。 它会创建必要数量的列，并用输入范围填充范围。 如果范围中没有空列，则通过插入必要数量的列并添加输入范围，将范围附加到右侧。
指定范围	将范围写入目标范围中找到的第一个空行。 它会创建必要数量的行，并用输入范围填充范围。 如果范围中没有空行，则通过插入必要数量的行并添加输入范围，将范围附加到底部。	将范围写入目标范围中找到的第一个空行。 它会创建必要数量的行，并用输入范围填充范围。 如果范围中没有空行，则通过插入必要数量的行并添加输入范围，将范围附加到底部。
工作表	将范围写入目标工作表中找到的第一个空行。 它会创建必要数量的行，并用输入范围填充范围。 如果范围中没有空行，则通过插入必要数量的行并添加输入范围，将范围附加到底部。	将范围写入目标工作表中找到的第一个空列。 它会创建必要数量的列，并用输入范围填充范围。 如果范围中没有空列，则通过插入必要数量的列并添加输入范围，将范围附加到右侧。

请求的已知限制

使用范围时，请注意请求/响应限制。 限制为 4 MB，例如，对于读取请求，平均 10,000 个单元格，每个 20 个字符；对于写入请求，平均 4,000 个单元格，每个 20 个字符。

示例

另请参阅：

• 表格活动
• 读取范围
• 遍历电子表格中的每一行
• 读取单元格