reportConfig.xml
reportConfig.xml
关于润表的参数设置，请打开文件(WEB-INF/reportConfig.xml)。内容如下：
<?xml version="1.0" encoding="GBK" ?>
<config>
<name>logConfig</name>
<value>/WEB-INF/runqianReportLog.properties</value>
</config>
<config>
<name>license</name>
<value>/WEB-INF/server-formal-windows.dat</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>
<!-- 这个值是tomcat服务器用的，大多数服务器不需要 -->
</config>
<config>
<name>dataSource</name>
<value>jdbc/test,oracle;exercise,sqlsvr,1,iso8859-1,GBK,0</value>
</config>
<config>
<name>jspCharset</name>
<value>GBK</value>
</config>
<config>
<name>cachedParamsTimeout</name>
<value>120</value>
</config>
<config>
<name>cachedReportDir</name>
<value></value>
</config>
<config>
<name>cachedIdPrefix</name>
<value>A</value>
</config>
<config>
<name>cachedReportTimeout</name>
<value>120</value>
</config>
<config>
<name>maxCellNum</name>
<value></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>windir</name>
<value></value>
</config>
<config>
<name>alwaysReloadDefine</name>
<value>no</value>
</config>
<config>
<name>treeImagesPath</name>
<value></value>
</config>
<config>
<name>errorPage</name>
<value></value>
</config>
<config>
<name>webServerType</name>
<value></value>
</config>
<config>
<name>jreInstallName</name>
<value></value>
</config>
<config>
<name>jreVersion</name>
<value></value>
</config>
<config>
<name>clusterMember</name>
<value></value>
</config>
<config>
<name>isCachedFileShared</name>
<value></value>
</config>
<config>
<name>olapGraphProfile</name>
<value></value>
</config>
<config>
<name>olapDir</name>
<value></value>
</config>
<config>
<name>picFileExistTime</name>
<value></value>
</config>
<config>
<name>wrapInchingWidth</name>
<value>1</value>
</config>
<config>
<name>wrapByChar</name>
<value>yes</value>
</config>
<!-- 配置文件中第一个配置为即时报表的主配置 -->
<jdbc-ds-configs>
<jdbc-ds-config>
<name>test1</name>
<db-type>2</db-type>
<connection-url>jdbc:JTurbo://192.168.0.6/demo/charset=GBK</connection-url>
<driver-class>com.newatlanta.jturbo.driver.Driver</driver-class>
<user-name>sa</user-name>
<password>wanqiong</password>
<db-charset>GBK</db-charset>
<client-charset>GBK</client-charset>
<extend-properties></extend-properties> |
</jdbc-ds-config>
</jdbc-ds-configs>
以上参数说明如下：
(1) logConfig表示报表系统日志记录配置属性文件。如果不设此参数，则日志输出到系统控制台。日志属性文件的配置说明请参照runqianReportLog.properties文件中的说明，或者参考apache的log4j的相关文档。
(2) license表示润乾公司提供的授权文件名及其路径，可以是绝对文件路径；也可以是相对于WEB应用根目录的相对路径（此时要以“/”开头）；或者是位于WEB应用类路径上的一个授权文件名（此时只要写出文件名即可）。
(3) reportFileHome表示编辑好的报表文件在应用中存放的位置，其值可相对于WEB应用根目录；也可是绝对路径，分隔符用“/”表示，如d:/myReport/web/reportFiles。
(4) semanticsFile表示报表系统使用的语义层文件，路径相对于WEB应用根目录。
(5) JNDIPrefix表示查找数据源时的环境串前缀，在不同的WEB服务器中不同，如Tomcat中是java:/comp/env，而Weblogic和Websphere中均不需要，可以不填。
(6) dataSource表示用户在WEB应用中要用到的数据源配置，其格式如下：
数据源的JNDI名称,数据库类型[,取数时是否需要转换编码,数据库字符集编码,显示报表时的字符集编码][,SQL是否需要转码];[重复]……
数据库类型按下表填写：
注：上表中不存在的数据库类型,参数值都写为写unknown。
数据库中使用的字符集编码，一般为GBK或iso-8859-1。
SQL是否需要转码：有些数据库的字符集不是中文的，如果在执行的SQL语句中带有中文时，就会执行不正确。配置之前可以做一个简单的数据集为中文SQL的报表测试一下，如果执行结果不对，那么就需要设置此参数。参数值为1，表示要转码，为0或不设此参数值表示不需要转码。如：
jdbc/test,oracle;exercise,sqlsvr,1,iso8859-1,GBK,0;……
第一个数据源配置为应用中的缺省数据源，即如果在报表的数据集定义中没有指定数据源名称，则使用此数据源。
(7) jspCharset表示报表应用中的JSP页面的字符集，缺省值是GBK
(8) cachedParamsTimeout表示提交给报表的参数在缓存中保存的时间，以分钟为单位。如果不设此参数，缺省值是120分
(9) cachedReportDir表示报表缓存的文件夹，如在unix系统中，用户应对此文件夹有写的权限，并根据报表的数量和访问量的大小以及缓存超时的时间，分配一个合理的空间大小。如果不设此参数或设置错误，则采用JDK默认的临时文件夹。
(10) cachedIdPrefix表示报表缓存的前缀。cachedIdPrefix生成报表缓存号时的前缀串，只有在集群环境中并且多台服务器共享一个报表缓存目录时才需要设置。
(11) cachedReportTimeout表示报表缓存保存的时间，以分钟为单位。如果不设此参数，缺省值是120分。此值应根据实际内存大小、缓存文件夹空间大小来调节，一般在1－3小时之间。
(12) maxCellNum 当前报表系统能运算的最大单元格数，能够动态控制并发数。该数值的大小取决于硬件的配置，一般来说内存越大，这些数值可以设得越大，但最多建议不要超过2000000。
(13) maxConcurrentForReport表示报表WEB应用中服务器可以同时计算的报表的个数，以便有效控制服务器的内存使用量。该数值的大小取决于硬件的配置，一般来说内存越大，这些数值可以设得越大，但最多建议不要超过100。
(14) maxWaitForReport表示报表WEB应用中服务器可以等待计算的报表的个数，以便有效控制服务器的内存使用量。该数值的大小取决于硬件的配置，一般来说内存越大，这个数值可以设得越大，但最多建议不要超过100。
(15) maxWaitTimeForReport表示内存溢出后，最长等待多久才允许新任务访问，以秒为单位，一般建议为30。
(16) appUrlPrefix表示访问报表时的URL中WEB服务器地址、端口及WEB应用名组成的一个串，如http://192.168.0.1:8080/myWebApp。一般不用设置，程序可以自动拼出此串。但有时访问申请经过了服务器的多重转发，造成拼出来的串不对时，需要设置此值。特殊情况：如果出现多台机器集群或者内外网多个IP等情况，可能导致最终拼出来的ip不正确，又不能指定死ip，此时可以用/APPMAP来配置。
(17) windir windows的安装目录，用于解决在oracle服务器中取特征码为负的问题，经过测试发现特征码为负的原因是找不到windows安装路径。
(18) alwaysReloadDefine是否每次都重新读取报表定义,如设为yes,则不能享受性能管理提供的缓存功能可以在应用开发测试阶段设为yes,以免报表定义改动以后,网页访问报表不能及时刷新但应用正式上线以后,应将其设为no. 此时如果修改了报表定义, 应访问refreshReport.jsp来刷新相应的报表定义及其缓存。
(19) treeImagesPath可配置下拉树的图片路径。
(20) errorPage增加一个WEB应用全局配置errorPage，用来指定tag中的exceptionPage和inputExceptionPage的缺省值。
(21) webServerType 应用服务器的类型。
(22) jreInstallName 客户端使用打印applet的时候，如果没有安装jre环境，会自动根据该项配置到应用根目录下查找jre文件下载并安装。
(23) jreVersion jre安装包的版本。
(24) clusterMember 集群时用于配置缓存机器和缓存端口号，目的用于实现集群主机之间的缓存同步。
(25) isCachedFileShared 配置是否共享缓存目录，目的用于实现集群主机之间的缓存同步。
(26) olapGraphProfile表示olap统计图属性配置文件，路径相对于reportFileHome。
(27) olapDir表示olap统计图页面的图片存放路径，相对应用根目录，默认放在olap文件夹下，与olap统计图页面有关的图片是olapGraph_hover.gif，olapGraph_F5.gif，olapGraph_bg.gif。
(28) picFileExistTime表示缓存目录下图片文件的过期时间，时间单位为分钟，如果不设此参数，缺省值是60分。参数名均为大小写相关，用户必须根据自己应用的实际情况填写相应的参数值。
(29)wrapInchingWidth表示换行单元格两边的留空值，取值为0或正整数，单位为象素。默认值是5
(30)wrapByChar表示自动换行方式，取值为yes或no，yes表示可在任意字符处换行，no表示按一定规则换行。缺省值为no
参数名均为大小写相关，用户必须根据自己应用的实际情况填写相应的参数值。