帆软报表开发、部署培训手册BBRIGHTWAY名道恒通一.帆软报表介绍二.帆软表报服务器部署三.帆软报表模板的开发四.帆软报表的测试、发布大纲一、帆软报表介绍帆软报表介绍报表软件是帆软软件(中国)公司自主研发的一款纯Java编写的企业级web报表软件。FineReport是基于J2EE和WEB的综合报表解决方案,特有的EXCEL+绑定数据列的报表设计方式,支持多源分片,行列对称,能够轻松处理复杂的报表展现样式,全面支持主流的B/S架构以及传统的C/S架构,部署方式简单而灵活,完美解决中国式报表难题。FineReport报表工具提供了易用且高效率的报表设计方案,采用主流的数据双向扩展,真正无编码形式设计报表;拥有强大的报表展示功能,并且提供完善的报表权限管理,报表调度管理;具有完备的报表填报功能,支持多级汇总填报。帆软报表介绍二、帆软报表服务器部署帆软报表服务器部署的综合报表解决方案。所以就决定了帆软报表需要运行在Java环境下。虽然是运行在Java环境下,但是同样可以应用到.Net的系统中。对于Java项目,与帆软集成非常容易,因为两者本身都是Java运行环境,可以实现无缝式嵌入。对于.Net系统,则需要单独部署一套J2EE容器来为帆软提供运行环境。下面就分别对Java项目和.Net项目与帆软报表集成进行说明。帆软服务器部署、与.Net系统集成对于.Net系统,首先需要在服务区上部署Java运行环境。在系统中部署Java运行环境有以下几步:①安装并配置Java运行库(JDK/JRE)②安装tomcat(轻量级的J2EE容器)③部署帆软报表服务器,测试是否部署成功④进行IIS与tomcat的系统集成⑤测试IIS与tomcat集成是否成功帆软服务器部署、安装并配置Java运行库(JDK/JRE)①首先从Oracle网站下载Java运行库JDK。根据服务区的版本不同,下载的版本也不同(32位、64位)。帆软服务器部署②双击下载的安装文件帆软服务器部署③配置Java运行环境变量帆软服务器部署③配置Java运行环境变量帆软服务器部署、部署tomcat服务器①首先从apache官网下载tomcat(版本无所谓)帆软服务器部署②将下载的zip文件解压到任意目录③点击tomcat目录下的bin目录中startup.bat帆软服务器部署④如果启动成功,则需要将tomcat做成系统服务帆软服务器部署、部署帆软报表服务器①首先到帆软的网站下在最新的帆软设计器客户端,双击下载后的安装文件帆软服务器部署②当你能看见当前界面时,恭喜你,安装成功!帆软服务器部署②下图为帆软的安装目录,其中有两个目录比较重要document:帆软教程目录WebReport:帆软服务器工程目录帆软服务器部署③接下里要做的事情,就是将WebReport目标原封不动的拷贝到我们之前部署的tomcat中,目录如下。接着需要重启tomcat,当然你看到如下画面时,恭喜你,部署成功。帆软服务器部署、进行IIS与tomcat集成①将附件提供的文件拷贝到tomcat对应的目录中。其中ISAPI为新建目录,拷贝后的结果如下:帆软服务器部署②关于conf中的文件配置说明:帆软服务器部署③关于ISAPI中的文件配置说明:帆软服务器部署④关于IIS部分配置说明。首先要在IIS的web引用工程上新增虚拟目录。帆软服务器部署⑤为你的Web系统添加ISAPI筛选器帆软服务器部署⑥重启IIS和tomcat后,验证配置是否成功帆软服务器部署、与Java系统集成因为帆软报表是基于Java开发的,所以可以实现与Java项目的无缝式集成。对于两者的集成,建议由开发人员直接进行项目集成。帆软服务器部署三、帆软报表模板制作帆软报表模板开发帆软报表模板开发文件文本文件/Xml/Excel服务器数据集全局性的、所有模板使用语义层数据集报表数据集单个报表模板的数据集报表模板cpt前台展示View数据库Table/View/Procedures程序代码由上图可以知道,整个报表开发的过程就是将数据与报表模板融合的过程,因此整个开发过程分为以下几步:1.配置数据源2.定义全局数据集(可选)3.创建报表文件4.为报表文件指定或创建数据集5.将数据集中的数据与报表文件融合6.预览帆软报表模板开发上面的步骤是开发报表的基本流程。其中全局数据集不是必备,对于很通用的数据,可以做为全局数据集,供所有报表引用。如果开发环境与部署环境不在同一个环境下,那么要注意数据源的配置。下图为帆软数据源的配置文件及存放目录,如果两个环境不同,需要将本地的数据源配置同步到服务器上。帆软报表模板开发下面就以上图为例,讲述整个报表的开发过程。上图报表作用是按照工厂展示其装置和班组信息。其中有一个搜索条件--------工厂。其中装置为横向扩展,班组为纵向扩展。帆软报表模板开发、配置数据源帆软报表可以使用多种数据来源,其中主要分为三大类:文件、数据库、程序。文件:包括文本、excel、xml,需要符合特定的格式。数据库:包括表、视图、存储过程。程序:仅支持Java程序,要求实现特定的接口。每一类都有特定的使用场景。其中最常用的就是数据库方式;文件主要适用于需要导入获取数据的场景;程序主要是为需要有开发人员直接开发报表的场景;多数时候,可以被数据库方式所替代。下面就以数据库方式讲解报表的制作及数据融合过程。帆软报表模板开发、定义全局数据集帆软报表模板开发、创建报表文件帆软报表模板开发因为有数据集有全局数据集,报表数据集之分。所以以下开发过程将针对各个数据集进行说明。①全局数据集方式帆软报表模板开发首先添加报表参数。当前添加为报表参数。标红部分为参数单元格,右键控件设置出现设置菜单。帆软报表模板开发帆软报表参数有两种分类方式,分别对应与不同的使用情况。a)按照作用域分:单个报表参数与全局参数b)按照类型分为:数据集参数与数据源参数数据集参数:主要对数据集中的数据进行过滤参数不会影响数据集中的数据,只会影响展示数据。数据源参数:直接影响数据集数据。所有参数可以统称为报表参数。帆软报表模板开发参数设置完后,我们进行数据结果的绑定以及数据过滤的处理。模板效果图如下:帆软报表模板开发首先对装置单元格数据进行过滤,指定只有工厂名称与参数相同的数据才能显示。帆软报表模板开发设定单元格的扩展方向,默认为从上到下,此处修改为从左到右。帆软报表模板开发对班组单元格添加了两条数据过滤条件:1、工厂与参数值相同;2、装置与C单元格相同帆软报表模板开发设定报表标题头为所选工厂名称加上“装置列表”帆软报表模板开发双击报表参数,然后手动在后面不上字符串,加号链接。帆软报表模板开发②报表数据集:依托为某张报表而存在的数据集首先添加数据库数据集。帆软报表模板开发此时点击参数设计,添加报表参数。会发现在左侧参数栏中自动出现我们在数据源中设置的参数,右边参数模板也会默认提供参数名以及参数框。在参数框上单击右键空间设置会发现,默认已经将空间名称绑定为参数名称。如果有多个参数时,需要手工选择。帆软报表模板开发我们此时要做的就是为当前参数提供数据源,并修改参数名称。帆软报表模板开发我们此时要做的就是为当前参数提供数据源,并修改参数名称。帆软报表模板开发接下来的步骤与使用全局数据集基本相同,只有一个地方不同。因为我们使用了数据源参数,那么结果集中所提供的数据都是满足参数条件的。所以不需要再设置“装置字段”的过滤条件了,只要设置其扩展方向。帆软报表模板开发对班组单元格添加了两条数据过滤条件:1、工厂与参数值相同;2、装置与C单元格相同帆软报表模板开发设定报表标题头为所选工厂名称加上“装置列表”帆软报表模板开发双击报表参数,然后手动在后面不上字符串,加号链接。帆软报表模板开发语义层数据集首先明确什么是语义层?其次语义层在帆软中的作用?语义层通常应用于web报表软件中,作用是把数据库中的对象进行包装,产生高度面向业务的数据抽取模型。经过这种处理后,数据处理可以在业务层面上进行,在生成报表的时候,处理逻辑清晰。帆软报表模板开发语义层在帆软中的作用以目前的情况来,语义层主要为实施人员提供的。因为随着系统所使用的数据表越来越多,实施人员无法完全了解每张表、每个字段的作用。因此产生了语义层作用,开发人员将表的每个字段都转为对应的汉语意义,供实施人员在制作报表时使用。使用语义层时存在以下几个问题:1、性能问题,使用时存在字段与表现值的转换问题2、空间问题,需要建立额外的表存放对照信息,特别是当同名字段映射为不同含义时,需要的表会越来越多。帆软报表模板开发语义层的替代方案:如果在开发过程中,数据库文档齐全。实施人员在设计报表时,完全可以不使用语义层进行转换。帆软报表模板开发四、帆软报表测试、发布帆软报表的测试、发布、报表的测试、发布报表的开发工作由各个实施人员单独完场。但是对于报表的发布(测试版、正式版),与系统的集成,都应遵循以下原则:①由专人负责测试版