activities
latest
false
UiPath logo, featuring letters U and I in white

生产力活动

上次更新日期 2024年12月6日

读取行

UiPath.MicrosoftOffice365.Activities.Excel.ReadRow

描述

使用 Microsoft Graph 获取范围 API 检索工作簿 (Workbook) 工作表 (SheetName) 中指定行 ( StartingCell ) 中单元格的值。

从行中的所有单元格检索数据后,该活动会将值输出到 Object[] (Row) 中。
作用域

此活动需要以下作用域:

  • 站点。只读。全部

  • Sites.ReadWrite.All

项目兼容性

Windows - Legacy | Windows

配置

属性

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

    • - 默认值。 检索行中单元格的编码值(即后端)。 这可能与 Excel 工作表中显示的格式值不同(例如,如果工作表中的单元格显示 23.00,则返回的编码值为 23)。
    • 公式 ” - 仅检索指定单元格的公式(例如 =SUM(A1,B1))。 如果您选择“ 公式 ”,并且指定的单元格不包含公式,则返回的值默认为“ ”。
    • 文本 ” - 检索单元格的 Excel 工作表值(例如,如果工作表中的单元格显示 23.00,则返回的文本值为 23.00)。
输出
  • ” - 以对象数组形式显示的行值。 此字段仅支持 Object[] 变量。 如果您计划在后续活动中使用输出数据,则为必需。

工作方式

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

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

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


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

此页面有帮助吗?

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