报表总结.doc

目录一、前言1二、环境配置2三、报表工具使用33.1、源文件33.2、工具栏43.3、管理器43.4、单元格属性63.5、报表属性63.6、创建报表7四、程序执行流程154.1、参数界面154.2、显示结果154.3、生成报表内容15五、高级篇155.1、报表生成方式15六、快捷键206.1、快速插入206.2、快速合并216.3、快速发布22七、复用模版22八、常见问题解决方法238.1、报表工具使用常见问题238.2、集成部署常见问题338.3、二次开发常见问题388.4、开发过程中常见问题解决41九、参考资料44报表学习总结一、 前言东软通用查询与报表系统 unieap report是一款功能强大的报表工具，它不仅功能全面，更重要的是它可以实现高效率制表、无需任何编码，解决了大多数其他报表工具很难做、无法做的问题。中国式报表衍生出的问题，是困扰着很多人的难题。例如，多数据源：一张报表的数据来自多个数据表或视图，甚至来自多个不同的异构数据库；分片、整表规则不统一：报表分成多片，每片规则各不相同，甚至同批数据也可能按不同规则处理；固定行列、不完全划分；表头复杂、且层次深；复杂格间运算、跨行组运算；对报表产品集成性要求高等等。利用传统报表工具往往很难解决上述问题， unieap report解决了上述问题！ unieap report是一款企业级的报表工具，集查询、报表、分析于一体，您可以通过设计器直接设计各种复杂格式的报表，可以通过web浏览器方式展现、打印、输出报表结果。在功能及主要应用模式上， unieap report与主流bi产品的前端工具，及常见的其他国内报表工具是类似的。本文着重介绍unieap report报表设计工具报表设计器的使用方法，其具有以下主要特性：l 基于eclipse插件技术开发，依托eclipse平台的强大功能，轻松实现工具扩展；l 类似于excel的网格绘制方案，报表简单易做，轻松上手；l 提供向导式构建方案，无需您深入了解报表使用规则，即可快速构建简单报表；l 支持导入excel文件；l 提供对多种数据源的支持；l 先进的数据模型；优点：快速的完成导出各种图表功能，简单的2层结构。缺点：功能有限，支持图表类型有限，容易造成内存泄露（eclipse偶尔自动关闭）二、 环境配置需要配置的东西不多：1导入插件，放在eclipse的plugins里面。所有插件在一个文件夹里2. 把myreport工程放在项目用的tomcat下。启动工程输入http:/localhost:8080/myreport登陆报表系统，帐号admin,密码1，如果能登陆 说明可以用了，不可用可能没有连接数据库默认连接的是92的。如果不是需要更改reporttools myreport web-infconfunieapconnection和reporttoolsmyreportweb-infconfunieap udolinkconf下的配置文件。connection-config.xml，supportdb.properties3在eclipse-window-preferences-服务库中设置2的信息。服务库配置完成后请点击“报表”“刷新服务库”菜单项，如连接正常，弹出提示对话框，如下图所示：注：因为现有工程有一些报表相关设置，所以开发者只需要做以上3步即可，如果工程中没有相关配置，开发着可以根据unieap report v3.3 集成手册.doc进行配置。三、 报表工具使用先简单介绍下，基本结构，下面的图算是一个基本的完整结构。下面一一进行分析。3.1、源文件文件的扩展名为rdx，有两种打开方式：一种是用报表编辑器打开，效果图为一种打开方式为文本方式。这种格式是一种xml文件3.2、工具栏其实操作报表和操作excel差不多。上面的功能大部分为格式设置，右边的几个具有发布报表等功能。当鼠标停留在上边的时候会有提示。3.3、管理器数据集:里面放的是显示数据的sql,定义数据集的时候需要选择数据源。数据源形成unieap report与报表数据来源(数据库、数据文件等)的jdbc连接，创建数据集时将从对应的数据源中选择数据表、字段等信息，以及预览报表时从数据库、数据文件等报表数据来源中读取数据。您可以同时定义多个数据源，unieap report支持的数据源类型包括：复杂sql数据源（包括drm及jdbc两种方式）、简单sql数据源、xml数据源、存储过程数据源、csv数据源、api数据源、内建数据源以及sap数据源，并且支持用户自定义扩展数据源类型。参见“ unieap report数据源”章节。报表元素：unieap report中，每一个单元格均为构建报表的基本元素。文本、图片、图表、仪表盘、子布局、条形码。如何定义报表元素，请阅读“定义报表元素”章节。参数:生成报表的条件，您在构建报表的过程中需要使用变量来限定报表结果，比如报表获取的数据范围等，比如生成从2010-10-10开始到2011-10-10的报表。这个条件就在这里。变量可以应用到数据集和公式中，在生成报表时进行替换。根据使用方式不同变量主要分为两种：参数和系统变量。详细内容参见“参数与系统变量”章节。布局用的也不多，可以用可以不用。在参数单击右键分别为新建，排序和自定义界面。新建就是新建参数，可以选择参数类型等。排序是对参数的排序，自定义界面是对参数界面的定义，默认为空，表示自动生成参数界面（就是jsp文件）,也可以指定地址。（只要定义好界面，在这里输入地址，点击相应报表的时候自动进去参数界面，不需要做其它设置，unieap report封装好的）确定后提交到report-resultaction.do中需要参数就在后面追加，例如：在提交的函数中加document.eapform.action= /report-resultaction.do?reportid= + reportid + &path= + logopath + &systempagetitle= + systempagetitle;表示向报表模板传递reportid，path，logopath，systempagetitle参数。3.4、单元格属性这个是设置单元格的属性。在上图中，文本框的值需要注意，有一些文本框可以设置公式，当先输入一个“=”号的时候，就是出现相应的提示，具体公式的使用详见unieap report v3.3 公式查询手册.doc文档。3.5、报表属性可以设置报表的横向打印，纸张设置等。3.6、创建报表3.6.1 创建空白报表创建一张空白报表步骤如下：1. 新建unieap 工程，或者在现有的工程中，新建一个文件夹（以myreport为例）2. 在myreport文件夹上右键单击”new”other”report”节点，选择next.为报表文件命名。3. 点击按钮，在创建模式页中选择“创建空白报表”。如下图所示：4. 点击按钮，报表设计器会自动新建一张空白报表，并在编辑区中打开。如下图所示：3.6.2 设置参数参数是在报表设计器中定义的，定义参数后在web浏览器端查看报表时会自动生成参数页面，由用户输入或选择参数值。具体的参数设置见unieap report v3.3 工具手册.doc文档中参数与系统变量章节。新建参数页面，如图3.6.3 创建数据集创建所需要的数据集，步骤如下：1. 请在报表资源面板中，右键单击数据集节点，点击“新建”菜单项。如下图所示：2. 请在弹出的数据集向导中，选择数据源类型“复杂sql数据源”。数据源名称选择“soms”，数据集名称为monitorbaseinfo。如下图所示：3. 点击按钮，进入sql数据集设置页，填写sql语句：4. 点击按钮，系统解析当前数据集的sql语句,并在字段列表的字段域自动填入解析字段。如下图所示：5. 点击按钮，完成数据集定义。如下图所示：3.6.4 设置报表元素1. 创建一个ad监控器基本信息的报表。如下图所示：第1-6行采用列合并；第7-17行采用前2列合并，后六列合并；18-19行采用列合并。修改后的行列按所在行列的最左上格命名。a1单元格指的是原第一行所有列，a7单元格指的是原第七行第一二列，c8指得是原第8行cdefgh 6列。2. 在a2行单击右键，选择编辑属性。设置字号14，背景颜色蓝。3. a19行是设置下边框颜色。其余边框无色。c7-c17是从数据集拖进去的在拖得时候有三选择，具体如何选择请查看文档unieap report v3.3 公式查询手册.doc数据集公式。3.6.5 发布报表1. 点击工具栏中按钮，若第一次发布此报表，系统将弹出“选择远程报表位置”窗口，在其中选择报表所要保存的位置。如下图所示：若已经发布过，系统会提示是否保存到上一次发布的位置，若选否则弹出“选择远程报表位置”窗口。2. 点击或按钮，弹出对话框，提示发布成功。如下图所示： 报表发布以后会在数据库的unieap_report_define和unieap_report_category表存入报表的信息（这两个表不是生成导航树的表）3.6.6 浏览报表1. 打开浏览器窗口，输入http:/localhost/soc；2. 在登录页面中输入用户名、密码和验证码；3. 单击“报表”tab页，在窗口左部分的报表树中单击要浏览的报表名称，即可出现要浏览的报表结果页面。如下图所示：注:1. 这种方法适合自动生成参数界面或没有参数界面，如果自定义参数界面需要引入界面文件。否则报错.具体创建报表见“基本操作”章节.2 . 新发布的报表可能需要重起tomcat服务器才能看到最新的内容。首次访问的修改的报表不需要重起tomcat，可以直接查看，其余报表都需要重起tomcat才行。四、 程序执行流程下面以福建中烟监控器报表为例，讲述下流程。4.1、参数界面之前说过了，见3.3节。用户确定后会把数据提交到report-resultaction.do中，并在需要参数就在后面追加。格式参照?reportid= + reportid + &path= + logopath”.这些设置都在monitorpara.jsp中。这个文件需要一系列的处理，将在后续高级操作中讲4.2、显示结果结果在clientshow.jsp文件中显示。这个页面可以把异常打印出来，供修改参考。这个文件需要一系列的处理，将在后续高级操作中讲。4.3、生成报表内容报表内容就是我们第三章介绍的知识。可以回过头在温习一遍。这个过程生成的内容在clientshow.jsp页面中显示。五、 高级篇如果是初学者，这部分可以跳过。如果读前面的知识很熟练的掌握了，再看这里。本章以福建中烟中报表相关技术为例，讲述2种生成报表的方法。5.1、报表生成方式5.1.1手动生成手动生成报表就是点击报表模块后，选择导航树，输入生成条件，然后确定即可生成报表。流程介绍1先进入报表模块页面2选择资产风险趋势报表3输入生成条件，点击确定按钮4生成的报表如下图，具备导出和打印功能等。代码结构1导航树的页面为reportnavigation.jsp。导航为一个单选树，reportnavigationaction为生成树的action类，通过数据库的t_report_type和t_report_models表生成的。（在发布完报表后需要，给这2个表输入值，导航树才能产生节点）2参数的页面为singleassetpara.jsp 这个页面在报表模板的参数自定义界面里设置路径，为报表的生成提供参数。点击确定后会把参数传入到report-resultaction类中（封装好的），返回的结果是以html形式生成的报表，并跳转到clientshow.jsp中。参数的填写及含义如下表格所示：report-resultaction参数定义关键字值说明reportid报表的id号通过报表id得到要创建的报表（必填值）。newreporttrue，false是否新创建报表，如果值为true，表示这是新报表，否则从缓存中读取。cachedid报表的缓存id通过它可以读取缓存中的报表，新创建报表时可不填。npagenull，数值当前报表显示的页号，如果值为null，显示第一页，新创建报表时可不填。pagecount数值报表的总页数，新创建报表时可不填。encode字符串（true，false，空）true为用base64对中文进行解码，其它为不用base64进行解码（中文参数用base64进行解码）。linagenull或数值每页显示多少行，all、-1表示全显示，如果不填写则该值是定义报表时的默认值。报表参数字符串传送过来的参数名称及其值。如果没有参数可不填，如果有多个参数按照如下方式书写：参数1=china&参数2=neusoft.。例如：报表有两个参数 country=中国 和personname=小明http:/localhost:8080/unireport/report-resultaction.do?reportid=94b7d07d-a7f8-4745-adc2-d8731f80387a&newreport=true&linage=20&country=5lit5zu&personname=5bcp5pio &encode=true这个url的意思是新创建参数country=中国(中国用base64编码后为5lit5zu)、personname=小明(小明用base64编码后为5bcp5pio)、报表的id为94b7d07d-a7f8-4745-adc2-d8731f80387a的报表，每页显示20行。如何对中文进行base64编码请参考第7章7.1节。【备注】在遇到checkbox类型的自定义预设值参数时，书写格式为&show=jack:;chen:;marry，中间用:;隔开。【注意】如果想实现调用resultacion并且跳转到另一个jsp文件中可这样写url： http:/localhost:8080/unireport/report-resultaction.do?reportid=94b7d07d-a7f8-4745-adc2-d8731f80387a&clientshow=othershow其中othershow是在struts-config.xml文件中report-reusltaction对应的一个forward属性。3报表展示页面clientshow.jsp这两部分的功能都是在clientshow页面中定义显示的。报表的内容在这两部分中间，再iframe中以html格式输出。5.1.2自动生成这个功能见报表发送策略，如下图这个功能采用，邮件发送报表内容，用户可以选择报送的格式和邮件地址等。流程介绍1先添加一个发送策略，这里可以选择报表模板，设置发送周期，图表类型，发送格式等。2添加好的策略可以在这里，停用，启用，修改和删除代码结构1添加页面为reportsendingtaskadd.jsp和修改页面为reportsendingtaskedit.jsp提交后会把设置的参数信息封装到reportsendingtaskvo和task对象，reportsendingtaskvo储存到数据表t_report_task_addinfor中，task对象传递给schedularmanager类的add或update方法。2列表管理页面启用调用manage.runtask(id) 停用调用manage.pausetask(id)删除调用manage.delete(id)id为“taskgroup#”+报表发送策略名称。六、 快捷键6.1、快速插入默认新建的报表是10行6列的。注意看右边有条线，这是纵向打印的边线，超过的部分不能导出或打印到。在列上点右键会弹出列菜单，同理在行上点弹出行菜单.,在单元格上点，也会不同出现注意快捷键，我们插入单行的时候用不用快捷键都行，但是如果多行插入，一个个点是很费劲的（不支持多行插入），这时候可以一个手点鼠标，一个手点键盘。不如:右键+i就是插入列，右键+i, 右键+i 就是插入2列.6.2、快速合并普通合并方法为选重单元格点右键，选择合并单元格。如果需要合并的很多，这种方法也不适用了，下面介绍我的方法。先把左手放在m键和回车上，选中单元格，点右键，然后瞬间就可以用左手完成m+回车，这样合并速度还是很快的。注意：如果你短时间内鼠标点击过快，eclipse会自动退出。不过放心退出前自动保存的。这个也是报表的一个缺陷，当然累积到一定次数的点击也会导致eclipse退出。6.3、快速发布是发布按钮，一般发布的时候需要点它，点完出现选择左手按空格，则直接发布（如果不是更改位置，发布在瞬间执行）点击否的时候，需要选择发布位置。发布后的报表想查看的话需要重起tomcat（没有查看过的报表除外）七、 复用模版报表不存在include另一个报表的功能，如果两个报表大部分功能完全一样，我们可以这么做。第一种方法，加入a.rdx为做好的报表，我们要做一个功能一样的b.rdx。1. 复制一个a报表名aa。新建一个b报表。2. 用文本方式打开b报表，b报表的第二行代码复制，覆盖aa报表的第二行代码。3. 删除b报表，把aa改名为b这样就做好了一个b报表。具体原理如何，自己看代码吧。后续的就不说了。第二种方法，a.rdx为做好的报表，我们要做一个功能一样的b.rdx。这时候只需要复制a.rdx重命名为b.rdx，并且把报表的名字改成不重复的，再发布即可（不要覆盖之前发布的位置）注意：同一个报表在发不到不同的目录下时id是变化的，适用的时候要仔细检查调用报表处代码原始id是否与最新id不同。八、 常见问题解决方法报表工具使用,集成部署和二次开发的常见方法