发布时间 : 星期五 文章润乾报表V3.0在WEB中的使用说明更新完毕开始阅读d27ecb88680203d8ce2f249f
润乾报表(新版)在WEB中的使用说明
1 WEB服务器配置
使用本报表系统需要在WEB服务器中配置WEB应用和应用中用到的数据库连接池。下面以TOMCAT为例进行说明：
1、修改[tomcat]/conf/server.xml文件，在行之前插入如下的一段标签：
连接数据库的用户名 连接数据库的用户密码
数据库驱动程序类名
以上用粗体表示的部分为应进行修改的内容。
如果在应用中要用到多个数据库，则应重复
2、要将相应的数据库JDBC驱动程序包放入[tomcat]/common/lib目录中
2 WEB应用配置
2.1 文件部署
JAVA类的部署：如果报表系统提供的是jar文件，则将之放在WEB应用的WEB-INF/lib目录中，如果提供的是呈目录结构的class文件，则将com目录和color.properties文件放到WEB应用的WEB-INF/classes目录中。
将runqianReport.tld文件放到WEB应用的WEB-INF目录中。
将xrq_license.dat文件放到WEB应用的WEB-INF目录中。 将runqianReportApplet.jar文件放到WEB应用的根目录中。
将lib目录中的以下jar文件复制到WEB-INF\\lib目录中：itext_099.jar，iTextAsian.jar，
jai_codec.jar，jai_core.jar，jdom.jar，log4j_128.jar，poi.jar。
2.2 web.xml文件的配置
在web.xml文件中要对报表系统中用到的servlet和taglib进行配置，请将报表系统提供的web.xml文件中的内容复制到你的应用的web.xml文件中相应的位置。并对下面这段标签中的相关内容进行修改。
以上参数说明如下：
(1) reportFileHome表示编辑好的报表文件部署的文件夹位置，其值相对于WEB应用根
目录。
(2) JNDIPrefix表示查找数据源时的环境串前缀，在不同的WEB服务器中不同，如
Tomcat中是java:/comp/env，而Weblogic和Websphere中均不需要，可以不填。 (3) dataSource表示用户在WEB应用中要用到的数据源配置，其格式如下： 数据源的JNDI名称,数据库类型,数据库字符集编码;[重复]…… 数据库类型按下表填写： 数据库类型 参数值 数据库类型 参数值 数据库类型 oracle db2 sql server sybase oracle db2 sqlsvr sybase informix mysql sql anywhere foxprow infmix mysql sqlany foxpro foxbase access 参数值 foxbas access 数据库中使用的字符集编码，一般为gb2312或iso-8859-1。 第一个数据源配置为应用中的缺省数据源，即如果在报表的数据集定义中没有指定数据源名称，则使用此数据源。
(4) cachedParamsTimeout表示提交给报表的参数在缓存中保存的时间，以分钟为单位。
如果不设此参数，缺省值是120分。 (5) cachedReportDir表示报表缓存的文件夹，如在unix系统中，用户应对此文件夹有写
的权限，并根据报表的数量和访问量的大小以及缓存超时的时间，分配一个合理的空间大小。如果不设此参数或设置错误，则采用JDK默认的临时文件夹。 (6) cachedReportTimeout表示报表缓存保存的时间，以分钟为单位。如果不设此参数，
缺省值是120分。此值应根据实际内存大小、缓存文件夹空间大小来调节，一般在1－3小时之间。
(7) logConfig表示报表系统日志记录配置属性文件。如果不设此参数，则日志输出到系
统控制台。日志属性文件的配置说明请参照runqianReportLog.properties文件中的说明，或者参考apache的log4j的相关文档。 (8) certFile表示使用HTTPS协议访问报表时，服务器安全证书文件的位置。
参数名均为大小写相关，用户必须根据自己应用的实际情况填写相应的参数值。
2.3 报表缓存配置
本系统采用内存敏感型报表缓存设置，就是使用TAG标签发布报表时，将计算出的报表首先保存在内存中，当JAVA虚拟机发现内存余量会影响到系统的效率时，则会将某些缓存的报表从内存中转移到硬盘中我们指定的文件夹中，以释放出充裕的内存供系统使用。 报表缓存设置是用上一节的参数（5）和（6）来配置的。当缓存的报表超过保存时间没有被访问时，就会从缓冲池中清除，同时，如果它已被写入到硬盘中，那么也要从硬盘中删除此文件。应用服务器关闭时，缓冲池将不再存在，残留在硬盘中的文件将在应用服务器下次启动时被清除。
缓存的报表有什么作用呢？它可供在网页中翻页、打印、存为Excel、存为Pdf或填报提交时从缓冲池中提取已算好的报表，避免再计算一次。提取的过程是这样的：（1）缓存报表还在内存中，直接取出；（2）缓存报表已存到硬盘中，从硬盘中读取出来；（3）报表已被从缓冲池清除，如果TAG中用的是RAQ文件，则重新根据参数计算出一个新的报表，否则显示异常“与服务器的连接超时，请重新访问！”，要求用户刷新页面后再执行这些操作。
3 TAG及其属性说明
3.1 html报表
html报表在JSP文件中用
(属性名都是大小写相关，属性值必须放在双引号中) 属性名 是否必填 属性含义 属性取值 缺省值 浏览式报表和单表填报式报表的公共属性 name srcType reportFileName 是 否 否 报表在网页中的ID标识 报表源的类型 当报表源类型为file时，要发布的报表文件 当报表源类型为defineBean或符合变量命名规则的reportBean时，已保字符串，与保存报表无 存到request中的scale funcBarLocation separator generateParamForm connection params funcBarFontFace funcBarFontSize funcBarFontColor functionBarColor needSaveAsExcel needSaveAsPdf needPrint printLabel 否 否 否 否 否 否 否 否 否 否 否 否 否 否 bean的名称 报表缩放显示比例 源bean时的名称一致 实数 1.0 top 空格 no 无 符合变量命名规则的字符串，在本网页中无 应是唯一的 见注1 报表文件名 file 无 beanName 否 功能条的位置 top, bottom, both 各功能钮间的分隔符 html元素或文字 是否生成缺省报表参数及宏输入表单 yes或no 动态数据库连接配置 见注2 报表所需要的参数 功能条的字体 功能条的字体大小 功能条的字体颜色 功能条背景色 需要显示将报表存为Excel的功能钮吗 需要显示将报表存为PDF的功能钮吗 需要显示打印报表的功能钮吗 打印钮外观定义 见后“报表参数及宏无 输入”小节 字体名称 与html文件中定义字体大小相同 html文件中使用的颜色 html文件中使用的颜色 yes或no yes或no yes或no html元素或文字 宋体 13px black 无颜色 no no no 打印