各种参数使用

1.概述

ABI报表内容都可以作为参数，用户可以根据实际需求设置报表中的可变量作为参数；更简单点，参数好比一个十字路口，站在十字路口的我们最后所到达的目的地（分析结果），会根据选择前后左右方向（选择参数）的不同而不同。用SQL的视角来看，参数可以影响到SQL语句的任意部分，他可以决定select中的内容、where的内容、group by的内容、order by的内容，有SQL的地方就会有参数的影子。

2.参数使用

按照报表内容的可变性，报表分为静态报表和动态报表（参数化报表）。ABI参数面板支持输入框、维下拉框、枚举下拉框和日期等多种参数类型。对于枚举下拉框参数，其下拉列表内容可以是静态手工输入的，也可以来自于第三方数据源，其内容可以随第三方数据源数据动态变化。参数面板中提供了参数类型对应参数内容变化的行为响应事件（参数联动），极大的方便了用户使用参数化报表时对参数的选择或输入，减少了用户重复定制参数条件生成报表的工作量。

2.1按钮

按钮用于需要有特殊点击事件的情形，比如计算、清空、编辑、导出、日志、订阅、添加到收藏夹、打印、打印预览、查看报表说明等。

按钮添加完成后，可以在按钮属性的“事件”中直接选择配置；如果你有更多的需求，可以在事件中自行写脚本实现。

2.2下拉按钮

当分析表含有多个点击事件，但设置多个按钮界面又不够美观，那么下拉按钮就能很好的解决此问题。

如上图的效果，只需拖动一个下拉按钮参数组件到参数面板区或表体区域，按需设置【菜单设置】属性就可以完成。

2.3滑块

滑块参数使用时可以根据鼠标的拖动改变参数值，如下图所示：

具体属性设置如下：

【最大值】滑块最右边（到顶）的数值。

【最小值】滑块最左边的数值。

【步数】可将滑动块等分为所设置的步数。

滑动块常与钻取合用于即时刷新统计图。 

示例：滑动块与仪表盘进行关联，当滑动块移动到某个数值时，仪表盘显示所移动到的数值。

拖入仪表盘，并且设置仪表盘的区域区间，如下分为三个区间分别是：

差：0至30；中：30至60；好：60至100；

设置指针的值为@sz；

拖入滑动块，设置块动块的“参数名称”为@sz，最大值为100，最小值为0，如下图：

设置滑动块的“钻取设置”为联动式，具体设置如下：

联动方式：图形联动；

图形显示区域：即仪表盘的代号；

参数设置：即滑动块的值；

数据点名称：即滑动块的标题；

系列名称：设置统计图的系列名称；

如下图，当鼠标将滑动块拖到某个数值时，仪表盘显示到此数值：

2.4日期

该类型用于选择日期的参数，精确到天，以日历的形式展现，如下图所示：

主要的属性设置如下图。

参数类型：有日期、年月、年供选择。

允许选择时间：勾选后即可选择具体时间，精确到秒。

起始时间：日历中可以选择的最早时间。

截止时间：日历中可以选择的最晚时间。

允许选择时间：勾选后，设置日期时可选择时分秒，如下图。

年月，季、年组件和日期相似，可以相互切换。

2.5起止日期

起止日期可输入时间轴刻度，拖动时间点来实现数据的更新。

当选择最近，时间按照“时间轴刻度”显示：

当选择指定日期时，可选择“开始时间”和“结束时间”：

2.6勾选框

勾选框类型参数一般用于控制参数的显示。如下图设置的参数@gx，可以用来控制某行或者某列数据的背景颜色，公式可以写为if(@gx,'#FFCC00','#9C27B0')，其含义：在计算面板上打上勾选框前的勾，颜色为黄色，否则为紫色。

勾选框设置：

2.7勾选框组

我们使用勾选框组实现上面的需求，勾选框组枚举值支持自定义和公式两种。

1） 方式一，枚举值自定义

2）方式二，枚举值使用公式

常量时，写法为：显示值:实际值;显示值:实际值;......，显示值与实际值间用:分隔，多个值间用;分隔。如：显式黄色:1;显式紫色:2

数据来自库表时，写法为：<#=ardb("Select 显示值字段 || ':' || 实际值字段 From  表名").join(";")#> 。如：<#=ardb("Select t.NAME || ':' || t.ID From gx t").join(";")#>

需要通过参数过滤的方式来显示勾选框组的值写法为：<#=ardb("Select 显示值字段 || ':' || 实际值字段 From  表名 WHERE 表名.字段='"+@XXX+"'").join(";")#>

刚才的表格设置不变。在勾选框组枚举值自定义或公式设置完成后计算，我们可以看到如下的效果：

2.8枚举下拉

我们使用枚举下拉实现上面的需求，枚举下拉枚举值支持自定义、公式、SQL主题表三种。

1） 方式一，枚举值自定义

2） 方式二，枚举值使用公式

常量时，写法为：显示值:实际值;显示值:实际值;......。显示值与实际值间用:分隔，多个值间用;分隔。如：显式黄色:1;显式紫色:2

数据来自库表时，写法为：<#=ardb("Select 显示值字段 || ':' || 实际值字段 From  表名").join(";")#> 。如：<#=ardb("Select t.NAME || ':' || t.ID From gx t").join(";")#>

需要通过参数过滤的方式来显示枚举的值写法为：<#=ardb("Select 显示值字段 || ':' || 实际值字段 From  表名 WHERE 表名.字段='"+@XXX+"'").join(";")#>

3）方式三，枚举值来自SQL主题表

枚举值多选的时候，可以用dim函数来过滤多个数据dim(主题表.字段)=@sz

2.9维下拉

该类型用维表作为参数，方便用户选择，与枚举下拉框一样可以支持多选。此处“参数类型”包含3种：

1) 维下拉框

如果选择了维下拉框，下方会显示“维表”属性用户选择，此处会列出主题域、主题集、公共维表下所有维表。

2) 单位级次下拉框

单位次级下拉框是根据主题域或者主题集设置的数据级次维和当前用户的权限来显示，支持多选。

3) 数据期下拉框

该类型是根据所设置的主题表的数据期来显示的。选择该参数时所列的可选项是根据数据的实际情况显示，即实际数据中有数据期才在报表期下拉框中列出，否则没有。必须和某一主题表关联，该主题表是可选择的；而且该主题表需要设置数据期字段。

具体属性详解如下：

【高级输入】如果勾选选择，将直接显示数据期面板，参数名称必须是set_bbqoption，所选的数据期参数将会自动作用报表。

【主题表】1.设置数据期类型参数时，需指定主题表，即使用某一主题表的数据期内容。如不指定，即为空的状态，系统会自动分析当前报表所引用的主题表，选取第一个作为显示数据期的主题表；2.设置普通维下拉框时，可以选择是否设置关联的主题表，设置关联的主题表后可区别已报未报，设置后【主题表字段】【过滤条件】【显示样式】【参数联动】属性才会出来。

【主题表字段】普通维下拉框设置了用于区分已报未报而关联的主题表后，该属性才会出现。用于设置关联的字段。

【过滤条件】普通维下拉框设置了用于区分已报未报而关联的主题表后，该属性才会出现。关联后的过滤条件。

【显示样式】普通维下拉框设置了用于区分已报未报而关联的主题表后，该属性才会出现。维下拉项是已报时的显示样式，如color：red;font-size：30px。

【参数联动】普通维下拉框设置了用于区分已报未报而关联的主题表后，该属性才会出现。当指定的参数发生变化时，下拉项会重新加载，格式 @p;@p1 多个参数用 ; 连接。

【显示方式】可以只显示代码或者文字，也可以都显示。

【自动过滤】 勾选后，会根据该参数的相关属性，自动设置过滤条件，不需要手工书写和该参数相关的过滤条件。例如：勾选后，计算时会自动产生报表过滤条件：dim('维xxx')=@yyy。该属性还可用于“单位级次下拉框”、“数据期下拉框”参数类型。

【根节点显示】所有下级节点都可以设置为根节点。输入方式形如A0000;B0000;C0000 这样的格式，表示该下拉列表的根节点有三项。例如：110000;120000。如图235北京市和天津市被设置为了根节点。该属性的值也可以用其他参数值，如是其他参数的值，只需要填入该参数的名称即可。

【包含根节点】当勾选时，就显示“根节点显示”中指定的根节点，如果“根节点显示”为空表示以维度的顶级节点为根节点，该属性是和“根节点显示”属性配合使用。

【节点过滤】根据节点过滤表达式筛选出符合条件的节点。维节点表达式中的特殊对象item，在遍历每一个节点时，item是当前遍历的维节点对象，根据item对象可以获取到维的相关属性。  

下表为item对象相关属性：

例如要返回维代码前三位为010的节点，那节点表达式为left(item.id,3)=’010’。

【节点排序】格式是级数和排序参数用冒号分隔，每一级在用分号分隔开，例如0：desc;1：asc级数从0开始，0表示第一级，左边的参数表示第1级降序第二级升序。 在下图中“节点排序”属性中输入“0：desc”，数据按降序显示：

【节点选择】该属性设置控制参数值选择时只能选择叶子节点，不能选择父节点。

2.10输入过滤框

输入过滤组件，功能类似于百度的搜索，绑定需要搜索的范围后，可以在输入的时候下拉出过滤的内容。如下图：

属性设置：

注意事项：

1、列表项显示格式，支持自定义显示，字段必须<#=#>包裹起来。格式举例：<#=XXB.BBQ_#>（报表户：<#=XXB.USERNAME_#>）。

2、显示的数据量暂时定为50条为上限。

3、若勾选了同输入框等宽，则下拉等宽输入框；不勾，则按文字自适应，但是有一个最小值和最大值。

2.11日期标记

日期标记组件，是对某一条数据中与日期字段对应的其他字段中有数据的时候，就对该日期进行红色下划线标记。如下图：

属性设置：

属性设置说明：

三个属性都必须填写。

主题表：暂时只支持物理主题表。

日期字段：该字段暂只支持日期型字段和字符串日期格式为 yyyymmdd 形如 20190912的字符型字段。

过滤字段：所选字段不同时为空，则代表该日期有值，可多选且至少选择一个。

注意事项：

该参数组件，暂不推荐放入参数区，相关内容未处理，钻取尚未实现，摒弃了和参数标题相关的多种属性，自定义样式等属性。

2.12输入框

用于输入文本或数字信息，如姓名、年龄、编号等。可以设置输入长度限制、参数类型（文本、整数、浮点）等，确保输入数据的规范性。

2.13年月

该类型用于选择年月的参数，如下图：

日期、年、季和年月组件相似，可以相互切换。

2.14季

该类型用于选择季度的参数，如下图：

日期、年、年月和季组件相似，可以相互切换。

2.15年

该类型用于选择年的参数，如下图：

日期、年月、季和年组件相似，可以相互切换。