润乾报表V4技术资料

润乾数据分析管理系统(DAMS)的应用包reportmis/WEB-INF/下的文件reportConfig.xml是DAMS主要的参数配置文件。当DAMS部署到不同的操作系统、应用服务器、更新文件、授权文件及性能优化等都要修改此文件，下面具体介绍一下该文件中的内容。

1、reportConfig.xml文件的内容

<?xml version=”1.0″ encoding=”GBK” ?>
<reportConfig>
<config>
<name>license</name>
<value>/WEB-INF/server-windows-v4.lic</value>
</config>
<config>
<name>reportFileHome</name>
<value>/reportFiles</value>
</config>
<config>
<name>semanticsFile</name>
<value>/WEB-INF/demo.xml</value>
</config>
<config>
<name>JNDIPrefix</name>
<value>java:comp/env</value>
</config>
<config>
<name>dataSource</name>
<value>trade,sqlsvr,gbk;</value>
</config>
<config>
<name>cachedParamsTimeout</name>
<value>120</value>
</config>
<config>
<name>cachedReportDir</name>
<value>E:\work\report\cached</value>
</config>
<config>
<name>cachedIdPrefix</name>
<value>A</value>
</config>
<config>
<name>cachedReportTimeout</name>
<value>120</value>
</config>
<config>
<name>logConfig</name>
<value>/WEB-INF/runqianReportLog.properties</value>
</config>
<config>
<name>jspCharset</name>
<value>GBK</value>
</config>
<config>
<name>maxConcurrentForReport</name>
<value>9999</value>
</config>
<config>
<name>maxWaitForReport</name>
<value>9999</value>
</config>
<config>
<name>maxWaitTimeForReport</name>
<value>9999</value>
</config>
<config>
<name>appUrlPrefix</name>
<value></value>
</config>
<config>
<name>alwaysReloadDefine</name>
<value>yes</value>
</config>
<config>
<name>treeImagesPath</name>
<value>/images/treeimages</value>
</config>
<config>
<name>errorPage</name>
<value>/myErrorPage.jsp</value>
</config>
<config>
<name>maxCellNum</name>
<value>100000</value>
</config>
<config>
<name>jreInstallName</name>
<value>/j2re-1_5_1-windows-i586-i.exe#Version=1,5,1,0</value>
</config>
<config>
<name>jreVersion</name>
<value>1.5</value>
</config>
</reportConfig>

2、参数说明

(1) license表示润乾公司提供的授权文件名及其路径，可以是绝对文件路径；也可以是相对于WEB应用根目录的相对路径（此时要以”/”开头）；或者是位于WEB应用类路径上的一个授权文件名（此时只要写出文件名即可）。

(2) reportFileHome表示编辑好的报表文件在应用中存放的位置，其值可相对于WEB应用根目录；也可是绝对路径，分隔符用”/”表示，如d:/myReport/web/reportFiles。

(3) semanticsFile表示报表系统使用的文件，路径相对于WEB应用根目录。

(4) JNDIPrefix表示查找数据源时的环境串前缀，在不同的WEB服务器中不同，如Tomcat中是java:/comp/env，而Weblogic和Websphere中均不需要，可以不填。

(5) dataSource表示用户在WEB应用中要用到的数据源配置。

说明：

• 数据源的JNDI名称,数据库类型[,取数时是否需要转换编码,数据库字符集编码,显示报表时的字符集编码][,SQL是否需要转码];[重复]……
• 数据库类型按下表填写：

• 数据库中使用的字符集编码，一般为GBK或iso-8859-1。
• SQL是否需要转码：有些数据库的字符集不是中文的，如果在执行的SQL语句中带有中文时，就会执行不正确。配置之前可以做一个简单的数据集为中文SQL的报表测试一下，如果执行结果不对，那么就需要设置此参数。参数值为1，表示要转码，为0或不设此参数值表示不需要转码，如：jdbc/test,oracle;exercise,sqlsvr,1,iso8859-1,GBK,0;……。
• 第一个数据源配置为应用中的缺省数据源，即如果在报表的数据集定义中没有指定数据源名称，则使用此数据源。

(6) cachedParamsTimeout表示提交给报表的参数在缓存中保存的时间，以分钟为单位。如果不设此参数，缺省值是120分。

(7) cachedReportDir表示报表缓存的文件夹，如在unix系统中，用户应对此文件夹有写的权限，并根据报表的数量和访问量的大小以及缓存超时的时间，分配一个合理的空间大小。如果不设此参数或设置错误，则采用JDK默认的临时文件夹。

(8) cachedIdPrefix表示报表缓存的前缀。

cachedIdPrefix生成报表缓存号时的前缀串，只有在集群环境中并且多台服务器共享一个报表缓存目录时才需要设置。

(9) cachedReportTimeout表示报表缓存保存的时间，以分钟为单位。如果不设此参数，缺省值是120分。此值应根据实际内存大小、缓存文件夹空间大小来调节，一般在1－3小时之间。

(10) logConfig表示报表系统日志记录配置属性文件。如果不设此参数，则日志输出到系统控制台。日志属性文件的配置说明请参照runqianReportLog.properties文件中的说明，或者参考apache的log4j的相关文档。

(11) jspCharset表示报表应用中的JSP页面的字符集，缺省值是GBK。

(12) maxConcurrentForReport表示报表WEB应用中服务器可以同时计算的报表的个数，以便有效控制服务器的内存使用量。

(13) maxWaitForReport表示报表WEB应用中服务器可以等待计算的报表的个数，以便有效控制服务器的内存使用量。

(14) maxWaitTimeForReport表示报表等待计算的最大时间，以秒为单位。

(15) appUrlPrefix表示访问报表时的URL中WEB服务器地址、端口及WEB应用名组成的一个串，如http://192.168.0.1:8080/myWebApp。一般不用设置，程序可以自动拼出此串。但有时访问申请经过了服务器的多重转发，造成拼出来的串不对时，需要设置此值。

(16) alwaysReloadDefine是否每次都重新读取报表定义,如设为yes,则不能享受性能管理提供的缓存功能可以在应用开发测试阶段设为yes，以免报表定义改动以后，网页访问报表不能及时刷新但应用正式上线以后，应将其设为no。此时如果修改了报表定义, 应访问refreshReport.jsp来刷新相应的报表定义及其缓存。

(17) treeImagesPath可配置下拉树的图片路径。

(18) errorPage增加一个WEB应用全局配置errorPage，用来指定tag中的exceptionPage和inputExceptionPage的缺省值。

(19) maxCellNum 当前报表系统能运算的最大单元格数，能够动态控制并发数。

(20) jreInstallName 客户端使用打印applet的时候，如果没有安装jre环境，会自动根据该项配置到应用根目录下查找jre文件下载并安装。

(21) jreVersion jre安装包的版本。