读取范围

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

描述

使用 Microsoft Graph 获取范围 API 从工作簿 (“Workbook”) 工作表 (“工作表名称”) 的指定单元格范围 (“范围”) 中检索值。检索单元格数据范围后，该活动会将值输出到 DataTable (“数据表”)。

作用域

此活动需要以下作用域：

• 站点。只读。全部

或

• Sites.ReadWrite.All

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

• “显示名称”- 活动的显示名称。此属性支持 String 变量和字符串格式的值。

输入

• “范围 ” - 要读取的单元格范围。 如果未指定范围，则读取整个工作表。 以 A1 样式表示法输入单元格范围（例如 "A1:A5"）。 此属性支持 String 变量和字符串格式的值。
• “工作表名称”- 从中读取数据的工作表的名称。此属性支持 String 变量和字符串格式的值。
• 工作簿 - 读取其数据的 DriveItem 。 可以使用“ 查找文件和文件夹” 活动检索此对象。 使用 “ 查找文件和文件夹” （ “第一个 ”或 “ 结果”）或 “ 创建 Workbook （Workbook”）活动中的输出属性变量。 使用“ 查找文件和文件夹” 活动的“结果”输出属性时，请务必在数组中指定要使用的项目（例如， myWorkbooks(0)）。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。该字段仅支持“布尔值”。

选项

• “添加标头 ” - 如果选中，则范围中的第一行将添加到 数据表中的 sd 列标头。 此字段支持布尔值。

• “值类型 ” - 从文档中读取的数据类型。 使用下拉列表选择以下三个选项之一：

  • 值 - 默认值。 检索行中单元格的编码值（即后端）。 这可能与 Excel 工作表中显示的格式值不同（例如，如果工作表中的单元格显示 23.00，则返回的编码值为 23）。
  • “公式 ” - 仅检索指定单元格的公式（例如 =SUM(A1,B1)）。 如果您选择“ 公式 ”，并且指定的单元格不包含公式，则返回的值默认为“ 值”。
  • “文本 ” - 检索单元格的 Excel 工作表值（例如，如果工作表中的单元格显示 23.00，则返回的文本值为 23.00）。

输出

• 数据表 - 读取的结果。 此字段仅支持 DataTable 变量。 如果您计划在后续活动中使用输出数据，则为必填项。 要获取 数据表 内容，请使用具有 DataTable 输入属性（例如， 输出数据表、 遍历循环 行、 附加到 CSV等）的活动。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成步骤。
2. 将“ Microsoft Office 365 作用域 ”活动添加到您的项目中。
3. 添加活动或运行输出 DriveItem 对象的外部流程（例如， 查找文件和文件夹、 创建工作簿、 复制项目）。
4. 在“Microsoft Office 365 作用域”活动中添加“读取行”活动。
5. 输入“输入”属性的值。
6. 为“输出”属性创建并输入 DataTable 变量。

7. 运行活动。

   • 您的输入属性值将发送到“获取范围”API。
   • API 会将 DataTable 值返回到您的输出属性变量。