历史版本19 :复选按钮组控件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 预期效果

1.1.1 填报应用

填报报表中可以通过该控件录入填报的数据,如下图所示:

02.jpg

1.1.2 参数应用

参数面板处可以通过该控件过滤数据,如下图所示:

4.gif

1.2 实现思路

1.2.1 填报应用

添加控件后,在数据字典中设置选项,选择数据。

1.2.2 参数应用

复选按钮组控件绑定参数,通过参数过滤数据。

2. 填报应用编辑

2.1 添加控件

2.1.1 步骤

新建普通报表,A2 单元格添加「文本控件」,A6 单元格、A8 单元格添加「日期控件」,A4 单元格添加「复选按钮组控件」,并为控件所在单元格添加边框。模板设计如下图所示:

注:设置边框的步骤请参见:单元格样式 文档中的 2.2.1 节内容。  

3.png

 「复选按钮组控件」具体设置如下表所示:

步骤具体设置
数据字典

选中「复选按钮组控件」,数据字典具体设置如下图所示:

1599100693643570.png

展示列数取消勾选「自适应按钮」,展示列数设置为 2 
返回值类型

返回值类型为「字符串」,分隔符选择「逗号」。

这样设置后,如果复选按钮组多选,每成功填报一次,数据库表增加一条记录,如下图所示:

1599101053860671.png

返回值类型若选择「数组」,如果复选按钮组多选,每成功填报一次,数据库表增加多条记录,如下图所示:

1599101140221798.png

2.1.2 复选按钮组控件属性简介

复选按钮组控件的属性设置界面如下图所示:

2020-06-10_19-47-58.jpg

各属性设置项的详细介绍如下:

属性
简介
控件名

通常与参数结合使用

通过控件名可以获得该控件,从而获得控件值传递给对应参数

或者通过控件名获得控件后通过 JS 设置控件的属性

可用

勾选后,填报时可正常勾选填报内容

不勾选,填报时控件灰化,不可编辑

可见

勾选后,填报时控件可见

不勾选,填报时控件不可见

数据字典

通过数据字典来定义复选按钮组实际值与显示值,可参考文档 数据字典

自适应

勾选后,根据数据字典内容进行自适应控制展示列数

不勾选,需自行设置展示列数,若展示不下将截断展示

展示列数设置复选按钮组控件的展示列数,若展示不下将截断展示
提供全选

勾选后,提供全选按钮,方便批量勾选

不勾选,根据需要勾选按钮

返回值类型

分为数组和字符串两种:

  • 数组

返回数组,返回值类型是数组型的效果是:["值 1","值 2","值 3"],如下图所示:

  • 字符串

字符串的返回值类型需要定义分隔符,开始符和结束符,即返回的字符串会根据分隔符,开始符和结束符进行显示

例如分隔符,开始符和结束符分别定义成逗号,单引号和单引号的话,则返回值的效果是:'值 1,值 2,值 3',如下图所示:

允许为空

勾选后,允许控件为空值

不勾选,填报校验和提交时会提示:不能为空

错误提示用户可自定义不允许为空的提示信息

2.2 设置填报属性

点击「模板>报表填报属性」,添加「内置SQL」,数据库为 FRDemo ,数据表为「qingjia」,点击「智能添加字段」,添加字段:name、type、startday、endday,并依次绑定单元格A2、A4、A6、A8,如下图所示:

6.gif

2.3 效果查看

保存模板,点击「移动端预览」,效果如本文 1.1.1 节所示。

注:支持 PC 端,效果图此处不再展示。

3. 参数应用编辑

3.1 模板准备

1)新建普通报表,新建 ds1 ,SQL 语句如下所示:

SELECT * FROM 销量

2)点击「模板>模板参数」,添加模板参数 p1 ,如下图所示:

1598951345488754.png

3.2 添加控件

3.2.1 步骤

在参数面板中添加「复选按钮组控件」和「查询控件」。如下图所示:

7.png

3.2.2 注意事项

  • 普通报表中,将参数面板控件工具栏中的「复选按钮组控件」拖入到参数面板中即可。

  • 决策报表中,先将参数界面拖入 body 界面,再将「复选按钮组控件」拖入参数面板或 body 中即可,如下图所示:

8.png

3.3 设置数据字典

3.3.1 步骤

选中复选按钮组控件,组件名称为 p1 ,类型设置选择「数据库表」,数据库为「FRDemo」,数据库表为「销量」,实际值和显示值为「销售员」,如下图所示:

9.png

3.3.2 属性介绍

属性:

复选按钮组控件的属性设置界面如下图所示:

1591790914403086.jpg

各属性设置项的详细介绍如下:

属性
简介
组件名称

通常与参数结合使用

通过控件名可以获得该控件,从而获得控件值传递给对应参数

或者通过控件名获得控件后通过 JS 设置控件的属性

可用

勾选后,预览时可正常输入文本信息

不勾选,预览时控件灰化,不可编辑

可见

勾选后,预览时控件可见

不勾选,预览时控件不可见

标签名称标签名称的作用就是用来弥补参数界面中标签控件不支持的问题
控件值控件默认显示的值,详情请参见:控件默认值
数据字典数据字典可以定义下拉框实际值与显示值,详情请参见:数据字典
字体文本框中输入字体的大小
自适应

勾选后,根据数据字典内容进行自适应控制展示列数

不勾选,需自行设置展示列数,若展示不下将截断展示

展示列数设置复选按钮组控件的展示列数
支持全选

勾选后,提供全选按钮,方便批量勾选

不勾选,根据需要勾选按钮

返回值类型

分为数组和字符串两种:

  • 数组

返回数组,返回值类型是数组型的效果是:["值 1","值 2","值 3"],如下图所示:

  • 字符串

字符串的返回值类型需要定义分隔符,开始符和结束符,即返回的字符串会根据分隔符,开始符和结束符进行显示

例如分隔符,开始符和结束符分别定义成逗号,单引号和单引号的话,则返回值的效果是:'值 1,值 2,值 3',如下图所示:

允许为空

勾选后,可以不选择任何值

不勾选,不选择任何值时可自定义错误提示

错误提示用户可自定义不允许为空的提示信息
组件位置调整控件在参数面板中的位置
组件大小调整控件的大小

移动端:

复选按钮组控件,在移动端的展现,基本与 PC 端属性一致。

JAR 包在 2020-07-08 之后,且 App/HTML5 移动端展现插件在 V10.4.80 之后时,移动端支持设置控件的最大显示行数。如下图所示:

image.png

显示逻辑如下表所示:

报表类型
控件位置是否移动端重布局显示逻辑
普通报表参数界面-

根据控件选项扩展的行数,显示区域不同:

1)若实际行数<最大显示行数,则组件区域的高度自动扩展,显示全部选项,无多余空白行,无滚动条

2)若实际行数≥最大显示行数,则组件区域的高度先扩展,显示最大显示行数,其余通过滚动条显示

3)若最大显示行数为 0 ,组件区域由组件宽高比例决定,组件显示行数由组件区域决定,显示不下将出现滚动条

决策报表
参数界面-
body 界面勾选移动端重布局
未勾选移动端重布局

组件区域由组件宽高比例决定,高度无法自由扩展

组件显示行数由组件区域决定,显示不下将出现滚动条,不受最大显示行数约束

3.4 设计界面添加表格

1)设计界面添加表格,其中 A2 单元格输入公式:「$p1」,如下图所示:

10.png

2)双击 B2 单元格,点击过滤,设置「销售员等于参数$p1」,如下图所示:

1599103155572337.png

3.5 效果查看

保存模板,点击分页预览,效果如本文 1.1.2 节所示。