读取范围

UiPath.GSuite.Activities.ReadRangeConnections

描述

读取并保存指定范围的内容，以在活动中使用，例如 “ 写入范围”。

作用域

此活动需要以下作用域：

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

或

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

或

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

或

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

项目兼容性

Windows | 跨平台

配置

• “Google 表格连接”- 要在活动中使用的 Google Workspace 帐户连接。
• 电子表格- 选择要从中读取或使用变量/URL 或 ID 的电子表格，并使用范围列定义电子表格。 使用模板，活动可以生成范围和列。 单击文件夹图标即可浏览 Google 云端硬盘文件夹并选择电子表格。 此选项接受IResource形式的输入。 使用查看更多按钮菜单以切换到使用变量或URL 或 ID输入 ( String ) 模式。
  • 如果选择“ 使用变量”，则可以使用其他活动（例如“ 创建电子表格”）中的输出变量。
  • 电子表格 URL - 相关电子表格的 URL 或 ID。 当选择 URL 或 ID 作为输入模式时，此字段可用。 此属性支持 String 变量和字符串格式的值。 有关详细信息，请参阅 如何检索电子表格 ID。
  • 电子表格示例- 要使用的电子表格模板。 单击“使用电子表格模板” 后，该字段可见。 浏览 Google 云端硬盘文件夹并选择一个电子表格。 在 Studio Desktop 中，该选项可从 “范围”旁边的“查看更多”按钮菜单选择。 要了解更多信息，请参阅使用模板。

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

• 范围- 配置工作簿后，选择要从中读取的范围。 此字段已预先填充从所选电子表格或电子表格示例中检索到的信息。 您还可以添加自定义范围，例如Sheet1C5:F10或命名范围，例如 Clients。 此属性支持String变量和字符串格式的值。

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

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

• “包含标题 ” - 指定范围中的第一行是否为标题行。 此属性支持布尔值。
• “读取内容” - 指定要 读取的值的类型。 可用选项包括“ 值”、“ 值和公式”以及“ 文本”。

其他选项

输出

• 读取范围- 存储在DataTable变量中的范围信息。
• 读取信息 - 所选范围的详细信息，存储在 RangeInformation 变量中。

请求的已知限制

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

示例

另请参阅：

• 表格活动
• 写入范围
• 创建电子表格
• 遍历电子表格中的每一行