帆软实施培训手册

帆软报表开发、部署培训手册BBRIGHTWAY名道恒通第1页，共70页。帆软报表介绍帆软表报服务器部署帆软报表模板的开发帆软报表的测试、发布大纲第2页，共70页。一、帆软报表介绍帆软报表介绍第3页，共70页。FineReport报表软件是帆软软件（中国）公司自主研发的一款纯Java编写的企业级web报表软件。FineReport是基于J2EE和WEB的综合报表解决方案，特有的EXCEL+绑定数据列的报表设计方式，支持多源分片，行列对称，能够轻松处理复杂的报表展现样式，全面支持主流的B/S架构以及传统的C/S架构，部署方式简单而灵活，完美解决中国式报表难题。FineReport报表工具提供了易用且高效率的报表设计方案，采用主流的数据双向扩展，真正无编码形式设计报表；拥有强大的报表展示功能，并且提供完善的报表权限管理，报表调度管理；具有完备的报表填报功能，支持多级汇总填报。帆软报表介绍第4页，共70页。帆软报表介绍第5页，共70页。二、帆软报表服务器部署帆软报表服务器部署第6页，共70页。FineReport是基于J2EE和WEB的综合报表解决方案。所以就决定了帆软报表需要运行在Java环境下。虽然是运行在Java环境下，但是同样可以应用到.Net的系统中。对于Java项目，与帆软集成非常容易，因为两者本身都是Java运行环境，可以实现无缝式嵌入。对于.Net系统，则需要单独部署一套J2EE容器来为帆软提供运行环境。下面就分别对Java项目和.Net项目与帆软报表集成进行说明。帆软服务器部署第7页，共70页。

1、与.Net系统集成

对于.Net系统，首先需要在服务区上部署Java运行环境。在系统中部署Java运行环境有以下几步：安装并配置Java运行库(JDK/JRE)安装tomcat(轻量级的J2EE容器)部署帆软报表服务器，测试是否部署成功进行IIS与tomcat的系统集成测试IIS与tomcat集成是否成功帆软服务器部署第8页，共70页。1、安装并配置Java运行库(JDK/JRE) 首先从Oracle网站下载Java运行库JDK。根据服务区的版本不同，下载的版本也不同(32位、64位)。帆软服务器部署第9页，共70页。双击下载的安装文件

帆软服务器部署第10页，共70页。配置Java运行环境变量帆软服务器部署第11页，共70页。配置Java运行环境变量帆软服务器部署第12页，共70页。2、部署tomcat服务器

首先从apache官网下载tomcat(版本无所谓)帆软服务器部署第13页，共70页。将下载的zip文件解压到任意目录点击tomcat目录下的bin目录中startup.bat帆软服务器部署第14页，共70页。如果启动成功，则需要将tomcat做成系统服务帆软服务器部署第15页，共70页。3、部署帆软报表服务器

首先到帆软的网站下在最新的帆软设计器客户端，双击下载后的安装文件帆软服务器部署第16页，共70页。当你能看见当前界面时，恭喜你，安装成功！帆软服务器部署第17页，共70页。下图为帆软的安装目录，其中有两个目录比较重要document：帆软教程目录WebReport：帆软服务器工程目录帆软服务器部署第18页，共70页。接下里要做的事情，就是将WebReport目标原封不动的拷贝到我们之前部署的tomcat中，目录如下。接着需要重启tomcat，当然你看到如下画面时，恭喜你，部署成功。帆软服务器部署第19页，共70页。4、进行IIS与tomcat集成

将附件提供的文件拷贝到tomcat对应的目录中。其中ISAPI为新建目录，拷贝后的结果如下：帆软服务器部署第20页，共70页。关于conf中的文件配置说明：帆软服务器部署第21页，共70页。关于ISAPI中的文件配置说明：帆软服务器部署第22页，共70页。关于IIS部分配置说明。首先要在IIS的web引用工程上新增虚拟目录。帆软服务器部署第23页，共70页。为你的Web系统添加ISAPI筛选器帆软服务器部署第24页，共70页。帆软服务器部署第25页，共70页。重启IIS和tomcat后，验证配置是否成功帆软服务器部署第26页，共70页。

2、与Java系统集成

因为帆软报表是基于Java开发的，所以可以实现与Java项目的无缝式集成。对于两者的集成，建议由开发人员直接进行项目集成。帆软服务器部署第27页，共70页。三、帆软报表模板制作帆软报表模板开发第28页，共70页。帆软报表模板开发文件文本文件/Xml/Excel服务器数据集全局性的、所有模板使用语义层数据集报表数据集单个报表模板的数据集报表模板cpt前台展示View数据库Table/View/Procedures程序代码第29页，共70页。由上图可以知道，整个报表开发的过程就是将数据与报表模板融合的过程，因此整个开发过程分为以下几步：配置数据源定义全局数据集(可选)创建报表文件为报表文件指定或创建数据集将数据集中的数据与报表文件融合预览帆软报表模板开发第30页，共70页。上面的步骤是开发报表的基本流程。其中全局数据集不是必备，对于很通用的数据，可以做为全局数据集，供所有报表引用。如果开发环境与部署环境不在同一个环境下，那么要注意数据源的配置。下图为帆软数据源的配置文件及存放目录，如果两个环境不同，需要将本地的数据源配置同步到服务器上。帆软报表模板开发第31页，共70页。下面就以上图为例，讲述整个报表的开发过程。上图报表作用是按照工厂展示其装置和班组信息。其中有一个搜索条件--------工厂。其中装置为横向扩展，班组为纵向扩展。帆软报表模板开发第32页，共70页。1、配置数据源

帆软报表可以使用多种数据来源，其中主要分为三大类：文件、数据库、程序。

文件：包括文本、excel、xml，需要符合特定的格式。

数据库：包括表、视图、存储过程。

程序：仅支持Java程序，要求实现特定的接口。

每一类都有特定的使用场景。其中最常用的就是数据库方式；文件主要适用于需要导入获取数据的场景；程序主要是为需要有开发人员直接开发报表的场景；多数时候，可以被数据库方式所替代。

下面就以数据库方式讲解报表的制作及数据融合过程。帆软报表模板开发第33页，共70页。配置数据源帆软报表模板开发第34页，共70页。帆软报表模板开发第35页，共70页。2、定义全局数据集帆软报表模板开发第36页，共70页。帆软报表模板开发第37页，共70页。3、创建报表文件帆软报表模板开发第38页，共70页。帆软报表模板开发第39页，共70页。因为有数据集有全局数据集，报表数据集之分。所以以下开发过程将针对各个数据集进行说明。全局数据集方式帆软报表模板开发第40页，共70页。

首先添加报表参数。当前添加为报表参数。标红部分为参数单元格，右键控件设置出现设置菜单。帆软报表模板开发第41页，共70页。帆软报表模板开发第42页，共70页。帆软报表参数有两种分类方式，分别对应与不同的使用情况。按照作用域分：单个报表参数与全局参数按照类型分为：数据集参数与数据源参数

数据集参数：主要对数据集中的数据进行过滤

参数不会影响数据集中的数据，只

会影响展示数据。

数据源参数：直接影响数据集数据。

所有参数可以统称为报表参数。帆软报表模板开发第43页，共70页。参数设置完后，我们进行数据结果的绑定以及数据过滤的处理。模板效果图如下：帆软报表模板开发第44页，共70页。帆软报表模板开发第45页，共70页。首先对装置单元格数据进行过滤，指定只有工厂名称与参数相同的数据才能显示。帆软报表模板开发第46页，共70页。设定单元格的扩展方向，默认为从上到下，此处修改为从左到右。帆软报表模板开发第47页，共70页。对班组单元格添加了两条数据过滤条件：1、工厂与参数值相同；2、装置与C单元格相同

帆软报表模板开发第48页，共70页。设定报表标题头为所选工厂名称加上“装置列表”

帆软报表模板开发第49页，共70页。双击报表参数，然后手动在后面不上字符串，加号链接。帆软报表模板开发第50页，共70页。效果展示帆软报表模板开发第51页，共70页。报表数据集：依托为某张报表而存在的数据集

首先添加数据库数据集。帆软报表模板开发第52页，共70页。此时点击参数设计，添加报表参数。会发现在左侧参数栏中自动出现我们在数据源中设置的参数，右边参数模板也会默认提供参数名以及参数框。在参数框上单击右键空间设置会发现，默认已经将空间名称绑定为参数名称。如果有多个参数时，需要手工选择。帆软报表模板开发第53页，共70页。我们此时要做的就是为当前参数提供数据源，并修改参数名称。帆软报表模板开发第54页，共70页。我们此时要做的就是为当前参数提供数据源，并修改参数名称。帆软报表模板开发第55页，共70页。接下来的步骤与使用全局数据集基本相同，只有一个地方不同。因为我们使用了数据源参数，那么结果集中所提供的数据都是满足参数条件的。所以不需要再设置“装置字段”的过滤条件了，只要设置其扩展方向。帆软报表模板开发第56页，共70页。对班组单元格添加了两条数据过滤条件：1、工厂与参数值相同；2、装置与C单元格相同

帆软报表模板开发第57页，共70页。设定报表标题头为所选工厂名称加上“装置列表”

帆软报表模板开发第58页，共70页。双击报表参数，然后手动在后面不上字符串，加号链接。帆软报表模板开发第59页，共70页。展示效果帆软报表模板开发第60页，共70页。语义层数据集

首先明确什么是语义层？其次语义层在帆软中的作用？

语义层通常应用于web报表软件中，作用是把数据库中的对象进行包装，产生高度面向业务的数据抽取模型。经过这种处理后，数据处理可以在业务层面上进行，在生成报表的时候，处理逻辑清晰。帆软报表模板开发第61页，共70页。语义层在帆软中的作用以目前的情况来，语义层主要为实施人员提供的。因为随着系统所使用的数据表越来越多，实施人员无法完全了解每张表、每个字段的作用。因此产生了语义层作用，开发人员将表的每个字段都转为对应的汉语意义，供实施人员在制作报表时使用。

使用语义层时存在以下几个问题：1、性能问题，使用时存在字段与表现值的转换问题2、空间问题，需要建立额外的表存放对照信息，特

别是当同名字段映射为不同含义时，

需要的表会越来越多。帆软报表模板开发第62页，共70页。语义层的替代方案：

如果在开发过程中，数据库文档齐全。实施人员在设计报表时，完全可以不使用语义层进行转换。帆软报表模板开发第63页，共70页。四、帆软报表测试、发布帆软报表的测试、发布第64页，共70页。1、报表的测试、发布

报表的开发工作由各个实施人员单独完场。但是对于报表的发布(测试版、正式版)，与系统的集成，都应遵循以下原则：由专人负责测试版、正式版的发布工作。每次发布都要进行详细的记录，发布日期、报表名称、报表功能、适用范围、报表菜单。必须先发布测试版，经客户确认无误后，才能发布正式版。发布正式版时，需要在版本控制中添加说明，表明系统提供了新的功能。帆软报表的测试、发布第65页，共70页。报表模板制作完成后，需要发布到服务器上进行实际环境测试。测试过程过中，需要实施人员与客户进行数据、样式等方面的确认。一旦客户确认无误后，则需要发布到正式生产环境供客户使用。

因此，对应于报表的整个开发、测试、发布，每一步都需要一个相应的运行环境。帆软报表的测试、发布本地开发环境服务器测试生产环境服务器正式生产环境实施人员电脑系统服务器服务器开发测试环境第66页，共70页。因为存在实施人员本地开发提示授权问题，为了解决这个问题。由上图可知，对于服务区上需要存在至少三个环境：开发测试环境，测试生产环境，正式生产环境开发测试环境：实施人员将本地开发好的模板上传到该环境测试，解决出现需要授权问题。测试生产环境：此环境下的数据与正式生产环境相同，甚至更多，但为测试性质，主要是测试系统bug以及报表展示情况。正式生产环境：由客户确认过的报表以及系统功能，测试无误后，由专人发布到正式生产环境中，并通知客户。帆软报表的测试、发布第67页，共70页。2、添加菜单

根据报表的使用范围不同，添加菜单的方式也不尽。全局报表：所有人都可以看，没有数据权限，则跟系统其它菜单一样配置，根据菜单层级，可能会需要使用../来进行目录的设置。个性化报表：如果同一个报表，不同厂的具体展示内容不同，则需要有多个模板，此时需要开发人员提供单独的aspx页面，通过使