水晶报表文档

1  环境部署
1.1       水晶报表插件

现在我搭建的水晶报表的开发环境是eclipse，首先，我们要下载水晶报表的插件，下载地址是：

http://diamond.businessobjects.com/node/450

其中上面有三种插件：

·                               Download All-in-one Installation 是带有Crystal Reports插件的eclipse3.2完整版; （现在使用）

·                               Download Crystal Reports for Eclipse Runtime - Manual Installation 这是纯Crystal Reports插件;(建议)

·                               Download and Install Crystal Reports for Eclipse via the Update Manager 通过eclipse的更新来安装CR4E;
1.2       水晶报表的设计

（1）新建一个crystal report web project

（2）新建一个blank report

（3）空报表创建完成后，就进入了报表设计界面，首先，连接数据库，在batabase explore面板新建一个连接，依次填入下面的内容：

     选择相应的数据库（如：Oracal 9）；

     Connection Name：可填可不填；

     Databasebase：要连接的数据库的名称；

     JDBC driver class：（如：oracle.jdbc.driver.OracleDriver）

     Class location：（如：载入classes12.jar）

     Connection URL：（如：jdbc:oracle:thin:@10.16.11.252:1521:obd）

     User information：填入用户名和密码；

     最后完成。

（4）设计报表：设计界面由四个面板Layout，Formulas，Data，Preview。

     Layout:设计界面，Formulas：公式设计界面，Data：数据表的存放界面，Preview：预览界面。

在batabase explore面板里选择添加的表，拖到Data面板内。要插入字段右击该字段选择insert，可以进行ctrl和shift操作。

（5）报表的其他详细的设计细节不在本文档中详细介绍。
1.3        水晶报表的web部署

第一种方法傻瓜式水晶报表的jsp显示:

创建好报表后，直接右击水晶报表crystal report——〉create viewer jsp自动生成代码。

第二种自定义报表源式：

1.   将一个指向查看器标记库描述符文件的引用添加到 JSP 页面的顶部。同时必须确保相应的 JAR 文件和附加支持文件都存在。

         <%@ import="com.crystaldecisions.reports.sdk.ReportClientDocument">

         <%@ taglib uri="/crystal-tags-reportviewer.tld" prefix="crviewer" %>

         注意：    可以为 prefix 属性指定任何名称。prefix 确定要使用什么标记前缀来访问标记库的标记。

       2.  创建报表源，设置报表源的属性，把报表源缓存于session变量中（必需的）

           <%
                final String reportName="rpt/Sample.rpt";
                ReportClientDocument crDoc = new ReportClientDocument();
                crDoc.open(reportName,0);
                crDoc.getDatabaseController().logon("sa","");
                session.setAttribute("reportSource",crDoc.getReportSource());
          %>

          注意：如果viewer标记的reportSourceVar属性的默认值是crystalReportSource，如果用这个做session变量的名称，那可以不用设置reportSourceVar。

      3.   创建一个开始 viewer 标记。在此标记中，指定查看器名称和报表源的类型。

            <crviewer:viewer viewerName="CrystalViewer" reportSourceType="pageServer" reportSourceVar="reportSource">

       4.  结束 viewer 标记。 JSP 页面现在即可查看名为 Sample的报表。

           </crviewer:viewer>