API嵌入集成1.1说明FineBI是基于B/S架构的浏览器/服务器模型，现在用户开发的系统基本都倾向于B/S架构的浏览器/服务器模型，所以有些页面可以直接使用网页嵌入集成的简单方式集成。还有一些因为框架的原因，可以通过调用json来集成。通过集成，用户在自己的系统中使用浏览器通过链接访问FineBI的服务器，从而在自己的系统中调用BI的网页进行实际的嵌入式集成。这种集成通常有两种方式：一种是直接使用url链接，另一种是通过js调用json获取解析模板。下面先提供各部分的URL链接接口，以及json格式的API1.2API插件。FineBI各种接口的开放都是以插件的形式实现的，同时通过插件实现跨域集成。因此，在集成前，FineBI系统中必须先安装API插件。下载后，在BI管理系统的插件管理中，选择本地安装。安装完成后，重启BI服务器。PublicAPI2.1登录API登录API接口为?op=api&cmd=bi_login&bi_username=name&bi_password=password&callback=myfunction其中bi_username=name和bi_password=password中的name和password为用户名和密码。该接口可以返回“登录成功”，如下图所示：注：当前URL由“部署路径”+“接口”组成；其中“部署路径”一般为http://localhost:端口号/项目名称/ReportServer，“接口”为?op=fr_bi&cmd=bi_init&id=9&createby=-999#以下同理，不再赘述。2.2模板解析(1)URL接口单体模板解析通常集成到门户网站中，集成模板解析API可以直接使用URL，使用iframe框架进行集成。它的URL可以直接在浏览器的控制台中找到。下面简单介绍一下控制台搜索的方法。按F12打开控制台，使用选择器，点击右上角，可以跳转到界面框；如图：从frame中查找即可找到url，iframe的src值为url(2)参数其API的格式为?op=fr_bi&cmd=bi_init&id=templateid&createBy=creatorid.2.3新分析API新分析?op=api&cmd=add_report&reportName=NewReport，其中repoartName为参数，NewReport为新分析的名称。在浏览器上访问这个API，返回值为“reportId”2.4我创建的（1）接口是指当前用户创建的所有即时分析都会显示在我创建的列表中，URL链接API接口如下如下：?op=api&cmd=get_page_created_by_me，效果如下：(2)JSON返回值我创建的API？op=fr_bi&cmd=get_folder_report_list返回当前登录用户在浏览器上创建的模板分析（包括文件夹和模板）的详细信息），其中还包括模板的共享信息。仅限非管理员API3.1共享模板共享模板是指其他用户与当前用户共享实时分析。注意：共享模板功能只有非管理员才能使用，所以只能在非管理员界面使用。3.2分享给我分享给我是非管理员独有的，是非管理员之间共享模板后放置共享模板的文件目录。其API接口?op=api&cmd=get_shared_to_me_reports，通过该接口可以获取当前用户所有共享模板的信息。3.3共享模板当然，某个模板已经共享给不同的人，也可以通过API获取。API是?op=api&cmd=get_shared_users_by_report&createdBy=TemplateCreatorID&reportId=TemplateID，通过这个API可以得到这个ID的模板分享给了谁。参数是：createByID和reportid。注：模板ID和创建者ID可以通过当前人创建的API获取。只有管??理员可以使用API4.1所有模板在管理员界面，管理员可以通过“所有模板”管理全平台所有用户设计的模板分析。4.1.1接口接口的API为?op=api&cmd=get_page_all_reports效果如下：4.1.2JSONJSON格式的API为?op=api&cmd=get_all_template_4_admin，返回值为所有模板信息。4.2整合所有用户信息时，当用户想获取用户、部门职位、角色等所有信息时，可以通过API接口返回json值获取。API?op=api&cmd=get_all_reports_data，如下图所示：4.3报表管理目录除了通过输入模板id返回模板信息外，我们还可以通过接口获取报表管理目录的url?op=fs_main&cmd=module_getrootreports&id=-1。4.4数据配置界面数据配置是BI数据管理的核心界面，即业务包的管理界面。目前我们的业务包管理接口可以直接通过URL进行集成。它的API是?op=fr_bi_configure&cmd=init_configure_pane，效果如下：4.5全局更新Cube全局更新顾名思义就是更新Cube中的所有数据，包括所有业务包中的所有表和字段？op=api&cmd=update_cube，这样就可以直接集成到自己的系统中进行全局的更新操作。返回值的结果为：function({"result":"globalcube更新成功！"});注意：在url后面加上&bi_username=用户名&bi_password=password，实现免登录全局更新。4.6单表更新单表更新，顾名思义，就是更新cube时，单独更新其中一张表，其他表不更新。除了在“单表更新设置”中更新外，FineBI还开放了相应的接口?op=api&cmd=update_cube&packageName=业务包名&tableName=escapename，方便直接集成到自己的系统中进行单表更新操作。URL访问地址如下：注意：(1)当只有packageName时，更新当前业务包中的所有表。（2）在url后添加&bi_username=用户名&bi_password=password，无需登录即可更新单表。（3）这里的单表更新默认是全量更新，不进行增量更新。4.7单个模板详情管理员可以通过单个模板的模板ID和创建者ID获取当前模板的详细信息。它的API是?op=api&cmd=get_template_by_ids&ids=[{reportId:1,createBy:-999}]。总结1.FineBI操作细分四部分：创建业务包，创建新分析，我创建，分享给我。一般来说，只有创建业务包是管理员操作，其他三个都是非管理员操作，所以在使用API??进行集成时，要注意创建只有管理员才能看到的业务包API链接节点。如果其他用户可见，则用户登录系统后，点击该节点不会有任何反应。如果一定要给其他用户创建业务包的权限。首先，您需要授予用户配置BI数据源的权限。2、以上所有接口中的${servletURL}表示http://localhost:端口号/项目名/ReportServer。如果用户系统和FineBI在同一个系统，可以使用FR.ServletURL获取。如果FineBI也是用户系统，那么可以直接使用${servletURL}，否则需要写绝对路径。
