java开发润乾报表.doc

润乾报表设计1、 安装润乾报表设计器2、 设计报表模板3、 数据集为存储过程的报表设计4、 将设计好的模板部署到应用中过去5、存储过程1安装润乾报表设计器1.1获取安装包安装包在svn上: 1/svn/core/开发组资料/开发工具/润乾报表v4.5.exe Check后安装即可.安装后的目录结构如下:1.2完成相关授权使用润乾报表设计器需要完成两次授权:A: 润乾报表设计器授权B: 设计完成后发布应用的服务器授权目前我们本机采用的是Windows的授权,服务器上的ycps项目采用的是Linux授权版本,所以我们在开发完成后不要commit授权文件1.3授权完成授权完成,启动后的界面如下:2简单报表设计2.1配置数据源A: 配置数据源B: 数据源配置界面C: 点击新建自己的数据源D: 数据源配置细节，为了开发的统一 数据源名称统一采用“oracle”E: 确定之后F: 连接成功2.2数据集的配置A: 新建报表 如图:A: 配置数据集,也可以直接F11快捷键B: 数据集配置C: 选择模式、表、字段 D：选择需要的字段 E：此时你可以点击 语法 选项卡看看，聪明的你就明白了，然后确定即可F：数据集ds1已经创建完成2.3简单报表的实现A：利用配置好的数据集 设计简单模板B：启动tomcat、发布模板、在浏览器中浏览C：浏览3数据集为存储过程的报表设计3.1配置数据源 见2.13.2配置数据集3.2.1配置存储过程数据集B：弹出 存储过程数据集，在此之前存储过程一定要测试成功C：配置数据集参数说明：1、 参数的个数、顺序要和procedure严格一致2、 结果类型应该指定具体类型 如字符串3、 注意输出参数及类型D：确定，但是没有完！3.2.2配置模板参数可以这样理解：刚才配置的数据集参数需要由报表模板来提供，那模板也需要配置参数A：配置 参数B：参数编辑,然后确定 模板设计完毕3.2.3在设计器中浏览报表A：按F11进入数据集设置B：点击浏览数据C：填入必填的参数 确定即可浏览，注意此处的浏览只是证明数据集设置的正确性D：数据集设置完成且正确后 会出现如下。说明：由于采用存储过程检索数据，返回的是游标，所以这里设计好的数据集看不到相关的字段名称等，在设计报表时要对应相应的表或存储过程来3.3报表设计 见2.3根据上面的数据集 参见2.3设计报表就可以了4将开发测试好的模板部署到应用中4.1添加配置A：添加润乾所需的配置文件 见ycps工程在WEB-INF下添加在classpath下添加 见ycps工程说明：1、 reportConfig.xml是润乾的web应用配置文件2、 runqianReportLperties日志文件3、 runqianSemanticFile.xml是语意层配置文件，目前我们没有使用到4、 runqianReport4.tld是页面标签描述文件，将数据展示到页面上的自定义标签5、 runqianWindowServer.lic是润乾的应用授权文件B：添加润乾所需的jar包，所需jar包在润乾安装目录下demo中都可以找到还有一个打印用的这个jar文件要放到应用的根目录下才起作用 见ycps工程4.2修改相关配置A: 在web.xml中添加润乾报表的配置 见ycps工程B：修改reportConfig.xml文件 见ycps工程主要关注3个地方：授权文件、reportFileHome和数据源配置1、为web应用指定授权文件。check到本地的为Linux授权，需修改为windows授权2、 reportFileHome为应用中模板文件存放的目录，需要将报表模板文件放到这里 3、 数据源的配置 dataSource iepip,oracle,1,utf-8,utf-8,0;在项目中没有使用这样的数据源。4.3开发报表应用4.3.1页面上的设置 见WEB-INFcontentbusinessfactory-inventory.jsp传递给报表的参数报表的输出设置，采用润乾的自定义标签report:html4.3.2处理Action 见ycpswebappactionbusinessBaseReportActionSupport.java和FactoryAction.java目前ycps工程中传递模板名称的方式是写死的，也就是说是保存在数据库中的见src/test/java/com/petrochina/dataInit/dataInit.xml第944行4.3.2浏览应用5附：Oracle存储过程5.1使用PL/SQL Dev开发存储过程大家参考SNS上的Oracle pl/sql简单介绍附：炼厂库存信息的存储过程/wlxm-ycps/docs/report/factory_inventory_pro.sql5.2使用PL/SQL Dev测试存储过程在过程名称上面右键菜单选择Test执行后，需要点击右边的按钮才能看到游标的输出结果Ok，测试完成如果想debug的话 可以采用这几个按钮来调试Ok了有未尽或不妥的地方，请指出或修改6. 遇到的错误a) 错误来源：InputStream cannot be null处理办法：打开 WEB-INF 下面的 reportConfig.xml 查找以下XML片断：在发布报表时，如果没有选择主义层文件，润乾会自动为你生成一个 /WEB-INF/demo.xml 的默认值，而这个文件根本不存在，所以才会报