读取列

UiPath.MicrosoftOffice365.Activities.Excel.ReadColumn

描述

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

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

作用域

此活动需要以下作用域：

• Files.ReadWrite

或

• Files.ReadWrite.All

或

• Sites.ReadWrite.All

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

• “工作表名称”- 从中读取数据的工作表的名称。此属性支持 String 变量和字符串格式的值。
• “起始单元格”- 列起始单元格的地址。将返回其下方所有相邻的单元格。以 A1 样式表示法输入单个单元格的地址。此属性不支持单元格范围（例如，“A1:A5”）。此属性支持 String 变量和字符串格式的值。
• 工作簿 - 读取其数据的 DriveItem 。 可以使用“ 查找文件和文件夹” 活动检索此对象。 使用 “ 查找文件和文件夹” （ “第一个 ”或 “ 结果”）或 “ 创建 Workbook （Workbook”）活动中的输出属性变量。 使用“ 查找文件和文件夹” 活动的“结果”输出属性时，请务必在数组中指定要使用的项目（例如， 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[] 值返回到您的输出属性变量。