帆软报表开发学习笔记

帆软报表数据准备_数据连接(20200817)

数据连接：

1. 制作报表前需要定义数据来源，最常见的就是数据保存在数据库中，并且数据随着业务的更新而不断更新，这时候的报表数据也是动态的。帆软的两种数据连接方式：设计器和平台。
   
2. FineReport支持通过 JDBC、JNDI、SAP、XMLA 和 FineBI 五种方式连接数据库，数据连接存储在工程中，当用户执行需要访问数据库的操作时这些连接被激活。

帆软报表数据准备_数据集(20200818)

数据集：

1. 定义：是指从数据库中将数据取出来，可直接应用于模板设计的数据展现集合。
2. 分类：按照使用范围，分为服务器数据集，模板数据集两种；
   按照来源范围，分为数据库查询、内置数据集、文件数据集、SAP数据集，存储过程，多维数据库、关联数据集以及树数据集。
   
3. 按照来源范围对数据集类型进行说明

帆软报表设计_思路(20200819)

设计思路：

1. 帆软报表的制作流程：新建数据->新建模板与数据集->模板设计(报表设计、参与设计、图表设计、填报设计)->模板预览。
2. 步骤的详细说明：
   　　 a.新建数据：主要用来建立数据库与设计器之间的交互桥梁；
   　　b.新建模板与数据集：主要是指从数据库取出数据，然后直接应用于模板设计的数据展现集合；
   　　c.模板设计：普通报表设计 (报表设计/参数设计/图表设计/填报设计)、决策报表设计(移动端的自适应，组件间的联动) 、聚合报表设计(一个报表包含多个模块，各个模块独立运作，互不关联)；
   　　d.模板预览：分页预览、填报预览、数据分析、新填报预览、移动端预览、决策报表预览。

帆软报表设计_模板设计类型(20200820)

模板设计类型：

1. 模板设计(难点)
   主要包括普通模板设计、决策报表设计和聚合报表设计。
2. 普通模板设计：
   普通模板设计是单元格设计模型，通过单元格扩展、单元格之间的父子格关系来实现模板效果。
3. 决策报表设计：
   　　决策报表设计是实现普通模板设计无法满足直接展示控件的需求，在决策报表设计时可以直接添加控件。
4. 聚合报表设计：
   　　 聚合报表设计的主要优势就是能够显示成块的内容，而且成块的内容各自保持独立，块间不相互影响。

帆软报表设计_普通报表设计(20200821)

普通报表设计：

1. 报表设计
   纯粹的数据展示。
2. 参数设计：
   动态查询数据。
3. 图表设计：
   　　用图表来展示数据。
4. 填报设计：
   　　 录入数据，将数据写入数据库中。

帆软报表设计_决策报表设计(20200822)

决策报表设计(弥补普通模板自适应布局、局部刷新等方面的不足)：

1. 新建决策报表
   为决策报表添加不同的组件，其中这些组件包括空白块（Tab 布局、绝对画布块、报表块）、参数面板、图表块、控件等类型。

2. 空白块：
   空白块中包含 Tab 块、绝对画布块和报表块。其中
   Tab 块：决策报表中增加tab布局，实现卡片式组件；
   报表块是指，可在该组件中绑定单元格数据，以表格的形式在组件范围内显示数据；
   绝对画布块：可以实现固定大小与自适应相结合的需求。

3. 参数面板：
   参数面板是指，为决策报表添加过滤参数面板，所有过滤控件全部添加在该面板上。

4. 图表块：
   　　图表块是指，可在该组件中选择任意 FineReport 支持的图表类型。

5. 控件：
   　　控件是指过滤数据的组件，既可以作为组成部分添加到参数面板中，也可作为单独的组件添加到决策报表主体界面中。

帆软报表设计_聚合报表设计(20200823)

聚合报表设计：

1. 聚合报表
   　　指一个报表中包含多个模块，每一块都类似一张单独的报表或者一张图表，块与块之间相对独立，互不影响。其特点：空白画布式设计界面，每个模块相互独立，专门解决大报表难题，单元格扩展分离，互不影响；不足：不支持自适应，单元格扩展分离但组件依旧相互推开。
2. 选中块：
   选中块进行移动时，只要不放开鼠标，移动的块可以覆盖在其他块上，越过它放到其他空白处，但是如果在移动过程中，在覆盖其他块的时候放开了鼠标，此时块自动回到他原来的位置；拖入新的组件时，只能拖到空白区域，在非空白区域会提示“禁止块与块之间的重叠”。
3. 块间运算：
   　　在组件里面获取其他组件单元格的值，可直接使用公式如=block1~A1。

String jsonString = "[{reportlet: 'json_export.cpt',param1: 'value1',param2: 'value2'}]";
        ArrayList<HashMap<String,Object>> results = new ArrayList<>();
        try {
            JSONArray reportlets = new JSONArray(jsonString);
            for (int i = 0; i < reportlets.length(); ++i) {
                HashMap<String,Object> paraMap = new HashMap();
                JSONObject jsonObject = reportlets.getJSONObject(i);
                Iterator keys = jsonObject.keys();

                while (keys.hasNext()) {
                    String key = (String) keys.next();
                    Object value = jsonObject.get(key);
                    value = value instanceof String ? CodeUtils.decodeText(String.valueOf(value)) : value;
                    paraMap.put(key, value);
                }
                results.add(paraMap);
            }
        }
        catch(Exception ex){
            ex.printStackTrace();
        }

帆软报表开发学习笔记

报表特性_超级链接(20200928)

超级链接：

1. 典型应用：
   (1)图表超链-悬浮窗图表
   (2)超级链接到有参数的模板
   (3)超级链接通过不同条件链接到不同页面
   (4)数据钻取到当前模板
   (5)超级链接之隐藏参数
   (6)超级链接-传递多个值
   (7)超级链接之如何传递参数到网页中
   (8)超级链接到网页传递的中文乱码
   (9)超链 PDF 查看
   (10)单元格间联动
   (11) 数据钻取并返回
   (12)超级链接解决Internet脚本运行慢示例
   (13)报表和图表联动
   (14)鼠标悬浮/点击/离开超级链接时改变颜色
   (15)根据超级链接的内容跳转不同页面
   (16)根据(不同)内容超链接到不同网址
   (17)点击单元格空白处可实现超级链接

报表特性_条件属性(20200929)

条件属性：

1. 定义：就是当满足一定条件时，修改属性值，FineReport报表中很多地方都可以运用到条件属性，比如满足条件隐藏行列，修改显示样式等等。
2. 具体应用：
   (1)通过条件属性实现自定义单元格的对齐方式
   (2)查询结果为空时不显示报表内容
   (3)隐藏行后隔行变色
   (4)当前行根据条件显示不同背景色
   (5)隔分组显示不同的颜色
   (6)条件属性中插入斜线
   (7)条件属性实现点击当前单元格或行变色
   (8)依据条件显示不同的值
   (9)超级链接通过不同条件链接到不同页面
   (10)依据条件隐藏单元格
   (11)隔行显示不同的背景色
   (12)相邻单元格相同数据问题
   (13)条件属性可使用页码参数
   (14)通过条件属性制作热力图
   (15)隐藏行时序号不连续的解决方案
   (16)自定义最大最小值

报表特性_导出(20200930)

导出：

1. 概述：FineReport，既可在设计器端导出模板，也可以在浏览器端导出，还可以通过 API 接口导出。
2. 分类：
   (1) 设计器端导出
   (2) 浏览器端导出
   (3) API导出
   (4) URL直接导出
   (5)自定义导出按钮
   (6)大数据集导出

报表特性_打印(20201001)

打印：

1. 功能简介：可预先进行页面设置传递至打印机，并可以保存用户打印习惯，一键打印；提供套打、批量打印、打印内容控制、打印偏移、静默打印等丰富的功能；相同环境下，零客户端打印耗时不到同类竞品的一半，本地软件打印耗时不到同类竞品的 1/3。
2. 打印功能：
   (1) 零客户端打印：无需安装打印软件，任何机器上随时都能打印，适合更偏向打印便捷性的客户；
   (2) 本地软件打印：需要安装打印软件，适合固定机器进行大量打印的客户，有更高的效率和更丰富的设置，不受浏览器约束。

报表特性_编码专题(20201002)

编码专题：

1. 编码：
   概念：编码就是将源对象的信息内容按照一种标准格式或形式转换为另一种标准格式。n 位二进制数可以组合成 2 的 n 次方个不同的信息，给每个信息规定一个具体码组，此过程也叫编码。
   编码原理：因世界上有不同的语言和文字，所以需要将不同的文字编码，通过计算机处理和传输。现在编码的种类非常多，主要目的就是为了信息间的转换。
   分类：目前常用的字符编码有：ASCII（美国标准信息交换码）、EBCDIC（扩展的BCD交换码）、GB2312、Unicode、UTF-8、ISO-8859-1 及 GBK 。
2. 乱码：
   出现原因：(1)浏览器编码与服务器编码不同；
   (2)缺少字体库。
3. 导出重命名乱码：
   解决方案：(1)在浏览器中直接输入；
   (2)集成到项目中。
4. URL给参数传递中文值(因为浏览器编码与服务器编码不一致，导致中文 URL 输入会产生乱码，无法被正常识别)：
   解决方案：(1)集成到项目中，可以使用 encodeURIComponent 方法，如点击某个链接给 col 赋值为地区。
5. URL传递特殊符号：
   解决方案：(1)在浏览器中直接输入；
   (2)集成到项目中。
6. MySQL数据库中文乱码：
   解决方案：(1)查看及修改MySQL字符集；
   (2)数据连接修改；

报表特性_cookie(20201003)

cookie：

1. 定义：
   Cookie 是存储于访问者计算机的变量，每当同一台计算机通过浏览器请求某个页面时，就会发送这个 Cookie。您可以使用 JavaScript 来创建和取回 Cookie 的值。比如，当我们访问 sina 等邮箱时，会有一个选项提醒我们是否要保存账号和密码，如果选是，我们的账号和密码就被保存在了 Cookie 中。
2. 使用方法
   我们可以通过 document 对象的 Cookie 属性对当前文档的 Cookie 进行读取，创建，修改和删除操作。
   (1)返回Cookie

document.write(document.cookie);

   (2)创建 Cookie
   JSP 中我们可以创建一个可在 Cookie 变量中存储访问者姓名的函数：

function setCookie(c_name,value,expiredays)
{
var exdate=new Date()
exdate.setDate(exdate.getDate()+expiredays)
document.cookie=c_name+ "=" +escape(value)+
((expiredays==null) ? "" : ";expires="+exdate.toGMTString())
}

   (3)检查Cookie
   下面函数首先会检查 document.cookie 对象中是否存有 Cookie。
   假如 document.cookie 对象存有某些 Cookie，那么会继续检查我们指定的 Cookie 是否已储存。如果找到了我们要的 Cookie，就返回值，否则返回空字符串。

function getCookie(c_name)
{
if (document.cookie.length>0)
  {
  c_start=document.cookie.indexOf(c_name + "=")
  if (c_start!=-1)
    { 
    c_start=c_start + c_name.length+1 
    c_end=document.cookie.indexOf(";",c_start)
    if (c_end==-1) c_end=document.cookie.length
    return unescape(document.cookie.substring(c_start,c_end))
    } 
  }

报表特性_国际化(20201004)

国际化报表：

1. 应用场景：一个企业的生产经营活动不局限于一个国家，而是面向世界经济舞台，做的项目或产品也希望实现显示不同的语言（中文、英文等），这样的效果要如何实现呢？下面详细介绍FR报表如何实现国际化。
2. 原理：
   国际化报表制作首先 FR 设计器可以手动切换语言，其次判断浏览器语言，若英语则显示英语；这样不同地区的人查看同一报表就可以根据不同地区显示不同的语言了，若获取浏览器语言失败，则使用设计器设置的语言。
3. 国际化设置：
   (1)切换设计器语言：
   首先在没有打开模板的情况下，点击工具栏文件->选项；然后再弹出对话框中设置语言选择这项，把设计器语言由简体中文切换成英文即可；最后重启设计器后才能生效。
   (2)切换浏览器语言：
   首先工具->选项，在弹出的对话框中选择语言，点击添加按钮，选择英语美国点击确定，这是英文就添加到浏览器里面了。这时报表工具栏的显示已经成中文了，但是报表显示内容还呈现中文，还需通过设置报表控制的语言显示方式。