写入范围

UiPath.GSuite.Activities.WriteRangeConnections

描述

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

作用域

此活动需要以下作用域：

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

项目兼容性

Windows | 跨平台

配置

• “Google 表格连接”- 要在活动中使用的 Google Workspace 帐户连接。
• 电子表格 - 选择要写入的 Google Sheet 文件。您还可以使用变量并定义电子表格模板。使用模板，活动可以生成范围下拉列表。单击文件夹 图标以浏览 OneDrive 或 SharePoint 文件夹并选择电子表格。此选项接受 IResource 形式的输入。使用加号 按钮菜单以切换到使用变量或 URL 或 ID (String) 输入模式。
  • 如果选择“ 使用变量”，则可以使用其他活动（例如“ 创建电子表格”）中的输出变量。
  • 电子表格 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 个字符。

示例

另请参阅：

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