查找 Excel 内容
组件介绍
查找工作表第一个符合条件内容所在的单元格
截图
属性说明
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 内容 | 字符串 | 空 | 需要进行查找的内容 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 表名 | 字符串 | 空 | 需要操作的工作表名称，为空默认为当前打开的工作表 |
| 起始单元格 | 字符串 | 空 | 开始查找内容的单元格，不写默认为 "A1" |
| 结束单元格 | 字符串 | 空 | 停止查找内容的单元格，不写默认为工作表最后一个单元格 |
| 大小写 | 下拉选项 | 不区分 | 大小写匹配模式： ● 不区分：查找内容与单元格内容的英文字母大小写可以相同，也可以不相同 ● 区分：查找内容与单元格内容的英文字母的大小写必须完全相同 |
| 单元格匹配 | 下拉选项 | 模糊 | 查找内容模式： ● 模糊：单元格内容包含查找内容 ● 精准：查找内容与单元格内容完全相同 （查找内容与单元格内容包含英文字母需要考虑大小写属性） |
| Excel 对象 | 对象 | 空 | 需要切换的 Excel 文件 「打开 Excel」组件返回值对应的 Excel 文件 空默认为上一个「打开 Excel」组件打开的 Excel 文件 |
返回值
| 名称 | 类型 | 说明 |
|---|---|---|
| 单元格位置 | 字符串 | 符合查找条件的第一个单元格，如 "B1" |
| 列名 | 字符串 | 符合查找条件的单元格列名，如 "B" |
| 行号 | 数字 | 符合查找条件的单元格行号，如 1 |
组件示例
- 打开 Excel：文件 "./res/1.xlsx"，其他选填项默认 — "./res/1.xlsx" 表示流程的 res 文件夹下的 1.xlsx 文件，具体介绍详见「打开 Excel」组件
- 查找 Excel 内容：内容 "Ab"，大小写区分，单元格匹配精准，其他选填项默认，返回值单元格位置单元格位置，列名列名，行号行号
- 输出日志：日志单元格位置
- 输出日志：日志列名
- 输出日志：日志行号
- 运行结果：打开 1.xlsx 文件，查找单元格内容为 "Ab" 的单元格，日志面板依次输出找到的单元格、列名及对应行号
名词解析
- 列号、列名：数字列号从数字 1 开始，数据类型为数字；字母列名从字母 A 开始，数据类型为字符串；列号 1、2、3 对应列名 "A"、"B"、"C"，为第 1 列、第 2 列及第 3 列，可使用「数字列号转字母列名」及「字母列名转数字列号」组件将列名及列号进行相互转换。
注意事项
此组件可以不添加到「打开 Excel」或者「指定 Excel 对象」组件（仅支持 v1.3.6 及以上版本编辑器及模拟器），当此组件「Excel 对象」为非空时，操作对象为 Excel 对象对应的 Excel 文件；「Excel 对象」为空默认为上方最近的一个 Excel 对象。
必须安装 2016 及其以上版本 Microsoft Office 软件或者 WPS 软件。
起始单元格不写默认为 "A1"，结束单元格不写默认工作表最后一个单元格。
选填项输入的表名不存在会报错，不写默认为当前打开的工作表，可以使用「所有工作表名」组件获取工作表名称。
大小写与单元格匹配组合使用规则
| 大小写 | 单元格匹配 | 查找内容 | 返回结果 |
|---|---|---|---|
| 不区分 | 模糊 | "Ab" | 包含 Ab、aB、ab、AB 其中任意一个内容（如 *Ab、*ab、Ab 等，* 代表任意字符）的第一个单元格 |
| 不区分 | 精准 | "Ab" | 与 Ab、aB、ab、AB 其中任意一个内容完全相同的第一个单元格 |
| 区分 | 模糊 | "Ab" | 与 Ab 部分内容相同（如 Ab、*Ab、Ab* 等，* 代表任意字符）的第一个单元格 |
| 区分 | 精准 | "Ab" | 与 Ab 内容完全相同的的第一个单元格 |
- 如果出现出现未打开对应 Excel 文件或者此组件报错：RPC 服务器不可用或者报错：组件执行失败的问题，请点击右上角蓝色头像，点击「设置」，点击「关于我们」中 SDK 版本后方的「重置运行环境」按钮后重新运行流程试下。