润乾报表V4技术资料

在接触到的很多项目实际应用中，部署润乾V4都是使用润乾V4设计器自带的WEB发布向导，直接生成webRoot目录，然后将该目录下的所有文件COPY到项目目录下，然后修改web.xml文件和reportconfig.xml文件。

在最新版本的V4.5.2报表中，使用纯WEB发布方式发布的WebRoot中，包括的文件少了很多，包括默认的showReport.jsp,web.xml,reportconfig.xml文件，都没有在其中。

这个webroot包是不能直接放入J2EE服务器下部署的，同时根据客户的实际情况，有一些文件可以无需保留，一些配置可以再加以修改，从而达到集成部署的最小化和最优化的效果

首先我们来看下4.5.2报表中纯WEB发布包的结构，WEBROOT下包括1个WEB-INF文件夹，两个JAR包，一个可执行的JRE环境文件。

如果用户没有用到集算器功能，则无需使用dmGraphApplet.jar文件，该文件可以删除。

runqianReport4Applet.jar和j2re-1_4_1-windows-i586-i.exe是润乾的客户端打印必须使用的APPLET程序和JRE环境，建议保留。

再来看WEB-INF目录。其结构为CLASSES目录，LIB目录，runqianDm.tld，runqianDMLog.properties，runqianReport4.tld和runqianReportLog.properties文件。

如果没有用到集算器功能，则可删除runqianDm.tld和runqianDMLog.properties，这两个文件分别是集算器的自定义标签和集算器的日志文件配置。

runqianReportLog.properties文件中，找到log4j.logger.runqianReportLogger=DEBUG,LOG1,LOG2该行，根据部署的测试环境和正式环境区别，可修改日志等级，一般情况下，在正式环境上部署，其日志级别最低至少应该为WARN级别，建议为ERROR级别，这样就可以避免大量正常运行信息的生成，便于故障排查和日子维护。

在LIB文件夹中，可看到dm.jar和dmgraph.jar两个文件，一个是集算器用到的JAR包，一个是集算器统计图用到的JAR包，如果用户没有用到集算器功能，则可删除这两个JAR包。

在CLASSES目录中包括CONFIG目录和授权，在CONFIG中的color.properties文件建议保留，如果用户在设计器内修改了统计图的配色方案，则需要将设计器内的配色方案COPY到该目录下，使之保持一致。

如果没有用到自定义函数，则customFunctions.properties文件无需保留。

这个WEB包目前还是不能运行的，还缺少WEB.xml reportconfig.xml 一个展示报表的JSP页面，一个放置报表模板的目录和其下的模板文件。

Reportconfig.xml中的节点配置文档中有，我不在赘述，WEB.xml中的配置如下：

<servlet>
<servlet-name>reportServlet</servlet-name>
<servlet-class>com.runqian.util.webutil.SetContextServlet</servlet-class>
<init-param>
<param-name>configFile</param-name>
<param-value>/WEB-INF/reportConfig.xml</param-value>
</init-param>
<load-on-startup>2</load-on-startup>
</servlet>
<servlet>
<servlet-name>DMServlet</servlet-name>
<servlet-class>com.raq.web.view.DMServlet</servlet-class>
<init-param>
<param-name>configFile</param-name>
<param-value>/WEB-INF/dmConfig.xml</param-value>
</init-param>
<load-on-startup>10</load-on-startup>
</servlet>

<servlet-mapping>
<servlet-name>reportServlet</servlet-name>
<url-pattern>/reportServlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>DMServlet</servlet-name>
<url-pattern>/DMServlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>DMServlet</servlet-name>
<url-pattern>/DMServletAjax</url-pattern>
</servlet-mapping>

<taglib>
<taglib-uri>/WEB-INF/runqianReport4.tld</taglib-uri>
<taglib-location>/WEB-INF/runqianReport4.tld</taglib-location>
</taglib>

其中红色的部分为集算器的配置，如果项目中未使用集算器，则红色部分可以删除。

展现报表的页面设计为index.jsp，在showReport.jsp的基础上可以做如下修改：
1、 去除嵌入的工具条JSP。
2、 在报表标签部分，删除ERRORPAGE的处理，在appletJarName属性中，去掉计算器打印的JAR包，其结果如下：

<report:html name=”report1″ reportFileName=”<%=report%>”
funcBarLocation=”top”
needPageMark=”yes”
generateParamForm=”no”
params=”<%=param.toString()%>”
appletJarName=”runqianReport4Applet.jar”
needPrint=”yes”

最后，如果客户需要FLASH统计图，需要将设计器下DEMO目录中的flashGraph目录COPY到WEBROOT目录下。

经过上述步骤获得的发布包，应该就是最精简的润乾V4发布WEBROOT了。