1. 概述
1.1 版本
| BI 服务器版本 | 功能变更 |
|---|---|
| 5.1 | - |
1.2 问题描述
FineBI工程未集成FineReport工程的情况下，如何挂载/使用FineReport模板呢？
1.3 解决思路
有两种使用场景：
1）将FineReport模板直接挂载到FineBI工程目录中展示。
2）将FineReport模板通过仪表板的 Web 组件链接展示。
注：若FineBI工程和FineReport工程互通，也可在FineBI工程目录直接挂载FineReport模板的超链，本文不赘述此情况。
2. 示例一：挂载到目录中
本章示例：在FineBI系统目录中，展示FineReport模板「段落明细表」。
2.1 上传FineReport模板
将FineReport模板「段落明细表」拷贝到%FineBI%\webapps\webroot\WEB-INF\reportlets目录下，如下图所示：
2.2 设置数据连接
在FineBI系统中，需要新增一个数据连接，和FineReport模板「段落明细表」用到的数据连接完全一致，命名也必须完全相同。
管理员登录FineBI系统，点击「管理系统>数据连接>数据连接管理」，点击「新建数据连接」，新建一个和「段落明细表」用到的数据连接完全一致的数据连接。
2.3 新增目录
管理员登录FineBI系统，点击「管理系统>目录管理」，选择想要挂出的对应目录后，点击「添加模板」，如下图所示：
进入模板设置界面，此时页面即显示当前工程中的所有 FineReport 模板，选择FineReport模板「段落明细表」，点击「下一步」。
设置挂出模板的名称、描述、类型等，点击「确定」，FineReport模板「段落明细表」即发布成功。如下图所示：
注：如模板预览类型为填报，FineBI工程必须购买了「数据录入」功能点，否则无法进行填报。详情请参见：注册管理 。
2.4 效果预览
打开目录，刷新，左侧目录树中显示刚刚添加的FineReport模板「段落明细表」，如下图所示：
3. 示例二：在组件中引用
本章示例：在FineBI的Web组件中，展示FineReport模板「段落明细表」。
3.1 上传FineReport模板
将FineReport模板「段落明细表」拷贝到%FineBI%\webapps\webroot\WEB-INF\reportlets目录下，如下图所示：
3.2 设置数据连接
在FineBI系统中，需要新增一个数据连接，和FineReport模板「段落明细表」用到的数据连接完全一致，命名也必须完全相同。
管理员登录FineBI系统，点击「管理系统>数据连接>数据连接管理」，点击「新建数据连接」，新建一个和「段落明细表」用到的数据连接完全一致的数据连接。
3.3 新建仪表板
用户登录FineBI系统，点击「仪表板>新建仪表板」。如下图所示：
在仪表板编辑界面，点击「其他>Web组件」，添加一个Web 组件。如下图所示：
为该 Web 组件添加超链接，对应 FineReport 仪表板的链接为：/webroot/decision/view/report?viewlet=xxxxx.cpt
xxxxx.cpt 对应为该模板保存在 reportlets 文件夹中的 cpt 文件名称。
比如 FineReport模板 cpt 文件为「段落明细表.cpt」，则该模板的链接就是/webroot/decision/view/report?viewlet=段落明细表.cpt。如下图所示：
若 cpt 文件位于 reportlets 下一级文件夹，例如模板段落明细表位于..\webapps\webroot\WEB-INF\reportlets\test，则链接形式为/webroot/decision/view/report?viewlet=test/段落明细表.cpt；
若添加填报报表，则需在链接添加后缀&op=write。例如供应商信息查询为填报报表，则链接形式为/webroot/decision/view/report?viewlet=供应商信息查询.cpt&op=write；
若需要添加的报表A中添加了超链接，且链接至另一报表B，如下图，供应商信息查询报表中添加了超链接，链接模板为折线图模板，且地址位于..\reportlets\demo\chart；
3.4 效果预览
保存仪表板，预览即可在该仪表板的Web组件中查看到FineReport模板「段落明细表」，如下图所示：
4. 注意事项
若模板不存放在当前FineBI工程中，而是在其他工程中。
当前工程以目录超链/Web组件超链调用其他工程的模板时，必须要关闭模板所在工程的「管理系统>安全管理>安全防护>Security Headers」的「点击劫持攻击防护」。
详情请参见：安全防护
