读取列

UiPath.MicrosoftOffice365.Activities.Excel.ReadColumnConnections

描述

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

检索单元格值后，该活动会在 Object[] (列) 中返回列值。

作用域

此活动需要以下作用域：

• Files.ReadWrite

或

• Files.ReadWrite.All

或

• Sites.ReadWrite.All

项目兼容性

Windows | 跨平台

配置

• Microsoft OneDrive 和 SharePoint - 要在活动中使用的 Microsoft 365 帐户的连接。
• workbook - 从中读取数据的DriveItem 。
• Workbook 示例- 选择与变量文件具有相同范围的文件。当您选择“使用 workbook 模板”时，此字段可见。
• 工作表- 从中读取数据的工作表的名称。此属性支持String变量和字符串格式的值。
• 单元格- 列起始单元格的地址。将返回其下方所有相邻的单元格。以 A1 样式表示法输入单个单元格的地址。此属性不支持单元格范围（例如， "A1:A5" ）。此属性支持String变量和字符串格式的值。

输入

• 值类型- 从文档读取的数据类型。使用下拉列表选择以下选项之一：
  • 值 - 默认值。 检索行中单元格的编码值（即后端）。 这可能与 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[] 值返回到您的输出属性变量。