-
-
辰哥 管理员
发表于2018-8-14 15:02
楼主
亿信BI在设计报表时提供了多种报表参数，那什么是报表参数，包含哪些类型？都有什么作用呢？在设计报表时我们如何正确使用这些报表参数呢？今天辰哥小课堂为你详解报表参数的相关内容。
什么是报表参数？
BI@Report报表内容都可以作为参数，用户可以根据实际需求设置报表中的可变量作为参数；
更简单点，参数好比一个十字路口，站在十字路口的我们最后所到达的目的地（分析结果），会根据选择前后左右方向（选择参数）的不同而不同。
用sql的眼睛来看，参数可以影响到sql语句的任意部分，它可以决定select中的内容、where的内容、group by的内容、order by的内容，有SQL的地方就会有参数的影子。
按照报表内容的可变性，报表分为静态报表和动态报表（参数化报表）。BI@Report参数面板支持编辑框、枚举框、树下拉框、列表下拉框和日期型等多种参数类型，如果是枚举类型、列表下拉框类型的参数，该类型参数的下拉列表内容可以是静态手工输入的，也可以来自于第三方数据源，其内容可以随第三方数据源数据动态变化。
参数面板中提供了参数类型对应参数内容变化的行为响应事件(参数联动)，极大的方便了用户使用参数化报表时对参数的选择或输入，减少了用户重复定制参数条件生成报表的工作量。
进入报表模板设计器界面，下图所示位置：
目前亿信BI支持如下12种报表参数：
下面我们一起来了解一下报表参数的类型的属性和它的使用说明。
按钮
按钮用于需要有特殊点击事件的情形，如在报表上添加一个“导出”按钮。
还可增加其它常用按钮，比如计算、清空、编辑、导出、日志、订阅、添加到收藏夹、打印、打印预览、查看报表说明等。
按钮添加完成后，可以在按扭属性的“事件”中直接选择配置；如果你有更多的需求，可以在事件中自行写脚本实现。
当分析表含有多个点击事件，但设置多个按钮界面又不够美观，那么下拉按钮就能很好的解决此问题。
如上图的效果，只需拖动一个下拉按钮参数组件到参数面板区，按需设置【菜单设置】属性就可以完成。
滑块参数使用时可以根据鼠标的拖动改变参数值，如下图所示：
具体属性设置如下：
【最大值】滑块最右边（到顶）的数值。
【最小值】滑块最左边的数值。
【步数】可将滑动块等分为所设置的步数。
滑动块常与钻取合用于即时刷新统计图。
输入框类型的参数通常用于用户手工输入参数，如下图所示。红色框架中的“20000”数据是手工录入的。
具体的属性设置如下图：
该类型用于选择日期的参数。精确到天，以日历的形式展现，如下图所示：
具体的属性设置如下图：
【参数类型】有日期、年月、年供选择
【允许选择时间】勾选后即可选择具体时间，精确到秒
【起始时间】日历中可以选择的最早时间
【截止时间】日历中可以选择的最晚时间
如果勾选了“允许选择时间”，可选择精确到秒：
年月类型默认是当前年月，也可以根据自己需要写默认值。其他属性的介绍详见《参数属性详细说明》。
起止日期可输入时间轴刻度，拖动时间点来实现数据的更新。
当“最近”按钮在左侧时，时间按照“时间轴刻度”显示：
当“最近”按钮在右侧时，可选择“开始时间”和“结束时间”：
具体属性设置：
勾选框类型参数一般用于控制参数的显示。
【默认值】是T 时表示勾选，F表示不勾选。
【选中时的值】勾选框选中后，“选中时的值”中的数值，才有作用；如果勾选框没有选，那么该值是没有作用的。
如下图所示：
勾选框组的数据可以是枚举值也可以使用系统的维表。
如下图，使用系统中的维表“行政区划”的属性设置：
设置后效果如图：
可直接在分析表格中对此参数进行过滤设置即可。
枚举下拉列表可配合枚举值一起使用：
设置效果如下：
【枚举值】参数可选值由显示值和实际值组成，用分号’;’分隔开。例如：人民币:10;美元:20;日元:30。
【允许多选】勾选后，参数可以选择多个；不勾选，则只能选择一个。
该类型用维表作为参数，方便用户选择，与枚举下拉框一样可以支持多选。此处“参数类型”包含3种：
√维下拉框：如果选择了维下拉框，下方会显示“维表”属性用用户选择，此处会列出主题域下所有维表。
√单位级次下拉框：单位次级下拉框是根据主题域或者主题集设置的数据级次维和当前用户的权限来显示，支持多选。
√数据期下拉框：该类型是根据所设置的主题表的数据期来显示的。选择该参数时所列的可选项是根据数据的实际情况显示，即实际数据中有数据期才在报表期下拉框中列出，否则没有。必须和某一主题表关联，该主题表是可选择的；而且该主题表需要设置数据期字段。
具体属性详解如下：
【高级输入】如果勾选选择，将直接显示数据期面板，参数名称必须是set_bbqoption，所选的数据期参数将会自动作用报表。
【主题表】设置数据期类型参数时，需指定主题表，即使用某一主题表的数据期内容。如不指定，即为空的状态，系统会自动分析当前报表所引用的主题表，选取第一个作为显示数据期的主题表。
【显示方式】可以只显示代码或者文字，也可以都显示。
【自动过滤】 勾选后，会根据该参数的相关属性，自动设置过滤条件，不需要手工书写和该参数相关的过滤条件。例如：勾选后，计算时会自动产生报表过滤条件：dim('维xxx')=@yyy。该属性还可用于“单位级次下拉框”、“数据期下拉框”参数类型。
【根节点显示】所有下级节点都可以设置为根节点。输入方式形如A0000;B0000;C0000 这样的格式，表示该下拉列表的根节点有三项。例如：110000;120000。如图235北京市和天津市被设置为了根节点。该属性的值也可以用其他参数值，如是其他参数的值，只需要填入该参数的名称即可。
【包含根节点】当勾选时，就显示“根节点显示”中指定的根节点，如果“根节点显示”为空表示以维度的顶级节点为根节点，该属性是和“根节点显示”属性配合使用！
【节点过滤】根据节点过滤表达式筛选出符合条件的节点。维节点表达式中的特殊对象，item在遍历每一个节点时，item是当前遍历的维节点对象，根据item对象可以获取到维的相关属性。
下表为item对象相关属性：
【节点选择】该属性设置控制参数值选择时只能选择叶子节点，不能选择父节点。
其他属性的介绍详见《参数属性详细说明》。
各属性的详细介绍：
【代号】参数容器的代号
【左边距、上边距、宽、高】用来确定参数的边距和大小
【叠放次序】多个参数相互有重叠遮盖时的叠放次序
【大小自适应】参数很多并且并排放时可以自适应大小
【水平位置、垂直位置、背景颜色、背景图片、边框】用于设置位置和外观显示
【显示】下拉框选项，分别有隐藏、不打印可预览、不打印不预览、不导出
【禁用】可对参数进行禁用，禁用后参数将不起作用。
【钻取设置】可对参数进行点击钻取设置。使用方法可参阅钻取章节。
【参数类型】设置参数的数据类型，有文本、整数和浮点供选择。
【参数顺序】多个参数时，显示的顺序，系统会根据添加先后自动给出默认顺序值。
【参数名称】报表参数的代号，建议使用数字、字母与特殊字符的组合，主要用于对参数的引用。例如：@zczj。
【参数标题】给参数命名，报表参数的标题。例如：注册资金。
【参数标题颜色】给参数标题设置颜色。
【显示参数标题】可以控制显示或者不显示参数的标题。
【长度】参数值的最大长度
【默认值】没有选择参数前，默认的值。
【记录结果集】上次选择的参数内容是否保留以便下次使用时不需要再次选择。
【自动过滤】勾选后，会根据该参数的相关属性，自动设置过滤条件，不需要手工书写和该参数相关的过滤条件。
亿信BI中的参数一般都是按默认的方式进行排列的，每个参数的宽度默认为200px，当一行显示不了的时候，在自动换行显示。如下图所示：
这样的方式可以满足大多数的需求，但有些报表需要特殊排版，所以我们提供了参数布局的设置面板。在参数面板空白处，点击右键->高级设置，如下图：
有3种排版方式可供选择：
系统默认布局方式为系统自适应，如果无法满足您的需求，也可以自己设置每行n个报表参数，或者设置自助拖动后，自己拖动报表参数到想要的位置。
