过滤条件通用配置

过滤条件可以与图表配合,使用户通过简单的交互来对需要展示的数据进行过滤和筛选。

当使用API方式绑定图表数据时,过滤条件控制面板中的「查询key值」将会作为过滤条件的「k字段」在访问API时作为参数传递到后端,详见「API方式连接数据源」-「过滤条件API格式」

当使用SQL建模的方式绑定图表数据,「查询key值」将会作为conditions的key嵌入到SQL语句中,如在SQL语句中嵌入下图的过滤条件: {yourFiledName = [conditions.selectKey]},也因此「查询key值」必须要在页面中保证唯一性,(详见「SQL方式连接数据源」-「SQL语句中关联过滤条件」);

过滤条件基础设置

过滤条件的基础设置一般如下:

图片

这里可以配置过滤条件的名称,查询key值,是否必填和展示样式等。

查询key值

如上图中,查询key值是过滤条件在报表中的唯一标识,可以由用户自行设置

图表是API方式绑定数据时,「查询key值」将会作为过滤条件的「k字段」在参数中传递到后端

图表是SQL方式绑定数据时,「查询key值」将会作为conditions的key嵌入到SQL语句中

因此「查询key值」必须要在页面中保证唯一性

过滤条件数据设置

对于输入框下拉单选单选列表复杂逻辑树形选择等类型的过滤条件支持通过「API方式」、「SQL方式」以及「静态录入方式」拉取数据:

图片

其中静态录入方式支持从Excel里直接复制。

各过滤条件的API配置以及返回格式请参照「API方式连接数据源」。

如果选择SQL方式绑定过滤条件数据,需要先建立并绑定SQL模型到过滤条件,具体请参照「SQL方式连接数据源」。

选择SQL方式绑定数据时,各类型过滤条件的个性化配置可以在文档的「过滤条件配置」文件夹下各过滤条件自己的文档中查找。

过滤条件默认值

每种类型的过滤条件都支持配置默认值。一般情况下的默认值都是需要您直接输入的(如 单选:**value1**,多选:**value1,value2,value3**等等),但是针对单选和多选,Sugar支持了相对的异步默认值(如单选默认值可设置为第一项、最后一项之类,这样对于需要API或者SQL建模来异步拉取数据的情况下,就可以做到后端动态的自动调整默认值),如下图:

单选过滤条件的默认值设置:

图片

多选过滤条件的默认值设置:

图片

覆盖过滤条件默认值

有时候当我们在某个页面利用iframe嵌入Sugar的某个报表页的时候,可能希望在报表页的参数处添加一些参数来替代在报表页配置过滤条件的默认值,这个时候我们可以这样做:

在过滤条件中选择好你期望的过滤条件的值,点击查询,比如这里我们选择了下拉单选中的选项2:

图片

此时地址栏中的url的参数中的condition字段中同步出了:conditions=%7B"select"%3A"value2"%7D

直接访问这个url就会发现可以通过这种方式来覆盖过滤条件的第一次加载时的默认值

过滤条件的调试和刷新

过滤条件的调试和刷新与「图表的调试和刷新」大致相同。

本页内容