读取范围

UiPath.GSuite.Activities.ReadRangeConnections

描述

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

备注：

“读取范围”活动在 API 工作流中不可用。

作用域

此活动需要以下作用域：

• 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 中，该选项可从“范围”旁边的“查看更多”按钮菜单。要了解更多信息，请参阅使用模板。
  • 如果您已修改文件夹并需要检索最新数据，请选择“重新加载文件数据”选项。

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

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

• 有标头- 指定范围中的第一行是否为标头行。此属性支持“布尔值”。

• “读取内容” - 指定要读取的值的类型。可用选项为“值” 、 “值和公式”和“文本” 。

其他选项

输出

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

请求的已知限制

使用范围时，请注意请求或响应限制。大小限制为 4 MB。例如，平均有 10,000 个每个包含 20 个字符的单元格用于读取请求，以及 4,000 个每个包含 20 个字符的单元格用于写入请求。

示例

有关更多详细信息，请查看以下资源：

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