历史版本14 :[直连]仪表板URL直接添加参数条件传参 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1、描述编辑

在开启了实时数据,使用直连数据库时,FineBI支持在在SQL数据集中添加参数,添加的参数在前端仪表板中能够绑定使用,且能够通过参数的创建传递来实现部分指标的过滤功能。

在FineBI5.0版本中默认支持该功能,不需要任何的配置修改。比如我们想要在打开门店相关仪表板URL的时候,直接添加相关参数,就可以实现仪表板过滤出管理店数据的效果。下面我们介绍一下如何添加并使用参数传递。

注:该URL参数传递功能仅使用开启实时数据的仪表板支持,更新到本地的数据不支持。    

2、参数添加编辑

在业务包中新建带参数的SQL数据集,如select * from new_dian where 店性质 in ('${店性质}'),SQL数据集的创建请参考添加SQL数据集。如下图,在输入带参数的SQL语句后,点击刷新按钮,参数设置框会自动获取SQL语句中的参数,可以修改参数的字段类型和默认值,右侧为该SQL语句的数据预览框。比如我们设置店性质参数的默认值为自有店,则数据预览处即为通过SQL语句获取的所有自有店的数据。

select * from new_dian where 店性质 in ('${店性质}')

222

点击右上角的确定按钮,该SQL数据集即创建成功。需要为该SQL数据集开启实时数据,如下图,点击开启门店数据表右侧的实时数据按钮。

222

注:若未开启实时数据直连数据库,则不能进行后续前端的参数传递实现指标过滤。  

3、参数使用编辑

3.1 参数默认值

新建一张仪表板,选择刚刚创建的带参数的SQL数据表,拖入“店性质”和“记录数”字段,选择分组表,如下图:

222

在组件预览处可以看到,店性质字段显示为参数默认值自有店,如下图:

222

3.2 公共链接参数传递

若要实现在URL中的参数传递过滤,首先需要获取该仪表板的URL。进入仪表板节点,对新建的仪表板选择创建公共链接,如下图:

222

点击开启公共链接并复制,如下图:

222

在获取的URL后添加 &参数名称=参数值,比如获取的链接为:http://120.27.40.246:37799/webroot/decision/v5/design/report/share/7352147fc403469596a2a61b1c6b111f?link=eyJhbGciOiJIUzI1NiJ9.eyJyZXBvcnRJZCI6IjczNTIxNDdmYzQwMzQ2OTU5NmEyYTYxYjFjNmIxMTFmIiwidXNlcklkIjoiYjVmMGMyZWUtNjQwZi00MDM5LWE0ZDQtOTE4YjU1MzU0ODk4IiwianRpIjoiand0In0.49ETHgp71zXVeosRoxVV-re77-6HPyM-mSUrsm4QVp8

在最后添加&店性质=管理店,如:

http://120.27.40.246:37799/webroot/decision/v5/design/report/share/7352147fc403469596a2a61b1c6b111f?link=eyJhbGciOiJIUzI1NiJ9.eyJyZXBvcnRJZCI6IjczNTIxNDdmYzQwMzQ2OTU5NmEyYTYxYjFjNmIxMTFmIiwidXNlcklkIjoiYjVmMGMyZWUtNjQwZi00MDM5LWE0ZDQtOTE4YjU1MzU0ODk4IiwianRpIjoiand0In0.49ETHgp71zXVeosRoxVV-re77-6HPyM-mSUrsm4QVp8&店性质=管理店

在地址栏输入添加参数后的URL,可以看到通过URL中的参数传递,实现了管理店的过滤,如下图:

222

注:若浏览器不支持中文参数,即该参数传递过滤不生效,就需要把json类型的url参数值先进行编码encodeURIComponent()。比如edge浏览器。  

3.3 预览链接参数传递

除了上述通过公共链接获取URL添加参数传递外,还可以在仪表板预览的时候直接加上?参数名称=参数值,来进行参数的传递。

比如,对于之前创建的仪表板,直接点击预览后可以获取预览的URL,如下图:

222

直接在预览的URL后加入?店性质=管理店,如下图:

222

可以看到下方的分组表中过滤出了管理店的数据,实现了参数的传递功能。

4、多个参数使用编辑

在有多个参数的时候,URL同样可以通过添加参数来实现多个条件过滤的效果。

4.1 添加多个参数

添加SQL数据集,输入带参数的SQL语句,包含多个参数,如下图:

select * from new_dian where 店性质 in ('${店性质}' ) and 店风格 in ('${店风格}' )

222

点击确定保存该SQL数据集,同样为其开启实时数据按钮。

4.2 参数传递使用

同样使用该数据表的字段创建组件,包含“店性质”、“店风格”、“记录数”字段,如下图,组件中显示字段值均为参数默认值。

222

参考第三章节获取链接的方式,获取该仪表板的链接,在获取的URL之后加上对应格式多个参数及值(公共链接为&参数名称1=参数值1&参数名称2=参数值2,预览链接为?参数名称1=参数值1& 参数名称2=参数值2)。比如获取的预览URL为:

http://120.27.40.246:37799/webroot/decision/v5/design/report/878c220611794e31abd9f705793ec3b0/view

我们为其加上参数?店性质=管理店&店风格=生活馆,添加参数后的URL为:

http://120.27.40.246:37799/webroot/decision/v5/design/report/878c220611794e31abd9f705793ec3b0/view?店性质=管理店&店风格=生活馆

添加参数后仪表板可以直接过滤出对应的参数值,如下图:

222