嵌入式报表部署指南

叙述事件经过

1、 描绘景象

2、 根据报表应用目录结构的相关说明，若需将报表部署至现有工程，应参照所示目录结构，将报表相关文件复制到对应的目录中。

3、 复制文件夹路径

4、 完整复制所有内容

5、 为简化操作，可直接将%FineReport_HOME%WebReportWEB-INF目录下的classes、lib、reportlets和resources四个文件夹复制到%Tomcat_HOME% webapps/jsp-examples/WEB-INF目录中，确保文件结构完整，避免路径错误，从而快速完成配置，提升部署效率，减少因环境差异导致的问题，保障系统正常运行。

6、 在集成您的项目时，%FineReport_HOME%WebReportWEB-INFclasses目录中存放的网络报表相关class文件不会产生冲突。该文件夹主要用于存储报表功能所需的编译类文件。如需了解网络报表的详细说明，可查阅二次开发文档中的相关内容，以获取更全面的技术支持与配置指导。

7、 部分复制，内容调整

8、 可选择仅将必要文件复制到现有工程中。

9、 需复制的文件清单

10、 fr-server-7.1.jar 包含报表服务全部功能，需复制到 WEB-INF/lib 目录中。

11、 fr-third-7.1.jar 是报表服务所需的第三方插件包，必须复制到项目的 WEB-INF/lib 目录中才能正常使用。

12、 reportlets 是 FineReport 服务器规定的专用文件夹，名称必须为小写且不可更改。该文件夹需置于 WEB-INF 目录下，其内部可创建子目录，所有报表模板（.cpt 文件）均须存放于 reportlets 及其子目录中，以确保系统正常识别与运行。

13、 resources 文件夹为 FineReport 服务器规定目录，名称必须小写且不可更改，用于存放报表服务器的配置信息，需将其复制到 WEB-INF 目录下。

14、 将上述文件或文件夹复制到现有应用目录中。

15、 可选复制的文件

16、 classes文件夹为应用服务器所规定，主要用于存放编译生成的.class文件。若对FineReport进行二次开发，例如实现自定义函数、程序数据源或网络报表等功能，需将编译后的类文件复制到此目录中，以确保系统能够正确加载和调用相关类。

17、 若报表通过JDBC连接数据库，需将相应的数据库驱动包（如Oracle的ojdbc14.jar）复制到WEB-INF/lib目录下，其他类型数据库亦应按此操作，确保驱动文件正确部署以支持数据连接与访问功能。

18、 调整web.xml配置文件内容

19、 在现有工程的web.xml文件中，增加对应的servlet及servlet-mapping配置项。

20、 将位于%FineReport_HOME%/WebReport/WEB-INF目录中的web.xml文件内指定内容，复制并粘贴至%Web_home%/webapps/Web工程名/WEB-INF路径下的web.xml文件中，需插入在所有servlet配置的末尾位置，确保配置正确生效。

21、 将上述代码复制并粘贴到指定目录的配置文件中，保存后效果如下所示。

22、 在web.xml配置文件中，元素的排列顺序具有严格要求，servlet的定义必须位于servlet-mapping之前。为确保配置正确并便于维护与程序调用，应将所有servlet声明集中放置在映射关系配置的前面，以满足解析顺序的需求。

23、 检查部署是否成功完成

24、 浏览报表可确认部署是否成功

25、 重启Tomcat后，打开浏览器并在地址栏中输入指定网址。

26、 访问地址 http://ip:服务器端口号/项目所在目录/ReportServer，若能顺利打开指定页面，说明 FineReport 已成功集成至 Web 应用，并在 Tomcat 服务器上部署完成。