润乾报表嵌入了内置的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.7.3-jdk8.jar,驱动存放位置为:[安装根目录]\common\jdbc,用户可以根据实际需要自己放置对应的驱动。
第四步:通过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"
ql="select * from employee"
/>
第五步:访问多维分析页面
访问test.jsp,展现多维分析页面时会将Tag标签中定义的SQL数据集默认作为初始数据集,直接将结果集以明细的形式展现在页面中。