商业分析工具FineBI中web页面嵌入式集成教程

1. web页面嵌入式集成

1.1 描述

FineBI是基于B/S架构的浏览器/服务器模式，现在用户开发的系统基本上趋向于B/S 架构的浏览器/服务器模式，因此完全可以直接采用web页面嵌入式集成的简易方式完成集成。通过集成，用户从自己的系统通过链节使用浏览器访问FineBI的服务器，从而在自己系统内调用BI的web页面，来实际嵌入式集成。这种集成通常会有两种方式：一种是直接使用URL链节，另一种方式是通过js的iframe框架来链节分析模板。下面先提供各部分的URL链接接口，再以BI分析模板为案例讲述两种集成方式。

2. 各部分URL链接

2.1 BI分析模板的URL链接

用户使用BI工具进行业务模板制作，最后将制作好的模板直接嵌入到自己的系统中，以节省项目开发周期，这是一种常见的使用场景，不同的分析模板会对应着不同的URL。FineBI的分析模板本身就是HTML5的页面，当用户系统平台是B/S构架的情况下，使用浏览器访问服务器，完成可以通过URL来访问这个纯HTML5的页面。这就是URL集成的基本原理。因此取得分析模板的URL即可。FineBI取分析模板的URL相当方便，如下

图：

取到的URL如下：

1.http://localhost:37799/WebReport/ReportServer?op=fr_bi&cmd=bi_init&

id=9&createby=-999#

注：此处取到的URL时候是查看的时候状态，在编辑状态也可通过这种方式取，编辑状态最后有参数标识即“&edit=_bi_edit_#”,使用此类URL可以继续进行该模板的编辑（组件、控件详细配置，页面布局等），当把这个标识去掉后，该模板就转到编辑状态了。

注：当前的URL是由“布署路径”+“接口”；其中“布署路径”通常为

http://localhost:端口号/工程名/ReportServer，“接口”为

1.?op=fr_bi&cmd=bi_init&id=9&createby=-999#

以下均相同，不再赘述。

2.2 创建业务包

FineBI创建业务包是在管理系统>BI数据源配置选项中进行的，BI数据源配置的URL 链接为：

1.http://localhost:37799/WebReport/ReportServer?op=fr_bi_configure&c

md=init_configure_pane

效果查看

启动tomcat服务器，地址栏中输入创建业务包API接口

http://localhost:37799/WebReport/ReportServer?op=fr_bi_configure&cmd=in it_configure_pane，如果还没登录系统，则要先跳转到op=fs系统的登录界面，登陆成功之后，再回到创建业务包界面，如下图：

注：创建业务包页面需要权限才能访问，一般为管理员，非管理员如果没有权限则不能打开页面，如果要使非管理员拥有创建业务包的权限，首先得给非管理员配置BI数据源的使用权限，详细权限分配过程请查看权限配置与查看，创建业务包界面可以分配业务包的使用权限，业务包权限设置请查看业务包权限分配。

2.3 新建分析

业务包创建好之后，就可以在新建分析页面添加即时分析了，新建分析URL链接如下：

1.http://localhost:37799/WebReport/ReportServer?op=fr_bi_dezi&cmd=ini

t_dezi_pane

?效果查看

在浏览器地址栏中输入

http://localhost:37799/WebReport/ReportServer?op=fr_bi_dezi&cmd=init_de zi_pane，即可打开新建分析页面，如下图：

2.4 我创建的

我创建的是指当前用户创建的所有即时分析都会显示在我创建的列表中，URL链接API接口如下：

1.http://localhost:37799/WebReport/ReportServer?op=fr_bi_dezi&cmd=my_

bi_saved

?效果查看

在新建分析页面新建2个分析模板，在浏览器地址栏中输入

http://localhost:37799/WebReport/ReportServer?op=fr_bi_dezi&cmd=my_bi_

saved，即可看到所有分析模板的列表：

2.5 分享给我的

分享给我的是指其他用户将即时分析分享给当前用户，该即时分析就会显示在分享给我的目录中，URL链接如下：

1.http://localhost:37799/WebReport/ReportServer?op=fr_bi_dezi&cmd=my_

bi_shared

注：由于管理员账户不能分享分析模板，所以只有非管理员账号才拥有分享给我的目录列表，如果管理员账号打开分享给我的目录列表，其显示为空。

效果查看

用非管理员账号Anna登录系统，创建2个即时分析BITest1和BITest2，根据BI即时分析的分享中的操作，在我创建的页面中将这两个即时分析分享给Cherry，退出系统，在浏览器地址栏中输入

http://localhost:37799/WebReport/ReportServer?op=fr_bi_dezi&cmd=my_bi_

shared，用Cherry的账号登录，可以通过接口在浏览器中直接看到分享给我的即时分析列表，如下图：

2.6 所有模板

所有模板是管理员专属的界面，可以查看整个平台上所有用户做出来的模板，监控整个平台数据使用及模板制作情况，对可将模板挂在平台节点。其url接口如下：

1.http://localhost:37799/WebReport/ReportServer?op=fr_bi_dezi&cmd=bi_

all_template

注：由于只有管理员账户有“所有模板”的界面，所以只有管理员账号登录才能看到所有模板，如果非管理员账号打开分享给所有模板，其显示为空。

效果查看

2.7 报表管理目录url

除了可以通过输入模板id返回模板信息外，我们还可以通过接

口?op=fs_main&cmd=module_getrootreports&id=-1获取到报表管理目录的url。

?效果查看

2.8 全局更新

Cube全局更新，顾名思义，是指Cube中的数据全部都更新一遍，包括所有业务包中的所有的表和字段；除了在我们数据配置界面点击进行更新外，还开了相应的接

口?op=fr_bi_configure&cmd=set_cube_generate，以便于直接集成到自己的系统中进行全局更新操作。URL访问地址如下：

1.http://localhost:37799/WebReport/ReportServer?op=fr_bi_configure&cm

d=set_cube_generate

?效果查看

在浏览器地址栏输入上述URL后访问可以登录数据决策平台-数据配置-cube更新或者打开tomcat后台，可以看到cube在进行全局更新，如下图所示：