摘要由AI智能服务提供本文介绍了金蝶云·苍穹轻报表的参数控件相关知识，由甘雨主讲，包括参数控件的定义、类型、应用场景和使用方法。还详细讲解了参数控件的配置项，如参数名、显示名称、数据类型等，并通过实操案例展示了参数控件的使用方法。最后解答了一些关于参数控件的常见问题。
熊说轻报表整体笔记：【熊说轻报表】实施知识库
主讲老师：甘雨（金蝶云苍穹云数据服务平台部/轻报表服务部产品设计）
课程链接：
【直播】第三期 金蝶云·苍穹 轻报表参数控件的类型及应用（直播相对较长，可以看到总部老师互动和一些解答）
【剪辑】轻报表参数控件的类型及应用（剪辑精华版）
上课时间：2023.10.09 16:00 - 17:00
主要内容：
本期将介绍轻报表的参数控件，主要内容包括：
1）什么是参数控件？
2）参数控件有哪些类型？
3）参数控件的应用场景有哪些？
4）参数控件怎么使用？
更新日志：
20241117V1.0.0：初稿
20241123V1.1.0：更新个人实操作业
1.参数控件简介
1.1引入
Q1：参数控件位置在哪里？
Q2：参数控件的备选值在哪里？
说明：由数据集配置开发人员配置的，并不是由前端操作人员维护的。
1.2参数控件说明
参数控件：
定义报表的查询参数，用于接收报表查看人员选择或输入的值。
此参数可以用于数据查询，也可以用于报表的显示和计算。
数据查询场景：将控件中输入或选择的值作为数据查询的条件，用于数据的按需查询。
报表计算场景：将控件中输入或选择的值作为报表计算的变量，用于控制报表的计算和显示逻辑。
主要控件类型及对应的使用场景
下拉列表：通过下拉列表，选择其中的一个值，用于单选场景。
多选框组：将备选值全部展示出来，然后框选多个值，用于多选场景。
日期控件：选择某个日期或日期时间，用于日期选择场景。
输入框：通过文本输入框，手动输入内容，通常用于模糊匹配场景。
数字微调框：输入数字，或通过数值加、减调节按钮调节数字，用于数值选择场景。
独立多选框：提供两个多选框，必须选择其中一项，适用于“非此即彼”类型的查询场景。
弹窗选择器：在弹窗中单选或者多选备选值，适用于较为复杂的备选框展示场景（如：以树形展示）
标签控件：展示一段文本，主要用于在筛选条件面板进行一些提示或补充说明。
2.参数控件配置项
2.1九大配置项概述
参数控件的配置项有9项，分别为：
参数名：设置参数控件绑定的参数名称，与SQL结合使用
显示名称：设置参数控件在筛选条件面板中显示的名称
数据类型：设置参数的数据类型
控件类型：设置参数控件的类型
允许空值：设置参数控件的值是否可以为空
忽略空值：当参数控件的值为空时，是否要忽略与这个控件关联的查询条件
状态：设置参数控件在筛选条件面板中是否显示、是否可以操作
详细设置：设置控件的备选值、默认值等
说明：对参数控件的说明，仅在“数据集设计器-参数设置页签”中展示，供数据集开发人员参考，查看报表时不会展示该说明。
2.2基础设置
2.2.1参数名、显示名称
参数名：
可在SQL查询、或报表公式等场景中引用。
使用方法：@参数名，获取参数控件的真实值
显示名称：
查看报表时，参数控件在筛选条件面板中显示的名称。
使用方法：@参数名_text，获取参数控件的显示值
真实值VS显示值区别在“详细设置”章节介绍
2.2.2数据类型
数据类型：参数的数据类型。
可选择文本、数值、日期（年月日）、日期时间（年月日 时分秒）、时间（时分秒）、布尔（true、false）
2.2.3允许空值
小熊说：
我理解就是：参数值是否必填或者必须选择。
允许空值：设置参数控件的查询条件是否可以为空。
若不勾选，则该查询条件不能为空，控件显示名称的右上角会有*标志，并且查询时会自动进行必填校验
若勾选，则该查询条件可以为空，控件显示名称的右上角没有*标志，查询时不会进行必填校验。
2.2.4忽略空值
忽略空值：
当参数控件的查询条件为空时，是否忽略此查询条件。
若勾选，则该查询条件为空时，忽略此查询条件，即查询全量数据
若不勾选，则该查询条件为空时，查询值为空的数据。
使用方法
1.需勾选“允许空值”
2.同时配合SQL查询语句使用
KSQL语法：字段名='@参数名'
SQL语法：字段名='@参数名' or ? is null
2.2.5状态
状态：设置参数控件在筛选条件面板中显示、操作状态。
标准：查看报表时，帅选条件面板中会显示此控件，并且可以在控件中设置查询条件
只读：查看报表时，筛选条件面板中会显示此控件，但不能在控件中设置查询条件，报表将以此控件的默认值作为筛选条件进行查询
隐藏：查看报表时，筛选条件面板中不会显示此控件，报表将以此控件的默认值作为筛选条件进行查询
2.3详细设置
设置参数控件的备选值、默认值等，各类参数控件的“详细设置”包含的设置项如下：
下拉列表：下拉列表的备选值，默认值
多选框组：多选选项的备选值，默认值
日期控件：默认值
输入框：默认值
数字微调框：数值上、下限，调节按钮的步长、默认值
独立多选框：控件的备选值、默认值
弹窗选择器：弹窗内科选项的备选值、备选值的展示形式、备选值是否可以多选、默认值。
标签控件：标签展示的文本
2.3.1备选值
备选值：参数控件的可选项。可选项的数据可以来源于数据集、系统预设变量、宏定义，也支持用户自定义。
设置方法（以下拉列表为例）
步骤1：在数据集设计器的【参数】面板点击详细设置图标
步骤2：在“设置下拉列表”弹窗的【数据来源】面板中，选择备选值的数据源类型
步骤3：设置备选值
数据源类型为数据集/系统预设变量/宏：选择备选值的数据源和显示字段、取值字段
数据源类型为自定义：用户自行添加备选值
2.3.2显示字段、取值字段
显示字段：用于设置备选值显示值的字段。当取值字段的值不适宜展示在选项里面时，可以另外选择一个字段作为备选值的显示字段。
取值字段：用于设置备选项真实值的字段。
举例：
数据集A存放的是订单明细数据，包含订单号、产品ID、产品名称、货主名称、订单时间等……
希望通过一个参数控件，每次选择一种产品，来查询这个产品的订单明细。
存在问题：
若使用产品ID查询：查询效率高，但查看的人可能不知道每个ID代表的是哪个产品
若使用产品名称查询：查询效率低，但查看的人明确指导每个选项代表的是哪个产品
解决办法：显示字段使用产品名称、取值字段使用产品ID
支持区分显示字段与取值字段的参数控件有：下拉列表、多选框组、独立多选框、弹窗选择器
设置方法（以下拉列表为例）：
步骤1：在数据集设计器的【参数】面板点击详细设置图标
步骤2：在“设置下拉列表”弹窗的【数据来源】面板中，选择备选值的数据源类型和具体的数据源
步骤3：
在“显示字段”中，选择数据源中的一个字段作为显示字段
在“取值字段”中，选择数据源中的一个字段作为取值字段
2.3.3默认值
默认值：查看报表时，筛选条件面板中参数控件的默认值。可以将常用的值作为默认值，来减少报表查看者设置筛选条件的步骤。
3.实操案例：参数控件使用方法详细介绍
3.1案例说明
例：
假设数据库中有一个订单明细表demo，表里字段有订单日期、订单ID、客户ID、产品ID、产品品类、产品子品类、国家、省份、地区、销售额、利润、邮寄方式等。
3.2最终需求展示
需求：
设计一个数据集，可以从多个角度查询订单明细，包括：按地区查询（股国家、地区、城市）、按订单信息查询（订单日期范围、订单销售额范围）、按品类查询（品类、子品类）、按订单的邮寄方式查询、按商品名称查询。
最终筛选条件面板如下图所示，使用了下拉列表、多选框组、日期控件、输入框、数字微调框、独立多选框、弹窗选择器、标签控件。
3.3个人实操
附件中已经附带了轻报表演示的案例
疑问点：树形弹窗是不是都要按一样的格式来操作？有没有数据源的要求？
目前不清楚标品做的树形弹窗，是咋构造的
目前是我硬构造出来的
然后涉及到销售额部分，都会报错
4.相关问题
Q1：模糊搜索用哪个没看到
模糊搜索用哪个都可以，控件是用来接收报表查看者输入的内容，实现模糊搜索是要在查询语句里，结合参数名与SQL语法使用
Q2：如果是查询参数内容是已有的系统基础资料，没有办法直接调用系统的标准控件，都需要重新开发吗？这样不是会跟系统常规操作体验上不一致还会影响开发效率
可以在“宏定义”里新建“基础数据宏”，选择一个基础资料来定义宏，然后在控件里选择这个宏作为数据来源，就可以在控件里选基础资料了。
参数控件实操DEMO20241123.zip(6.99KB)
赞 5
打赏推荐阅读
