1. 第三方报表集成

1.1. 报表插件

1.1.1. 1.第三方登录信息配置

为了降低和现有代码的耦合,第三方报表集成一般以独立插件形式存在。通常情况下在开发环境把第三方报表对应的服务地址配置在该独立插件的配置文件中。以分析云报表的集成插件为例,配置如下:

这样在线上部署环境，我们就可以通过协同系统配置器动态修改这几个参数，如下:

1.1.2. 2.插件启动过程

①为了让第三方报表作为一个独立插件随着Spring容器启动，我们需要让Spring帮我们创建一个第三方报表的Bean，即在该插件的Manager配置文件中注册一个Bean指向第三方报表的实现类。如下:

该实现类需要同时实现两个接口

其中SystemInitializer为T1开发框架的标准系统初始化接口，initialize和destroy方法分别在系统启动和停止时调用(详细启动实现过程我们不必关心)

另一个ReportCategoryBinding接口为标准的报表分类适配接口,该接口定义了到目前为止OA侧支持的对第三方报表的各个操作，比如权限检测、报表绑定、报表解绑等。

②在系统启动时，BiInsideCategoryBinding实现类会自动创建第三方报表的管理员角色，并读取相关登录信息注入到当前环境备用。

1.2. 报表管理员角色分配

在步骤二中系统启动时创建了第三方报表的管理员角色之后，我们需要将该角色授权给对应的系统人员账号才可以在报表中心-->报表管理菜单下显示出第三方报表页面。

使用单位管理员账号登录OA系统修改对应的人员角色并保存，如下:

保存之后即可在报表中心—>报表管理菜单下看到第三方报表集成菜单。

1.3. 报表基础功能

通常情况下第三方报表集成页面包含报表绑定、解除绑定、移动至和授权这四个功能按钮。

1.3.1. 1.报表绑定

即建立OA侧和第三方报表系统两端的报表对应关系，点击“绑定”按钮时会调用第三方报表提供的报表数据查询接口将可以进行绑定的报表数据展示成树形结构备选。

第三方报表数据查询接口定义在BiInsideCategoryBinding的findSelectedTreeNodes方法中,根据不同系统自行调整接口URL地址及参数即可。

选择要进行绑定的报表之后点击确认按钮会产生该报表在两侧系统的对应关系及权限信息并记录到OA侧数据库(表vreport_record和表vreport_record_auth)。

1.3.2. 2.解除绑定

解除绑定即删除上述建立的两个系统中报表的对应关系及权限数据(表vreport_record和表vreport_record_auth)。

对应后台VReportManagerImpl.removeVReportRecord方法:

1.3.3. 3.移动至

即修改所选报表从当前报表分类修改为另一个报表分类。

对应后台VReportManagerImpl.updateReportCategory方法。

1.3.4. 4.授权

授权即给予OA侧指定人员在报表中心-报表分析菜单下查看该绑定报表的权限。

对应后台VReportManagerImpl.updateVReportAuth，在此要注意每次授权操作会将原来的权限信息删除，重新记录被授权的人员或部门信息(表vreport_record的auth字段和表vreport_record_auth)。

1.4. 报表自定义功能扩展

除了上述四个基本功能按钮之外，现有的集成接口还提供了扩展功能接口，实际开发过程中可根据需要按需扩展，仍以分析云报表为例：

假如我们需要在报表集成工具栏增加一个自定义的功能按钮(此处以点击按钮打开指定URL为例),则直接在BiInsideCategoryBinding实现类的getExtendFunctions方法中增加该按钮的定义即可，包括页面元素ID,按钮显示文字,样式,返回值等。

在打开BI分析云报表页面时前端控制器会取出该实现类中所有扩展功能，将自定义扩展按钮的定义传递到前台页面。

前台JS(otherReportHome.js)会根据自定义类型自动生成对应类型的功能按钮。

当然,扩展功能接口也可以在后台调用,比如在监听到人员分析员报表管理员角色变化时，将对应人员信息通知分析云。则我们只需在分析云集成实现类BiInsideCategoryBinding的getExtendFunctions方法中增加一个类型为RoleChgNotifyFunction的Function将接口调用逻辑复写即可。

调用时取出该实现类的所有扩展Function根据类型去匹配并调用。

其它扩展功能接口使用方法类似：

1.5. 报表外部REST接口

1.5.1. 1.第三方报表系统参数查询接口

①查询当前OA侧支持的系统参数(各个参数含义见附录)

请求说明：

请求参数：

应答参数：

请求示例

②查询指定系统参数(支持批量查询)

请求说明：

请求参数：

应答参数：

请求示例:

1.5.2. 2.判断人员是否有访问指定报表的权限

请求说明：

请求参数：

应答参数：

请求示例

1.5.3. 3.第三方报表绑定

请求说明：

请求参数：

应答参数：

请求示例:

1.5.4. 4.第三方报表解绑

请求说明：

请求参数：

应答参数：

调用示例:

1.5.5. 5.第三方报表授权

请求说明：

请求参数：

应答参数：

调用示例:

1.6. 附录

1.6.1. 1.系统条件参数字典