写入范围

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。
  • 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 button menu next to Range. This field accepts IResource input. To learn more, see Working with templates.

  • 如果您已修改文件夹并需要检索最新数据，请选择“重新加载文件数据”选项。

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

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

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

• 如何写入 - 指定如何将数据添加到指定范围。 可用选项包括：
  • “覆盖 ” - 覆盖以前存在的任何数据。
  • “附加 ” - 将数据写入找到的第一个空行。
  • 右侧附加 - 将数据写入找到的第一个空列。 有关更多信息，请参见下面的“ 附加 部分”。
  • 插入 - 插入行。
• What to write - The DataTable data that will be written in the spreadsheet. This property supports DataTable variables. For example, you can use the output variable of a Read range activity.

附加

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

请求的已知限制

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

示例

另请参阅：

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