多产品连接工具插件

1.1 版本说明

1.2 应用场景

FineBI、FineReport、FineDataLink 分开部署时，需从不同入口进入平台进行操作，用户希望它们可联合登录，统一门户进行访问。

可通过安装「多产品连接工具」插件来实现，配置好后可以直接多平台切换，如下图所示：

2.1 插件安装

插件下载请点击：多产品连接工具

设计器插件安装方法请参见：设计器插件管理

服务器安装插件方法请参见：服务器插件管理

2.2 配置入口

插件安装后平台「管理系统」下会新增一个「产品连接」入口，点进去后可以配置多平台切换。

2.3 插件说明

• 在哪个平台配置插件，那个平台就作为主服务器，插件配置里连接的其他平台都是从服务器。

• 只能在 FineRpeort 或 FineBI 配置插件，也就是只有这两个能作为主服务器，FineDataLink 是不能作为主服务器去配置插件的。
  

• 该插件仅供超级管理员配置主从服务器，且主从服务器的超管账号需要相同，也就是这几个平台的超管用户名要一致，密码可以不一致。

• 无法将配置主从服务器的权限分配给普通用户，但普通用户可以正常切换平台。

• 普通用户切换时，必须保证这几个平台里都有该用户的用户名，这样用户登录工程后，才能正常切换平台。
  

• FineReport 和 FineBI 的集成平台也可以通过插件切换，集成介绍参见文档：BI&FR集成工程

• 插件配置时对工程并没有限制，可以任意搭配，例如：FR 为主服务器，BI 为从服务器；FR 为主服务器，FR 为从服务器；BI 为主服务器，FR 为从服务等等。

• 配置插件的平台作为主服务器，不支持配置自己作为从服务器，也就是不能自己连自己。

• 主服务器和从服务器需要关掉 安全防护 中的「点击劫持攻击防护」按钮和「内容嗅探攻击防护」按钮。

• 从服务器可以设置：Ajax 跨域异步单点登录、iframe跨域单点登录、参考 后台单点登录 文档设置的后台单点登录，不支持 CAS单点登录

• 从服务器地址只支持：http://ip:port/webroot/decision，不支持直接用  ip 访问的路径。

• 主从服务器使用协议需相同，只能 http 切换 http ，https 切换 https，http 和 https 不能互相切换，因为浏览器禁止 https 页面内生产 http 请求。

• 主从服务器不能跨大版本连接，必须保证都是 FineReport10.0 或 FineReport11.0 。

• 主从服务器如果配置了 nginx 转发，那 nginx.conf 中不要配置access-control-allow-Origin指定域，插件中已配置该项，nginx 如果再配置会导致重复，浏览器不允许重复配置。

• 主服务器用 ip 访问，然后安装插件进行主从服务器配置，此时从服务器中自动生成的主服务器地址就是 ip 访问的 URL 。配置完成后，主服务器只能用 ip 访问，然后去切换从服务器，主服务器不能使用域名访问再去切换从服务器。

• 从服务器不能配置 filter 单点拦截，否则切换平台将会失败。

• 从服务器不支持挂载主服务器的模板。

• 如果工程使用Tomcat中间件，请检查%Tomcat home%/conf目录下的web.xml里，是否存在<http-method>OPTIONS</http-method>，该语句会禁用OPTIONS请求，导致主从服务器间无法正常来回切换。请删除此句，并重启工程，方可正常使用该插件。

本文示例中，FineReport 本地工程作为主服务器，FineBI 本地工程和 FineDataLink 工程作为从服务器。

3.1 前期准备

1）本文示例准备的三个工程分别如下，且必须保证三个工程的超管用户名一致，密码可以不同。

• FineBI 本地工程

• FineReport 本地工程

• FineDataLink 工程
  

2）启动这三个工程，且这三个工程都安装了「多产品连接工具」插件。

3）从服务器 FineBI 和 FineDataLink 需要关闭「点击劫持攻击防护」按钮和「内容嗅探攻击防护」按钮。操作如下图所示：

4）若使用谷歌浏览器进入平台，需要关闭 samesite 属性，操作方法见文档：谷歌浏览器单点登录注意事项

3.2 连接从服务器

1）使用超级管理员帐号登录 FineReport 数据决策系统（主服务器），点击「管理系统>产品连接」，界面如下图所示：

2）点击「作为主服务器」按钮，开启插件配置功能，弹出的设置项中依次填写主服务器名称、FineBI 从服务器连接地址、FineBI 从服务器名称。

填写完后，点击右下角「测试连接并保存」按钮，出现“连接成功，已保存，刷新后生效”提示，即表示 FineBI 从服务器连接成功，如下图所示：

注：从服务器地址只支持 http://ip:port/webroot/decision 格式 ，不支持直接用  ip 访问的路径。

3）连接好的 FineBI 工程会显示在配置界面，且右侧提供了三个按钮，可以实现再次测试连接、重新编辑配置，删除该连接，如下图所示：

4）再点击「添加连接服务器」按钮，再新增一个从服务器连接，去连 FineDataLink 工程，如下图所示：

5）连接好的两个工程如下图所示：

3.3 切换平台

点击 FineReport 决策系统右上角的切换按钮，即可在几个平台之间进行切换，如下图所示：

注：从服务器不能配置 filter 单点拦截，否则切换平台将会失败。

3.4 加密说明

配置界面下方有个 AES加密KEY 功能，这个是连接时传输 AES 加密的种子，默认值为 16 位字符串，不可手动编辑，只能随机生成。

点击「随机生成并同步」按钮，将同步到从服务器上，且只能在主服务器生成，从服务器未提供「随机生成并同步」按钮。

4.1 挂载从服务器FR模板

如果从服务器中有 FineReport 工程，那么可以将该工程下的 FineReport 模板挂载到主服务器的目录下。具体操作方法如下：

1）点击「管理系统>目录管理>添加模板（来自从服务器）」，如下图所示：

2）可添加从服务器中的模板，添加模板具体步骤可参见文档：添加模板

需要注意以下几点：

• 模板参数类型不显示，默认字符串类型。
  

• 主服务器中点击「添加模板（来自从服务器）」按钮时，模板选择范围由从服务器中配置的 模板认证 决定。

• 主服务器中，目前只有目录管理节点可选择从服务器模板，其他地方不能选择。

• 主服务器有用户 a ，从服务器没有用户 a 。主服务器添加一个从服务器不需要认证的模板，用户 a 登录预览这个模板，会报错user not exist 。

• 如果要在 APP 上查看模板，必须同时更新 APP 和 H5 插件版本到 10.4.986 及之后版本才能实现。

4.2 挂载从服务器BI仪表板

如果从服务器有 BI 工程，那么 2.0 及以上版本的插件可以将 BI 仪表板挂载到主服务器的目录上去。具体操作方法如下：

1）保证主从服务器都是安装的 2.0 版本以上的插件，且从服务器必须有 BI 工程。

2）以主服务器为 FR 为例，点击决策系统的「管理系统>目录管理」选中某个目录点击「BI模板（来自从服务器）」，如下图所示：

3）选择 BI 服务器下的某张仪表板，如下图所示

4）设置模板这一步采用默认的即可，点击确定，如下图所示：

5）回到目录，可以看到仪表板已经挂载好了，点击可以直接查看：

挂载时需要注意两点：

• BI 仪表板是否有权限，取决于从服务器配置的模板认证权限，详情参见：模板认证

• 如果从服务器非 BI，则仪表板列表为空。

5.1 插件未安装

问题描述

主从服务器都是 Tomcat 服务器且插件都已安装的情况下，建立连接时提示弹窗内容：「连接异常，请检查连接服务器是否安装“FineBI与FineReport连接工具”插件」

解决方案

需要确认主服务器和从服务器的 %Tomcat_HOME%\conf\web.xml ，是否包含 <http-method>OPTIONS</http-method> 。

若包含此行命令，则删除此行命令，重启报表工程或 BI ，重新测试连接即可。