读取行

UiPath.MicrosoftOffice365.Activities.Excel.ReadRow

描述

使用 Microsoft Graph获取范围API 从工作簿 （ Workbook ）工作表 （ SheetName ）中的指定行 （起始单元格）中检索单元格的值。

After retrieving the data from all cells in the row, the activity outputs the values into an Object[] (Row).

作用域

此活动需要以下作用域：

• 站点。只读。全部

或

• Sites.ReadWrite.All

项目兼容性

Windows - Legacy | Windows

配置

属性面板

常见

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

输入

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

其他

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

选项

• Value Type - The type of data that is read from the document. Use the drop-down list to select one of the three options:
  • Values - Default. Retrieves the coded value (i.e., backend) of the cells in the row. This might differ from the format value shown in the Excel worksheet (e.g., if the cell displays 23.00 in the worksheet, the coded value returned is 23).
  • Formulas - Retrieves the formula of the specified cell only (e.g., =SUM(A1,B1)). If you select Formulas and the specified cell doesn't contain a formula, the returned value defaults to Values.
  • Text - Retrieves the Excel worksheet value of the cell (e.g., if the cell displays 23.00 in the worksheet, the text value returned is 23.00).

输出

• Row - The values of the row as an array of objects. This field supports only Object[] variables. Required if you plan to use the output data in subsequent activities.

工作方式

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

1. 完成步骤。
2. 将“Microsoft Office 365 作用域”活动添加到您的项目。
3. 添加活动或运行输出DriveItem对象（例如，查找文件和文件夹、创建 工作簿、复制项目）的外部流程。
4. Add the Read Row activity inside the Microsoft Office 365 Scope activity.
5. 输入“输入”属性的值。
6. 为“输出”属性创建并输入 Object[] 变量。
7. 运行活动。
   • 您的输入属性值将发送到“获取范围” API。
   • API 会将 Object[] 值返回到您的输出属性变量。