activities
latest
false
重要 :
请注意,此内容已使用机器翻译进行了部分本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

生产力活动

上次更新日期 2025年9月16日

读取范围

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

描述

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

此活动需要以下作用域:

  • 站点。只读。全部

  • Sites.ReadWrite.All

项目兼容性

Windows - Legacy | Windows

配置

属性

常见
  • “显示名称”- 活动的显示名称。此属性支持 String 变量和字符串格式的值。
输入
  • 范围 ” - 要读取的单元格范围。 如果未指定范围,则读取整个工作表。 以 A1 样式表示法输入单元格范围(例如 "A1:A5")。 此属性支持 String 变量和字符串格式的值。
  • “工作表名称”- 从中读取数据的工作表的名称。此属性支持 String 变量和字符串格式的值。
  • 工作簿 - 已读取其数据的 DriveItem 。 可以使用“ 查找文件和文件夹” 活动检索此对象。 使用“ 查找文件和文件夹” (“第一个 ”或“ 结果”)或“ 创建工作簿 (Workbook)”活动中的输出属性变量。 使用“ 查找文件和文件夹” 活动的“结果”输出属性时,请务必指定要使用数组中的哪个项目(例如, myWorkbooks(0))。
其他
  • “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。该字段仅支持“布尔值”。
选项
  • 添加标头 ” - 如果选中,则范围中的第一行将添加到 数据表中的 sd 列标头。 此字段支持布尔值。
  • 值类型 ” - 从文档中读取的数据类型。 使用下拉列表选择以下三个选项之一:

    • - 默认值。 检索行中单元格的编码值(即后端)。 这可能与 Excel 工作表中显示的格式值不同(例如,如果工作表中的单元格显示 23.00,则返回的编码值为 23)。
    • 公式 ” - 仅检索指定单元格的公式(例如 =SUM(A1,B1))。 如果您选择“ 公式 ”,并且指定的单元格不包含公式,则返回的值默认为“ ”。
    • 文本 ” - 检索单元格的 Excel 工作表值(例如,如果工作表中的单元格显示 23.00,则返回的文本值为 23.00)。
输出
  • DataTable - The result of the read. This field supports only DataTable variables. Required if you plan to use the output data in subsequent activities. To get the DataTable contents, use an activity that has a DataTable input property (e.g., Output Data Table, For Each Row, Append to CSV, etc.).

工作方式

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

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

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


  • 描述
  • 项目兼容性
  • 配置
  • 工作 方式

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo
信任与安全
© 2005-2025 UiPath。保留所有权利。