参数应用学习路径- FineReport帮助文档 - 全面的报表使用教程和学习资料

文档创建者：Catqiu

编辑次数：25次

最近更新：RosieY 于 2023-01-31

1. 概述

FineReport 设计器已涵盖了报表设计所有普遍和典型的功能，能够满足绝大部分用户的需求，基本实现零编码报表开发，帮助用户加快报表开发速度。

但是需求是千变万化的，某些个性化功能通过 FineReport 设计器可能无法实现。 FineReport 提供了开发接口和示例，支持应用开发人员使用 JavaScript 网页脚本、Java编程语言等对 FineReport 进行二次开发，满足其个性化的需求。

该章节适用于需要对 FineReport 报表进行深入开发的应用开发人员；另外若您对 FineReport 报表深感兴趣，希望更深入地了解 FineReport 软件的内部原理，您也可以阅读此章节。

阅读本章内容前，若您具有一定的 JavaScript、Java 基础，则能更好更快速的理解内容。

有关于参数的学习内容较多，对于刚接触参数的人来说可能会有不知道该怎么学习，以及不知道重点在哪的问题。由于参数涉及的应用方面较为复杂，所以本文档主要整理了参数控件的学习路径，帮助大家更好的学习参数与参数控件的相关内容。

2. 学习路径

2.1 新手学习路径

新手的学习路径与报表制作基础学习路径中的第 4 章内容相同，如果已经完成了报表制作基础学习路径的学习，可以跳过本节。

章节	标题	内容简介	文档	习题
第 1 章参数基础入门
1.1	参数面板	了解参数面板的属性、事件及如何调整位置等基础应用	参数面板简介	参数查询入门示例
1.2	参数简介	简单了解一下 FineReport 中的参数	参数简介
1.3	参数种类和区别	了解 FineReport 设计器中有哪些种类的参数及它们的区别	参数的种类与区别模板参数数据集参数
第 2 章参数控件基础入门
2.1	控件简介	了解有哪些参数控件，控件的使用场景以及一些应用注意事项	控件简介	下拉复选框默认选中全部值下拉框参数为空选择全部
2.2	控件实际值和显示值	了解哪些控件有实际值与显示值之分，以及使用时的区别	控件实际值和显示值
2.3	下拉框控件	「下拉框控件」可应用于填报、参数等场景	下拉框控件
2.4	下拉复选框控件	掌握「下拉复选框控件」的属性及应用	下拉复选框控件
2.5	数据筛选过滤	总结三种数据筛选过滤常用的方法	数据筛选过滤的方法
2.6	参数为空时查询全部数据	掌握如何实现参数为空选择全部的方法	参数为空选择全部

2.2 进阶学习路径

章节	标题	内容简介	文档
第 1 章参数种类及规则
1.1	参数命名规则	了解参数的命名规则，掌握参数引用符号的使用	参数命名规则
1.2	控件的默认值	在使用控件时，有时需要给控件一个默认值，如筛选查询报表，初始化时需要有默认查询结果	控件默认值
1.3	系统参数介绍	了解系统参数的使用	系统参数
1.4	op 参数说明	主要介绍 op 后面具体有哪些参数以及对这些参数的说明	op 参数说明
1.5	页码参数	主要介绍了「$$page_number」和「$$totalPage_number」两个参数的使用场景	页码参数
第 2 章参数控件进阶
2.1	日期控件	报表中添加日期查询控件，可以查询指定日期区间内的报表数据	日期控件根据开始时间、结束时间查询数据
2.2	文本控件	参数面板处可以通过该控件输入文本信息，键入查询参数	文本控件
2.3	下拉树控件	了解如何使用下拉树控件实现数据查询，以及三种构建方法	下拉树控件下拉树控件普通分层构建示例下拉树控件自动构建示例下拉树控件极速分层构建示例
2.4	视图树控件	了解如何使用视图树控件实现数据查询的方法以及使用场景	视图树控件
第 3 章数据查询进阶 - 控件联动
3.1	下拉框参数联动	当模板中有多个下拉框时，上一个下拉框选择了值后，下一个下拉框根据上个下拉框的值显示选项。下拉框选项之间有层级关系，可以实现多级联动	SQL语句实现下拉框参数联动
3.1	下拉框参数联动		公式实现下拉框参数联动
3.2	下拉复选框参数联动	当模板中有多个下拉复选框时，上一个下拉复选框选择了值后，下一个下拉复选框根据上个下拉复选框的值显示选项。下拉框选项之间有层级关系，可以实现多级联动	SQL语句实现下拉复选框参数联动
3.2	下拉复选框参数联动		公式实现下拉复选框参数联动
3.3	下拉框联动之默认选择列表中第1个值	掌握如何实现下拉框参数的下拉列表联动后，在使用中需要使下拉框默认选择列表中的第1个值	下拉框联动之默认选择列表中第1个值
第 4 章数据查询进阶 - 模糊查询
4.1	模糊查询	模糊查询是一种很方便的查询方式，用来查询符合某种指定格式的数据。比如用户想查询所有姓张的销售员的数据，就可以使用模糊查询。	模糊查询
第 4 章数据查询进阶 - 动态查询
5.1	动态列	用户根据自己的实际需要通过参数控件查询并展示不同的数据列	动态列
5.2	动态表	用户根据自己的实际需要通过参数控件查询并展示不同的数据表	动态表
第 5 章利用JS实现复杂参数参数查询
5.1	参数控件接口	参数面板上添加控件实现参数查询时，当设计器中控件的配置项无法满足用户的需求时，用户可以使用 JavaScript 来开发功能	参数控件接口
5.2	JS实现无需点击查询按钮即可自动查询	希望直接在输入参数后就查询结果，不需要点击查询按钮	JS实现无需点击查询按钮即可自动查询
5.3	JS根据条件显示参数控件	在使用参数控件时，有时我们希望部分参数控件在没满足条件时不显示，满足条件后再显示	JS根据条件显示参数控件
5.4	JS实现弹窗后数据回填	数据回填指的是将查询出来的数据返回给显示的文本框	JS实现弹窗后数据回填
5.2	CSS修改控件样式	通过 CSS 修改控件的显示样式	CSS修改控件样式