快逸报表工具

此文档适用对象： 1 初次接触润乾报表，又想快速了解润乾部署集成的工程师；

2 某些项目的招投标文件中需要写入润乾报表部署的文档；

此文档可与”润乾报表在 J2EE 下的部署 “文档结合使用

一 润乾软件文件

runqian-v4.5.5-install.exe 是润乾软件的安装文件

Designer2012-12-31V4.0.lic 复杂报表设计" target="_blank" class="quieeLink1">设计器使用的授权

Server2012-12-31V4.0Windows.lic 引擎在 windows 操作系统下使用的授权

Server2012-12-31V4.0Linux.lic 引擎在 linux 操作系统下使用的授权

Server2012-12-31V4.0Other.lic 引擎在 unix 操作系统下使用的授权

二 安装润乾软件

1 demo 目录结构

双击安装文件，默认安装，一直到完成，安装完后，会生成如下目录结构：

C:\Program Files (x86)\reportHome\webapps\demo

reportFiles 放置报表文件的目录

reportJsp 放置 jsp 文件的目录

WEB-INF 规定目录，放置应用配置文件、类包等

2 WEB-INF 的目录结构

C:\Program Files (x86)\reportHome\webapps\demo\WEB-INF

classes 放置 java 类文件、授权文件

将第一节中的 4 个授权文件拷贝到此文件夹下

lib 放置 jar 文件

lib 下的 jar 包

3 两个重要的配置文件

reportConfig.xml

web.xml

3.1 reportConfig.xml 文件里的主要内容：

<?xml version=”1.0″ encoding=”UTF-8″ ?>

<reportConfig>

<config>

<name>logConfig</name>

<value>/WEB-INF/runqianReportLog.properties</value>

</config>

<config>

<name>license</name>

<value>runqianWindowServer.lic</value>

</config>

<config>

<name>reportFileHome</name>

<value>/reportFiles</value>

</config>

<config>

<name>semanticsFile</name>

<value>/WEB-INF/runqianSemanticFile.xml</value>

</config>

<config>

<name>JNDIPrefix</name>

<value>java:comp/env</value>

</config>

<config>

<name>dataSource</name>

<value></value>

</config>

注释

（ 1 ）

<config>

<name>license</name>

<value>runqianWindowServer.lic</value>

</config>

这个配置项，配置的就是授权文件的名称，将 runqianWindowServer.lic 修改成授权文件的名称就可以了，在此例里，是修改为： Server2012-12-31V4.0Windows.lic

（ 2 ）

<config>

<name>JNDIPrefix</name>

<value>java:comp/env</value>

</config>

Jndi 环境串前缀，不同的应用服务器前缀不同（比如： tomcat 的前缀为： java:/comp/env ； weblogic 则不需要，将这个配置项的 value 值置空就可以）

（ 3 ）

<config>

<name>dataSource</name>

<value></value>

</config>

数据源 jndi 的名称，与应用服务器（比如： weblogic ）里配置的 jndi 一致就可以了

3.2 web.xml 文件里的内容：

<?xml version=”1.0″ encoding=”UTF-8″ ?>

<!DOCTYPE web-app PUBLIC “-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN” “http://java.sun.com/dtd/web-app_2_3.dtd”>

<web-app>

<servlet>

<servlet-name>SetContextServlet</servlet-name>

<servlet-class>com.runqian.util.webutil.SetContextServlet</servlet-class>

<load-on-startup>2</load-on-startup>

</servlet>

<servlet>

<servlet-name>reportServlet</servlet-name>

<servlet-class>com.runqian.report4.view.ReportServlet</servlet-class>

<init-param>

<param-name>configFile</param-name>

<param-value>/WEB-INF/reportConfig.xml</param-value>

</init-param>

<load-on-startup>1</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>

</web-app>

三 部署润乾软件

1 开发好的报表文件放置在 reportFiles 文件夹

2 页面文件放置在 reportJsp 文件夹

3 授权文件放置在 classes 文件夹

4 reportConfig.xml 文件中的授权配置项修改一致

将上面 4 项工作做好了，就可以直接打 war 包了

打好 war 包，就可以直接部署到应用服务器上去了

（此例中 ，比如是 weblogic 服务器，则按照 weblogic 部署 java 应用的方法直接部署了）

四 嵌入其他软件，与其他软件一起部署

润乾报表也可以嵌入其他软件中，与其他软件一起部署

从第二节的目录结构中，可以看出，润乾报表的 demo 目录，是一个典型的 web 应用的目录结构，其他软件的目录结构也是 web 应用目录结构，则只需要将润乾报表的相应文件拷贝到其他软件的相对应的目录结构中就可以了，下面来拷贝相应的文件

（为了方便理解，在这里，将其他软件的应用名称取作 app ，润乾的应用叫 demo ）

1 将 demo 下的 reportFiles 文件夹拷贝到 app 下

2 将 demo 下的 reportJsp 文件夹拷贝到 app 下

3 将 demo 下的 runqianReport4Applet.jar 文件拷贝到 app 下

4 将 demo 下的 j2re-1_4_1-windows-i586-i.exe 文件拷贝到 app 下

5 因为 app 下也有 WEB-INF 目录，所以，这个目录就不需要拷贝了，只需要将其里面的文件拷贝过去

6 将 demo\WEB-INF\classes 下的授权文件拷贝到 app\WEB-INF\classes 下

7 将 demo\WEB-INF\lib 下的 jar 包拷贝到 app\WEB-INF\lib 下

8 将 demo\WEB-INF\ 下的 reportConfig.xml 文件拷贝到 app\WEB-INF\ 下（授权文件的名称修改一致）

9 将 demo\WEB-INF\ 下的 web.xml 文件的内容中的配置项内容复制到 app\WEB-INF\web.xml 中（因为 app 应用中，也有 web.xml 文件，所以，只是从 demo 中的 web.xml 中复制配置项的内容到 app 应用中的 web.xml 中就可以了）

到此，就将润乾软件与其他软件嵌入好了，直接将 app 应用打包，部署到应用服务器（比如： weblogic ）上就可以了

五 永久授权说明

第一节中讲到的 4 个授权文件，指的是开发时使用的授权文件，它都是有时间限制的，在它限制的时间期内有效（比如： Server2012-12-31V4.0Windows.lic ，这个授权在 2012 年 12 月 31 日之前有效），正式服务器中需要用润乾的永久授权

1 永久授权是什么？

永久授权是运行润乾报表的带有机器特征码的没有时间限制的正式授权文件

2 机器特征码是什么？

机器特征码是为了制作永久授权，由润乾公司提供程序从用户的服务器上获取硬件和操作系统信息，生成的一个数字串，将这个数字串制作在永久授权中，这样就绑定了授权与服务器。

3 永久授权怎么获取？

先是用户准备好了服务器（硬件，软件都装好后，稳定使用的），再由润乾公司提供一个程序，运行这个程序得到一个数字串，润乾公司根据这个数字串，会重新制作一个绑定了这串数字串的授权（既为永久授权），再将这个授权发给用户，用户将这个授权拷贝到应用中的 classes 文件夹下，修改 reportConfig.xml 文件中的授权配置项的文件名，重新打包发布就可以了。