读取Excel单元格/区域
读取Excel单元格/区域组件可以获取目标单元格的值、区域对应的数据表或增强数据表，并且支持直接获取可见文本。
# 前提条件
已打开目标Excel工作簿，请详情参见打开/新建Excel文件 (opens new window)。
# 组件说明
使用CubeRPA 7.1.2及其以下版本需注意：当单元格的值为时间格式时，使用本组件获取到的时间将默认添加8小时，请手动校正时间后再使用。例如，Excel单元格中的值为
1996/01/02 18:00,使用低版本的组件读取结果为1996/01/03 01:00，请手动校正后再使用。
# 常规设置
| 配置项 | 说明 |
|---|---|
| 读取目标类型 | 支持单元格和区域两种类型。 |
| 单元格位置 | 单元格坐标位置，支持常用对象、自定义表达两种输入方式。 |
| 区域位置 | 区域的坐标位置，支持常用对象、自定义表达式两种输入方式，仅当读取目标类型为区域时需要设置。当区域位置的输入方式为Excel文件>自定义区域时，支持已使用工作表区域和矩形范围两种方式。两种方式的含义，请参见Excel已使用区域和矩形范围分别指什么 (opens new window)。 |
| 输出结果类型 | 支持数据表和增强数据表两种类型，仅当读取目标类型为区域时需要设置。在读取数据量较大的可见文本内容时，增强数据表的效率明显优于数据表，建议使用增强数据表。 |
| 读取可见文本 | 勾选后可获取可见文本。 |
| 读取隐藏行 | 勾选后可读取隐藏行数据，仅当读取目标类型为区域时需要设置。 |
| 把首行当做列名 | 勾选后可将区域的首行作为列名，未勾选时列名为文本类型的1,2,3...，如需使用请进行类型转换1.toString()。仅当读取目标类型为区域时需要设置。 |
| 结果暂存为 | 将获取的结果暂存为变量，名称可自定义。 |
# 错误处理
详情请参见错误处理 (opens new window)。
# 使用示例
将以下隐藏了第3行的区域A1:B7中的数据以增强数据表的形式输出，读取可见文本并在消息对话框中展示。
流程示例图 
操作步骤
- 通过打开/新建Excel文件组件打开目标Excel文件。
- 通过读取Excel单元格/区域读取指定区域A1:B7的数据并设置为读取可见文本，组件设置如下：
- 通过消息对话框输出增强数据表的数据，为消息内容自定义表达式为
读取Excel区域中的增强数据表.增强型数据表导出为文本({})。
调试结果 
# 常见问题
最近更新时间: {
"value": "2023-11-24",
"effect": true
}