URL参数的传递使用(实时数据)

编辑
  • 文档创建者:doreen0813
  • 浏览次数:9193次
  • 编辑次数:18次
  • 最近更新:susie 于 2019-09-19
  • 1、描述

    功能介绍:

    • 在开启了实时数据,使用直连数据库时,FineBI支持在SQL数据集中添加参数,添加的参数在前端仪表板中能够绑定使用,且能够通过参数的创建传递来实现部分指标的过滤功能。在FineBI5.0版本中默认支持该功能,不需要任何的配置修改。

    应用场景:

    • 比如我们想要在打开门店相关仪表板URL的时候,直接添加相关参数,如http://xxxxxxxx&店性质=管理店直接过滤出管理店数据的效果。下面我们介绍一下如何添加并使用参数传递。

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

    2、参数添加

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

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

      1.png

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

      1.png

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

    3、参数使用

    3.1 参数默认值

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

      1.png

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

      1.png

    3.2 公共链接参数传递

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

      1.png

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

      1.png

    3. 在获取的URL后添加 &参数名称=参数值,比如获取的链接为:

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


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

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

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

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

    3.3 预览链接参数传递

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

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

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

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

    4、多个参数使用

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

    4.1 添加多个参数

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

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

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

    4.2 参数传递使用

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

    2. 参考第三章节获取链接的方式,获取该仪表板的链接,在获取的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?店性质=管理店&店风格=生活馆


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




    附件列表


    主题: 数据可视化
    标签: 暂无标签
    如果您认为本文档还有待完善,请编辑

    文档内容仅供参考,如果你需要获取更多帮助,付费/准付费客户请咨询帆软技术支持
    关于技术问题,您还可以前往帆软社区,点击顶部搜索框旁边的提问按钮
    若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

    此页面有帮助吗?只是浏览 [ 去社区提问 ]