编辑参数和刷新参数

<< Click to Display Table of Contents >>

当前位置:  制作可视化报告 > 参数 

编辑参数和刷新参数

复制链接

1. 编辑参数

数据源、数据集、报告、深度分析等模块所有使用参数的地方,都可以被编辑参数自动收集到,也就是打开编辑参数对话框可以查看到所有使用到的参数。也可以在对话框中添加、删除参数。使用到的参数不能被删除,只能删除定义了却没有被使用到的参数。编辑参数对话框如下图所示。

Database_Param

 

编辑参数中的功能说明如下:

功能项

功能说明

添加 / 删除

添加参数:用户点击添加图标时,弹出名称编辑对话框,用户可设定参数的名称。在设定好参数后,不支持再对此参数进行重命名操作。

删除参数:用户点击删除图标,弹出确认对话框,确认无误后,点击是。如果是收集到的参数,则在此对话框中不能删除此参数,但可以对此参数进行编辑。当被收集的参数在初始设置的地方被删除后,则在此参数对话框中该参数处于可被删除的状态。

参数的用途:添加的参数如果没有任何地方引用,可以用于定制开发场景中,例如通过新加一个参数作为flag,针对不同的资源传递不同的值处理不同的逻辑需求。也可以用于添加产品内置的参数并传值来实现某个功能,参见内置参数的使用

信息

显示参数的被引用的位置。

类型

用户设定该参数的数据类型,详情可参考数据类型与分类

方向

设置参数是否需要输入或返回值,需要和数据库存储过程中定义的一致,详情参考自定义SQL语句查询存储过程

默认

用户可设定参数的默认值。用户可设定单个值、多个值或者空值。

单个值和多个值支持设置固定值、动态值。固定值直接在文本框中输入即可,选择多个值时,用逗号分开输入的多个值。动态值从数据集中取值,支持多种聚合类型,详情可参考数据聚合

弹出参数输入或选择值

当勾选此项时,用户在刷新数据、测试连接、预览数据集或在编辑器中打开此数据集时,会弹出参数值输入框或选择框。当可选值为空时,弹出参数输入框。当可选值为数据集、内嵌数据集时,弹出参数选择框。参考参数弹出窗口

可选值

可设置为以下几项,如果参数勾选【弹出参数输入或选择值】则将相应的值按【显示方式】中设置的方式弹出让用户选择,如果未勾选【弹出参数输入或选择值】,则直接将对应的值传递给这个参数:

数据集(右侧按钮为“选中”)

内嵌数据(右侧按钮为“自定义数据”)

展示样式

提供四种展示样式,选择框、列表、复选框、单选框,如果参数勾选【弹出参数输入或选择值】则将【可选值】按输入或选择的方式弹出让用户设置。参考参数弹出窗口

其他

勾选参与报表 “ 参数过滤 ” 的过滤策略 后,自定义的参数会受仪表盘属性里的参数未选值策略的控制。

必选

勾选上【参与报表 “ 参数过滤 ” 的过滤策略】后,必选才可以进行选择。选择后在报告中该参数必须要输入参数值,否则仪表盘数据为空。

二次引用不显示

当勾选此选项的参数在再次被引用的地方不再展示,而且不会弹出。

当可选值选择数据集:

右侧按钮显示为选择,点击选择,用户可在已有的数据集中选择一数据集,选择一数据段作为标签,一数据段作为值。

clip0086

假设用户设定以选择框的形式弹出参数值输入框,用户在点击刷新元数据按钮、点击测试连接按钮、点击预览数据集按钮、在编辑器中打开此数据集时,参数值输入对话框中显示默认的数据集值,如下图所示。

 

clip0087

当可选值选择内嵌数据:

右侧按钮则显示为自定义数据,点击自定义数据,进入自定义数据对话框。输入的数据类型用编辑参数对话框中【类型】控制。如图所示:

clip0081

【添加】点击右侧的 “ 添加 ” 按钮,在值和标签栏里输入数据。

【删除】选中数据行,点击 “ 删除 ” 按钮,可删除输入的数据。

【上移 / 下移】选中数据行,点击上移或下移,可改变数据的上下位置。

【确定】点击 “ 确定 ”,确定录入的数据。

【取消】取消自定义数据。

在对话框中自定义数据,其中值不允许为空,标签允许为空,如图所示:

clip0085

假设用户设定以选择框的形式弹出参数值输入框,用户在点击刷新参数按钮、在编辑报告中再次打开此即席数据集报表仪表盘时,参数值输入对话框中显示录入的数据,如下图所示:

clip0088

如果自定义标签,则显示标签;如果没有自定义标签,则显示值。

2.刷新参数

对设置了弹出状态的参数重新输入参数值。如存在一参数且处于弹出状态,并且存在默认值 12,如下图所示。

clip0089

当用户点击刷新参数按钮时,也将会把此参数的默认值刷出来,如下图所示。

clip0090

3. 参数弹出窗口

3.1 什么时候弹出参数框

当有弹出的参数时,则在需要给参数传值的时候弹出参数。包括但不限于以下情况:

数据源的URL中含有参数,在测试连接时。

SQL数据集的SQL语句中含有参数,在刷新数据时。

报告里含有参数,编辑报告第一次打开报告时;预览报告,查看报告打开时。

3.2 参数的弹框样式

可选值为空时

ParamProp1

根据参数的不同数据类型,参数框有所不同,比如为时间戳类型时,弹框如下:

ParamProp2

可选值为内嵌数据或数据集时

展示样式为选择框:

ParamProp3

展示样式为列表:

ParamProp4

展示样式为复选框:

ParamProp5

展示样式为单选框:

ParamProp6