读取单元格

UiPath.MicrosoftOffice365.Activities.Excel.ReadCell

描述

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

检索单元格值后，活动会根据所选值类型 (ValueType) 将其作为 String 返回。

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

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

其他

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

选项

• “值类型 ” - 从文档中读取的数据类型。 使用下拉列表选择以下三个选项之一：

  • 值 - 默认值。 检索行中单元格的编码值（即后端）。 这可能与 Excel 工作表中显示的格式值不同（例如，如果工作表中的单元格显示 23.00，则返回的编码值为 23）。
  • “公式 ” - 仅检索指定单元格的公式（例如 =SUM(A1,B1)）。 如果您选择“ 公式 ”，并且指定的单元格不包含公式，则返回的值默认为“ 值”。
  • “文本 ” - 检索单元格的 Excel 工作表值（例如，如果工作表中的单元格显示 23.00，则返回的文本值为 23.00）。

输出

• “单元格值 ” - 单元格的内容。 如果您计划在后续活动中使用输出数据，则为必需。

工作方式

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

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

7. 运行活动。

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