筛选
组件介绍
通过条件对 Excel 内容进行筛选
截图
属性说明
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 筛选条件 | 逻辑表达式 | 空 | 筛选数据的条件，点击右侧编辑按钮弹出筛选条件窗口 列支持字母列名及数字列号，具体介绍详见下方名词解析 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 表名 | 字符串 | 空 | 需要操作的工作表名称，为空默认为当前打开的工作表 |
| 标题行 | 数字 | 1 | 指定某一行为标题进行筛选 注意标题行及上方行内容不参与筛选 不填默认第一行为标题行 |
| 筛选结果 | 下拉框 | 正选 | ● 正选：将把符合筛选条件的数据存储到返回值数据表中 ● 反选：将把不符合筛选条件的数据存储到返回值数据表中 |
| Excel 对象 | 对象 | 空 | 需要切换的 Excel 文件 「打开 Excel」组件返回值对应的 Excel 文件 空默认为上一个「打开 Excel」组件打开的 Excel 文件 |
筛选条件向导窗口
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 排序 | 任意类型 | 空 | 对多个筛选条件进行上下排序，按照排序条件依次向下判断 |
| 关系 | 任意类型 | 且 | 每一行都代表一条筛选条件，点击右侧加号可以添加新的条件， 点击删除按钮可以删除对应的条件。 所有筛选条件之间是“且”的关系。 只有当所有条件都符合时，才会输出符合条件的数据表数据。 如果其中任何一个条件不满足，则会返回空数据表 [[]]。 |
| 列 | 数字 字符串 |
空 | 需要进行判断数据列对应列的列名或列号，具体介绍详见名词解析。 如上图中 "B" 表示第二列，也可以写为数字 2 或者字符串 "2"。 您可以通过点击右侧 fx 选择变量。 |
| 筛选条件 | 逻辑表达式 | 文本包含 | 表示进行筛选的判断条件， 包含等于、不等于、大于等条件， 具体介绍详见逻辑表达式 |
| 值 | 任意类型 | 空 | 需要要进行判断列对应的内容， 如上图中的的 2，点击右侧 fx 可以选择变量。 |
| 运算方式 | 下拉选项 | 普通运算 | 数据匹配规则： ● 普通运算：按照值对应的常规格式数据进行匹配。 ● 正则运算：按照值对应的的正则表达式数据进行匹配， 具体的正则运算规则详见正则表达式。 通常情况下，普通运算足以满足大多数数据匹配需求。 当您面对更复杂的数据匹配时，就需要用到正则运算 |
返回值
| 名称 | 类型 | 说明 |
|---|---|---|
| 数据表 | 数据表 | 符合筛选条件的数据表数据 |
| 行号 | 列表 | 符合条件的所在行号组成的列表 不管是一行还是多行，都是返回列表 |
组件示例
- 打开 Excel：文件 "./res/测试.xlsx" —— 请填写正确的文件路径
- 筛选：筛选第 1 列及第 2 列中数据都为 2 的所在行，标题行 1，筛选结果正选，返回值数据表数据表，行号行号
- 输出日志：日志数据表 — 点击 fx 选择变量
- 输出日志：日志行号 — 点击 fx 选择变量
- 取消筛选
- 运行结果：将符合条件的数据筛选出来，并在日志面板输出筛选数据及数据所在行号，恢复筛选前状态
筛选前
筛选后
名词解析
- 列名、列号：字母列名从字母 A 开始，数据类型为字符串；数字列号从数字 1 开始，数据类型为数字；列号 1、2、3 对应列名 "A"、"B"、"C"，为第 1 列、第 2 列及第 3 列，可使用「数字列号转字母列名」及「字母列名转数字列号」组件将列名及列号进行相互转换。
注意事项
- 此组件可以不添加到「打开 Excel」或者「指定 Excel 对象」组件（仅支持 v1.3.6 及以上版本编辑器及机器人），当此组件「Excel 对象」为非空时，操作对象为 Excel 对象对应的 Excel 文件；「Excel 对象」为空默认为上方最近的一个 Excel 对象。
- 必须安装 2016 及其以上版本 Microsoft Office 软件或者 WPS 软件。
- 筛选窗口中的列表示列名及列号，详见名词解析。
- 如果出现出现未打开对应 Excel 文件或者此组件报错：RPC 服务器不可用或者报错：组件执行失败的问题，请点击右上角蓝色头像，点击「设置」，点击「关于我们」中 SDK 版本后方的「重置运行环境」按钮后重新运行流程试下。
- 当您使用此组件时，如果隐藏的行或列符合筛选条件，这些符合条件的行将会被筛选出来并且返回值将出现行号重复问题。