一、功能概述

交互查询列表是润乾报表中参数模板、填报表专用的单元格编辑风格，支持前端动态交互检索。用户在输入框录入内容时，系统自动从数据库执行模糊匹配，实时加载候选下拉列表，适用于数据量大、需动态检索的查询场景。同时该功能支持关联过滤，可依托上游单元格的已选内容，联动筛选当前列表数据，实现多级级联查询效果。

二、常规用法：基础模糊查询配置

下面我们使用 demo 数据源中的订单表举例说明：

1、主报表设计如下：

1.1 报表数据集语法为：SELECT * FROM 订单 WHERE 订单. 货主地区 =?

1.2 增加数据集参数：area

1.3 增加报表参数：area

1.4 报表保存为交互查询列表.rpx

2、配置参数模版

1.1 设置 C2 的 web 变量名称为 area

2.2 设置 C2 的编辑风格
1）在数据源名称下拉框中，选择已提前配置好的业务数据源。
2）手动输入‘真实值字段名称’以及‘显示值字段名称’
3）异步加载时的 SQL 为：select DISTINCT 货主地区 from 订单 where 货主地区 LIKE ‘%$1%’
4）配置完成后点击【确定】，保存所有设置。

2.3 报表保存为交互查询列表 _arg.rpx

3、启动服务发布查看报表即可

将配置完成的报表发布至 Web 端后，单元格初始为空白输入框，无默认选项。用户在输入框中录入文字时，系统自动根据录入内容执行模糊查询，匹配结果实时以下拉列表形式展示，供用户选择。

三、关联过滤（级联查询）

使用 demo 数据源中的订单表，地区和城市做关联过滤，地区使用下拉数据集，城市使用交互查询列表。

1、主报表设计

1.1 报表设计不变，将数据集的 sql 改为：SELECT * FROM 订单 WHERE 订单. 货主城市 =?

1.2 数据集参数改为 city

1.3 报表参数增加 city 参数

2、配置参数模版

2.1 增加数据集：SELECT DISTINCT 货主地区 FROM 订单
2.2 C2 单元格 编辑风格设置为下拉数据集，设置显示列和数据列为货主地区。并且设置 web 变量名称为 area

2.3 F2 单元格编辑风格为交互查询列表，设置 web 变量名称为 city
其中异步加载的 sql 为：select DISTINCT 货主地区, 货主城市 from 订单 where 货主城市 LIKE ‘%$1%’ AND 货主地区 = ‘$2’
且增加关联过滤单元格为 C2

3、保存发布查看报表即可。

4、报表示例点击下载：

_argzip

关于异步加载 SQL 的说明：

1.SQL 中应包含真实值和显示值字段名称。
2.SQL 中用宏 $1 占位过滤时传入的参数值，该值会引用页面文本框输入的显示值。
3. 当设置有关联过滤单元格时，SQL 中用宏 $2、$3…符号占位，对应第一个关联格值、第二个关联格值…以此类推
例如：select DISTINCT 货主地区, 货主城市 from 订单 where 货主城市 LIKE ‘%$1%’ AND 货主地区 = ‘$2’

注意：

like 模糊查询需要加’%%’拼接，
若关联过滤的单元格字段为字符串添加需添加引号 ’’ , 若为数值字段直接字段名称 =$2 即可。

数量过滤（列表条数控制）规则如下：
1. 起点、终点均设置为 0：展示所有符合模糊查询、关联过滤条件的数据；
2. 起点设为 1、终点设为 10：仅展示匹配结果中的前 10 条数据；