快速集成
润乾报表嵌入了内置的TOMCAT，并且安装完成后产品已经将查询分析的WEB目录集成到了demo应用中，用户可直接使用内置的应用，也可将多维分析部署在自己独立的应用中。如使用内置的多维分析，则可忽略本小节。
多维分析部署集成只需简单几步即可搞定！
第一步：创建WEB应用目录
第二步：将查询分析使用的内容集成到WEB应用中
润乾报表安装后，自带的demo应用路径为【安装根目录】\report\web\webapps\demo，需将demo应用中的如下内容全部集成到WEB应用中。
|
raqsoft |
必须的目录，目录名不可以调整 |
|
|
jre-6u24-windows-i586.exe |
jre的安装包，客户端打印时如果检测到没有安装java环境，会自动下载此包，适合windows操作系统 |
|
|
raqsoftReportApplet.jar |
打印的applet包 |
|
|
raqsoft.cer |
applet打印签名证书 |
|
|
WEB-INF |
必须的目录，放置应用配置文件和jar |
|
|
web.xml |
配置servlet |
|
|
classes |
类路径 |
|
|
raqsoftConfig.xml |
报表的核心配置文件 |
|
|
raqsoftInput.tld |
填报报表Tag标签 |
|
|
raqsoftReport.tld |
报表Tag标签 |
|
|
raqsoftAnalyse.tld |
分析控件的Tag标签 |
|
|
raqsoftQuery.tld |
查询控件的Tag标签 |
|
|
raqsoftReportLog.properties |
配置润乾报表的日志文件路径、日志输出信息级别 |
|
|
lib |
WEB应用所需引用的jar包 |
|
《程序员参考》WEB应用配置小节中介绍了demo应用发布目录中的所有文件目录结构及用途，如有需要可做进一步查阅。
特别需要注意的：所有文件中只有web.xml文件不能拷贝，而是打开润乾报表的web.xml文件，把其中的内容拷贝到您的web.xml文件中。其内容在web.xml中的顺序，要遵从相关应用服务器的规定。如果不是和已有应用集成，而是新建应用，那么直接拷贝web.xml也无妨。
第三步：配置授权文件和查询分析所使用的数据源信息。
打开[WEB应用根目录]/WEB-INF/raqsoftConfig.xml文件，配置授权和数据源信息。内容如下所示（蓝色字体为需要配置的内容）：
<?xml version="1.0" encoding="UTF-8"?>
<Config Version="1">
<Runtime >
//配置应用需要用的数据源
<DBList>
<!--数据库类型编号，编号依次代表的数据库类型为：[UNKNOWN:0; ORACLE:1; SQLSVR:2; SYBASE:3; SQLANY:4; INFMIX:5; FOXPRO:6; ACCESS:7; FOXBAS:8; DB2:9; MYSQL:10; KINGBASE:11; DERBY:12; HSQL:13; TERADATA:14; POSTGRES:15; DATALOGIC:16; IMPALA:17; ESSBASE:101;] -->
<DB name="dqldemo">
<!--由于xml文件中不允许出现&等特殊字符，因此如果url的value值中需包含&等特殊字符时，则需先将特殊符号进行转义，如先将&写成"&"，再写入文件中-->
<property name="url" value="jdbc:hsqldb:hsql://127.0.0.1/reportdemo" />
<property name="driver" value="org.hsqldb.jdbcDriver" />
<property name="type" value="13" />
<property name="user" value="sa" />
<property name="password" />
… …
</DB>
… …
</DBList>
… …
//集算器选项配置
<Esproc>… …</Esproc>
//报表选项配置
<Report>
<!--设置报表授权，可为相对路径，相对路径前面不需要加斜杠”/”-->
<license> </license>
… …
</Report>
… …
</Config>
注意：连接数据源时需将对应的数据库驱动包放在能够加载到的类路径下。润乾报表WEB应用中自带的demo数据源所连的内置数据库类型为HSQL，驱动为hsqldb-2.2.8.jar，驱动存放位置为：【安装根目录】\common\jdbc，该目录下默认带有Oracle、MySQL、SQL Server等常用类型数据库驱动，用户可以根据实际需要自己放置对应的驱动。
第四步：通过Tag标签发布多维分析
新建Test.jsp文件，此步以添加SQL数据集为例，介绍多维分析Tag标签的使用：
在jsp中定义Tag标签的属性及其值，用Tag标签完成多维分析的解析及运算，按用户配置的属性要求将HTML文件流输出到客户端。
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib uri="/WEB-INF/raqsoftAnalyse.tld" prefix="raqsoft" %>
<raqsoft:analysev2
dataSource="dqldemo" //指定SQL需要使用的数据源
ql="select * from employee" //SQL语句
/>
第五步：访问多维分析页面
访问Test.jsp，展现多维分析页面时会将Tag标签中定义的SQL数据集默认作为初始数据集，直接将结果集以明细的形式展现在页面中。
