quiee报表工具部署总结
一. 下载并安装快逸报表软件工具
先安装 JDK,还有Tomcat 相关的配置步骤,相信难倒不少人.
使用快逸报表版本为4.2.20,JDK1.5,Tomcat 6.0.
二. 报表设计
(1)关于授权
打开报表设计器,如果提示授权的话,你可以到安装目录下找到,笔者安装在了C盘, 所以目录如下C:\ProgramFiles\quieeReport\webapps\quiee\WEB-INF\classes 可以看到相关的授权.
(2)配置数据源
打开设计器之后, 安装后打开报表设计器，选择配置－数据源－新建－关系数据库，开始配置数据源,笔者用的是mysql,以mysql举例:
其中关键位置如下:
数据源名称要记住,因为在部署的时候,配置数据库时名字要和这保持一致.数据库类型选择相应的类型,数据源URL默认不是本机,需要修改,当然如果在其他机器上需要填写相应的IP地址,后面填写相应的数据库名字.下面填写数据用户名和密码.完成之后回到数据源窗口,选择刚创建的数据源,点击连接,数据源变色说明连接成功。.关闭窗口.
(3)配置数据集创建报表
选择文件－新建报表，打开新建报表向导，填写数据源，下一步
注意数据源的名字也要保持一致,点击 下一步,按着提示进行下一步就可以, 最后点击生成网格报表,报表就生成了.
报表的表头可以修改为中文
完成之后,启动快逸报表的服务,将报表保存发布.
四个图标左边第三个是进行发布的,点击会提示进行保存报表,按提示进行保存.之后可以点击IE图标进行预览.
三. 在J2EE中部署快逸报表
在已有的 J2EE 项目中使用刚才创建的报表，需要如下步骤：
(1) 导入 jar 包和相关文件
(a)将快逸报表安装目录\quieeReport\webapps\quiee\WEB-INF\lib中的 jar 包导入项目,并且导入所需要的mysql驱动包.
(b)将\quieeReport\webapps\quiee\WEB-INF 目录下的 reportConfig.xml,runqianReport4.tld,runqianReportLog.properties 复制到项目的 WEB-INF 目录
(c)将\quieeReport\webapps\quiee 目录下的 j2re-1_4_1-windows-i586-i.exe,Myerror.jsp,myInputError.jsp, runqianReport4Applet.jar 和 images 目录复制到项目的 WebRoot 目录下。
(2) 修改web.xml文件
在 web.xml 文件中增加如下内容：
<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-mapping>
<servlet-name>reportServlet</servlet-name>
<url-pattern>/reportServlet</url-pattern>
</servlet-mapping>
(3) 创建jsp文件
可以直接使用\quieeReport\webapps\quiee\reportJsp目录下的 showReport.jsp和 toolbar.jsp
文件。其中 showReport.jsp 用于显示报表，toolbar.jsp 用于显示工具按钮。
(4) 在项目中导入报表文件
在上面发布报表的路径下找到报表文件,将生成的.raq 报表文件导入项目。
(5) 添加授权文件
复制quieeReport\webapps\quiee\WEB-INF\classes目录下的授权文件,根据使用的操作系统进行选择,
到项目的 WebRoot 目录, 可能需要修改 reportConfig.xml 文件中的部分内容.
如果你用的不是window系统,更改成与您对应的授权的文件.特别注意的是”/”反斜杠符号 ,拷贝过来的文件里原本是没有的
(6) 修改reportConfig.xml文件
在其中添加如下配置内容,主要用于数据库的连接,需要主要的地方是name参数,需要跟报表文件的数据源名称一致.
<!-- 配置快逸加载数据时候的datasource。非常关键。
<jdbc-ds-configs>
<jdbc-ds-config>
<name>mysql</name>
<db-type>mysql</db-type>
<connection-url>
jdbc:mysql://localhost:3306/test
</connection-url>
<driver-class>com.mysql.jdbc.Driver</driver-class>
<user-name>root</user-name>
<password>123</password>
<db-charset>GBK</db-charset>
<client-charset>GBK</client-charset>
<extend-properties></extend-properties>
</jdbc-ds-config>
</jdbc-ds-configs>
注意的地方:
这个地方一定要和制作报表时候的数据源名字一致,
(7) 访问报表
发布上述 J2EE 项目，启动 tomcat，访问报表的 url 地址
为：
项目名称/reportJsp/showReport.jsp?raq=/报表名称.raq
在网页上设置好请求路径，就可以对拥有该报表的jsp进行访问了。
Oh, YE 可以成功访问读取数据库了！