蓝凌EKP集成(新版)

1.1 版本

1.2 应用场景

帆软平台与蓝凌EKP应用集成，实现报表链接单点登录和平台用户组织架构同步。

注：1. 帆软平台需安装 【开放平台插件】和 【蓝凌EKP集成(新版)插件】两个插件包；蓝凌EKP平台需要有帆软集成模块功能（具体可联系蓝凌咨询）

2. 蓝凌EKP目前支持集成的版本：v16，其他版本集成需联系蓝凌咨询

3. 帆软版本支持 v10 和 v11

4. 兼容说明：旧版本蓝凌集成插件对接蓝凌EKP旧的帆软集成模块，升级新版本插件后，蓝凌侧需同步升级到新的帆软集成模块；帆软中新旧两个蓝凌插件不要同时安装，升级时先删除旧插件包，再安装新版本插件。

1.3 功能描述

支持功能明细：

• 报表链接集成至蓝凌平台后，访问实现单点登录

• 蓝凌平台用户组织架构同步至帆软平台，同步模式包含全量同步（首次）和增量同步，同步信息包含【用户、部门、岗位】

注：1. 蓝凌中的部门、机构在帆软中都会映射为部门；蓝凌中部门禁用增量同步后帆软中会将部门删除 

2. 同步内容不包含帆软中的角色

3. 全量同步前需先清空下帆软平台中用户、部门和岗位信息，避免出现重名报错导致同步失败（可通过导入、同步数据集方式清空架构）

4. 现版本同步逻辑岗位暂不包含岗位，位于部门岗位下的用户目前均直接挂到部门下，等后续蓝凌优化后可包含岗位同步，并会将原始挂载至部门下用户移动至部门岗位下

2.1 插件安装

点击下载插件：开放平台插件  蓝凌EKP集成(新版)插件

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

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

2.2 操作方法

2.2.1 帆软平台配置

1）单点属性配置

管理员登录平台，打开菜单到：【管理系统】-【系统管理】-【常规】-【蓝凌EKP集成（新版）配置】，配置说明如下：

 【蓝凌认证地址】
示例 http://host/api/third-finereport/sysOrg/getUserInfoByToken，其中 host 为蓝凌服务器实际地址
 【账号认证开关】
该开关控制在向蓝凌认证地址请求时是否携带用户、密码信息，开启后【账号认证用户】和【账号认证密码】需要配置，配置值同蓝凌侧（蓝凌配置流程参考 2.2.2_1)）
 【账号认证用户】
认证地址请求时携带的用户名参数，配置值同蓝凌侧（蓝凌配置流程参考 2.2.2_1)）
 【账号认证密码】
认证地址请求时携带的用户名密码，配置值同蓝凌侧（蓝凌配置流程参考 2.2.2_1)）
 【报表平台地址】
示例 http://host/webroot/decision，其中 host 为帆软工程地址，一般场景不需要填写，当经过nginx转发后不能正确获取报表地址时可配置该选项

2）开放平台应用配置

参考 开放平台插件帮助文档 新建应用并配置分组权限，用于蓝凌侧同步组织架构

 【新建应用】

  【应用权限配置】应用新建完成手动开启下所有分组的权限

 【同步配置】应用新建完成后需复制下应用id和秘钥，用于记录到蓝凌平台

3）安全设置

管理员登录平台，打开菜单到：【管理系统】-【安全管理】，关闭 【点击劫持攻击保护】 

2.2.2 蓝凌平台配置

1）单点属性配置

打开蓝凌ekp管理后台-【集成管理】-【Restservice服务】，对帆软报表集成单点服务进行访问策略设置，设置帐号密码

 【访问控制策略】
同帆软2.2.1_1）中 【账号认证开关】
 【登录账号】
同帆软2.2.1_1）中 【账号认证用户】
 【登录密码】
同帆软2.2.1_1）中 【账号认证密码】
 【可访问的REST服务】
需勾选 帆软报表集成单点服务

2）集成属性配置

打开蓝凌ekp管理后台-【集成管理】-【报表集成】-【帆软报表集成】，配置参数说明如下

 【蓝凌插件版本】
选择 蓝凌EKP集成（新版）
 【帆软系统地址】
示例 http://IP:port/webroot/decision/，其中 IP:port 为帆软服务器实际地址和端口。
 【应用ID】
复制从帆软2.2.1_2）中应用 id
 【密钥】
复制从帆软2.2.1_2）中应用密钥
 【重名岗位处理】
因为帆软系统中，职位不允许重名，如果ekp存在重名岗位，则同步会出现问题。
启用该开关同步时，以“岗位名称”+“岗位ID”作为职位名称同步到帆软系统中，绕开帆软中职位重名的限制。
 【全量同步】
帆软平台组织架构清空后，可点击全量同步按钮进行初始化信息同步。
 【增量同步】
可编辑设置每天定时同步时间点，也可以通过点击增量同步按钮手动触发增量同步。

3）报表权限配置

打开蓝凌ekp管理后台-【组织权限管理】-【权限管理】-【角色分配】，给用户/部门分配帆软报表集成的权限。

该权限不配置，用户在访问集成链接时会提示无应用权限。

3.1 组织架构同步

以上步骤配置完成后，可在 2.2.2_2) 页面点击全量同步按钮 、增量同步按钮。

注：1. 全量同步前最好把蓝凌和帆软日志级别都修改为 debug，若同步过程出错，基于日志文件便于定位问题原因

2. 点击全量同步后蓝凌页面会提示 loading 动画，若同步时间较长，页面可能会报错 500 超时，该提示可忽略，不影响后台实际同步动作，待蓝凌侧优化

3. 增量同步结果可在蓝凌定时任务中查看执行结果

3.2 查看报表链接

配置完成后，打开蓝凌ekp管理后台-【集成管理】-【报表集成】-【帆软报表集成】-【报表链接生成器】

选中某张报表，可以直接看到报表的相对路径，此路径可配置到蓝凌门户中；绝对路径可在蓝凌已登录时，免登录直接访问帆软报表。

3.3 报表门户展示

操作步骤示例如下，详情可参考蓝凌帮助文档。