【IT168 技术文档】StyleReport的服务器引擎是通过两个Servlet来实现的，要保证引擎可以正常运行，必须要有以下必要条件：

1、  必须要将其部署到含有servlet container的应用服务器或WEB服务器上；

2、  StyleReport的核心Jar包（正式版为sree_pro.jar和etools.jar；Lite版为sree_lite.jar和etools.jar）要被配置到应用服务器的CLASSPATH中；

3、确保引擎可以找到StyleReport的配置文件，StyleReport是通过其全局变量sree.home去找配置文件的，sree.home是一个路径，引擎运行需要的配置文件一定要存放到这个路径下；这个全局变量在部署引擎servlet的时候以初始化参数的形式指定，如果没有指定，系统将默认将其指定到应用目录的WEB-INF/classes；

4、做好的报表文件，也需要传递到服务器上，并将保存这些文件的路径配置到应用服务器的CLASSPATH中，这样才能保证系统会找到这些文件；或者直接放到应用的WEB-INF\classes下，因为这个路径已经默认配置到CLASSPATH中了。

一、如何配置引擎的servlet：

与标准的servlet配置一样，在WEB-INF目录下的web.xml中配置StyleReport的servlet，配置洋例如下：  

<?xml version="1.0" encoding="UTF-8"?>

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

<web-app>

       <servlet>

              <servlet-name>replets</servlet-name>

              <servlet-class>inetsoft.sree.web.ServletRepository</servlet-class>

                 <init-param>

     <param-name>sree.home</param-name>

     <param-value>

        C:\bea812\App\sree\WEB-INF\classes

     </param-value>

  </init-param>

       </servlet>

       <servlet>

              <servlet-name>manager</servlet-name>

              <servlet-class>inetsoft.sree.adm.AdmServlet</servlet-class>

                 <init-param>

     <param-name>sree.home</param-name>

     <param-value>

        C:\bea812\App\sree\WEB-INF\classes

     </param-value>

  </init-param>

       </servlet>



       <servlet-mapping>

          <servlet-name>replets</servlet-name>

          <url-pattern>/Examples</url-pattern>

       </servlet-mapping>

       <servlet-mapping>

          <servlet-name>manager</servlet-name>

          <url-pattern>/EnterpriseManager</url-pattern>

       </servlet-mapping>







    <welcome-file-list>

      <welcome-file>index.jsp</welcome-file>

      <welcome-file>index.wml</welcome-file>

      <welcome-file>index.html</welcome-file>

    </welcome-file-list>



    <taglib>

      <taglib-uri>sree.tld</taglib-uri>

      <taglib-location>/WEB-INF/lib/sree_pro.jar</taglib-location>

    </taglib>



</web-app>

    如上例，在配置两个servlet的时候，在init-param中指定了其sree.home，也就是说，当前servlet运行时需要的配置文件要存放在目录‘C:\bea812\App\sree\WEB-INF\classes’中。

sree.home目录里包含了一个特定报表库的一系列配置文件。两个最重要的配置文件是：

 n         Sree.properties —包含了特定报表库的配置信息。在这个文件里的路径都要使用绝对路径，或者使用相对于sree.home的路径，可以使用环境变量，例如$(sree.home)\repository.xml。

 n         Repsository.xml —包含了报表库的逻辑结构的XML规范

 其它的配置文件有：

n         Schedule.xml—包含了计划任务配置信息的XML规范
n         Datasource.xml—定义了报表应用所用的数据源的配置信息的XML规范
n         Query.xml—定义了与特定数据源有关的查询的XML规范
n         Sree.log—Style Report/企业版服务器的日志事件文本，纯文本文件
n         Stylereport.srl—存放公有Script函数、bean、table style以及report conponent

1、  WebLogic

1）  新建一个应用目录，如sree，其下层目录包括WEB-INF/classes和WEB-INF/lib；

2）  将StyleReport的核心Jar包拷贝到sree/WEB-INF/lib下；

3）  在WEB-INF/web.xml中配置引擎servlet，配置方法见本文第一节；

4）  将相关配置文件从‘StyleReport安装目录/Tomcat/webapps/sree/WEB-INF/classes’下拷贝到’sree.home’下；

5）  在weblogic的console中部署这个应用目录；

6）  通过以下URL访问报表引擎：

http://host:port/sree/EnterpriseManager

http://host:port/sree/Examples

    7) 使用URL访问单独一个报表：

       http://host:port/sree/Examples?op=replet&name=reportname&outtype=REPORT

       其中的参数：

       op：     这个参数的值不用改变，动态报表replet；archive报表report

       name：  这个参数的值为实际的报表名字，要包括folder名，比如在名为demo的

folder下加了一个报表名为reportDemo，则给这个参数要传的参数为：

demo/reportDemo

       outtype：这个参数是报表的显示类型，正常显示要传递REPORT，如果要显示为

PDF，则值为PDF，显示EXCEL，则值为XSL，即此参数值为相应类型

的扩展名。

2、  Tomcat

1）在%TOMCAT_HOME%\webapps中创建一个目录，如'sree',并在server.xml中配置这个应用，然后在这个目录下创建：

%TOMCAT_HOME%\webapps\sree\WEB-INF

%TOMCAT_HOME%\webapps\sree\WEB-INF\classes

%TOMCAT_HOME%\webapps\sree\lib

   将StyleReport的三个jar包（在安装目录的lib下）拷贝到%TOMCAT_HOME%\webapps\sree\lib下，如果需要连数据库，也要将其驱动拷贝到此；

2）在WEB-INF/web.xml中配置引擎servlet，配置方法见本文第一节；

3）启动引擎以及访问报表同上。

StyleReport部署好了以后，接下来介绍可视化设计器的使用：