# 参数

参数是当前页面的一组变量,改变参数的值可以触发引用了参数的组件刷新或引用了参数的数据集刷新。参数的值可以通过URL参数传递、也可以通过交互(设置参数值)修改,使用参数可以方便的实现各种灵活交互效果,如点击环形占比图华中大区,折扣率标题前会加上华中名称,点击不同大区,标题也会随之对应改变:

参数

# 使用参数

使用参数

  1. 点击页面工具栏中的参数按钮,弹出参数设置对话框
  2. 点击+,弹出新增参数对话框,名称输入dq,描述为大区,点击确定即可

# 参数设置

参数设置

  • 名称:参数的名称,一般使用简洁易懂的小写英文字母,如dq
  • 表达式:可设置动态表达式,设置固定值则为默认值
  • 描述:参数的详细业务描述,一般是对名称进行一个中文的描述补充,让人易懂参数的作用
  • 忽略空值:勾选后,将自动忽略存在空值的参数,即空值时相当于没有设置参数。如使用参数过滤数据,参数未设置默认值时,忽略空值会显示所有数据,反之,会显示该参数的值为空时的数据
  • 操作按钮
    • 新增:新增参数
    • 编辑:可对添加的参数进行编辑
    • 查看引用:查看该参数在当前页面中被引用的地方,可以点击引用进行定位,具体可查看文档查看引用
    • 删除:删除参数。如果参数被引用了,点击删除时会给出友好提示;若强制删除,引用的表达式会报错,通过点击右上角红色报错数字,可快速定位问题位置

# 应用场景

参数只能在当前页面被使用,部分交互或组件可以获取到其他页面的参数,并使用参数作为数据传递的桥梁,实现对其他页面的数据过滤。参数使用场景通常有以下几种:

  1. 通过参数改变组件的数据,如改变组件的标题
  2. 通过参数过滤数据,如打开链接获取参数进行数据过滤
  3. 通过参数判定组件的显示与隐藏
  4. 通过地址栏修改URL传递参数

# 通过参数改变组件数据

当点击不同数据时,想要标题也随所点击的数据发生改变,则可以使用参数设置参数值交互搭配使用,根据数据不同改变参数的值,然后将参数填写在想要改变数据的地方即可。如点击环形占比图不同的大区,其他图形上方标题会同步显示对应的大区名称,实现思路如下:

  1. 在当前页面设置参数dq
  2. 添加设置参数值交互,点击编辑参数,参数名称选择dq数据源选择大区选择显示值即可,具体可查看文档设置参数值交互
  3. 在标题处添加参数即可,如${[dq]}折扣率

通过参数改变组件数据

# 通过参数过滤数据

点击数据打开目标页面时,想要在当前页面点击不同的数据,打开的目标页面就自动过滤数据,则可以在打开链接交互中获取目标页面的参数,使用参数传递数据,从而达到过滤数据的效果。如点击各类别产品销量,能根据环形占比所选的大区查看对应大区的销售详情数据,实现思路如下:

  1. 在打开链接目标页面中设置参数,即在销售详情页面设置参数dq
  2. 各类别产品销量条形图设置打开链接交互,参数名中能自动识别到目标页面中的参数,选择dq,参数值设置当前页面的参数dq即可
  3. 在目标页面的模型表上添加参数过滤条件即可实现过滤数据,如[dq]=[门店销售明细表].[区域编码].[大区]

地址栏修改url传递参数过滤数据

# 通过参数显示隐藏组件

想要组件能实现动态的显示隐藏效果,也可以使用动态参数来控制,比如设置参数值交互或者打开链接传递不同的参数值来动态改变参数,最后在组件的显示属性中写入参数的表达式即可。如点击隐藏按钮,可以隐藏说明文字,点击显示可以显示说明文字,实现思路如下:

  1. 设置参数xs,并设置默认值为1
  2. 改变参数值
    • 隐藏按钮上添加设置参数值交互,将参数值改为0,启用条件设置为[xs]=1
    • 再添加一个设置参数值交互,将参数值改为1,启用条件设置为[xs]=0
  3. 在想要动态显示隐藏的组件显示属性中选择条件,并写入表达式,如[xs]=1,即可动态显示组件

动态显示隐藏

# 地址栏修改URL传递参数

通过在URL后面传递参数也能给参数设置初始值,常用于将页面嵌入到第三方系统中。

需要注意的是URL的参数名是使用页面中定义好的参数的参数ID,即参数名称;参数值需要符合URL参数的编码规范,示例如下:

  1. 参数值为数字:https://demo.succbi.com/DEMO/ana/报表/分组报表/钻取子表/数值分段表.rpt?p_y=2018
  2. 参数值为中文,需要将中文进行编码:https://demo.succbi.com/DEMO/ana/报表/分组报表/钻取子表/数值分段表.rpt?dq=%E5%8D%8E%E4%B8%AD
  3. 多个参数值,以&符连接:https://demo.succbi.com/DEMO/ana/报表/分组报表/钻取子表/数值分段表.rpt?p_y=2018&dq=%E5%8D%8E%E4%B8%AD

点击此处体验 (opens new window)

地址栏修改URL传递参数

是否有帮助?
0条评论
评论