1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 |
|---|---|
V10，V11 | V10.1.3 |
1.2 应用场景
帆软平台与蓝凌EKP应用集成，实现报表链接单点登录和平台用户组织架构同步。
注：1. 帆软平台需安装 【开放平台插件】和 【蓝凌EKP集成(新版)插件】两个插件包；蓝凌EKP平台需要有帆软集成模块功能（具体可联系蓝凌咨询）
2. 蓝凌EKP目前支持集成的版本：v16，其他版本集成需联系蓝凌咨询
3. 帆软版本支持 v10 和 v11
4. 兼容说明：旧版本蓝凌集成插件对接蓝凌EKP旧的帆软集成模块，升级新版本插件后，蓝凌侧需同步升级到新的帆软集成模块；帆软中新旧两个蓝凌插件不要同时安装，升级时先删除旧插件包，再安装新版本插件。
1.3 功能描述
支持功能明细：
报表链接集成至蓝凌平台后，访问实现单点登录
蓝凌平台用户组织架构同步至帆软平台，同步模式包含全量同步（首次）和增量同步，同步信息包含【用户、部门、岗位】
注：1. 蓝凌中的部门、机构在帆软中都会映射为部门；蓝凌中部门禁用增量同步后帆软中会将部门删除
2. 同步内容不包含帆软中的角色
3. 全量同步前需先清空下帆软平台中用户、部门和岗位信息，避免出现重名报错导致同步失败（可通过导入、同步数据集方式清空架构）
4. 现版本同步逻辑岗位暂不包含岗位，位于部门岗位下的用户目前均直接挂到部门下，等后续蓝凌优化后可包含岗位同步，并会将原始挂载至部门下用户移动至部门岗位下
2. 插件介绍
2.1 插件安装
点击下载插件：开放平台插件 蓝凌EKP集成(新版)插件
设计器插件安装方法请参见：设计器插件管理
服务器安装插件方法请参见：服务器插件管理
2.2 操作方法
2.2.1 帆软平台配置
1）单点属性配置
管理员登录平台，打开菜单到：【管理系统】-【系统管理】-【常规】-【蓝凌EKP集成（新版）配置】，配置说明如下：
【蓝凌认证地址】 示例 http://host(/ekp)/api/third-finereport/sysOrg/getUserInfoByToken，其中 host 为蓝凌服务器实际地址，/ekp 路径可实际测试接口状态码是否为 404，再看是否需要添加 【账号认证开关】 该开关控制在向蓝凌认证地址请求时是否携带用户、密码信息，开启后【账号认证用户】和【账号认证密码】需要配置，配置值同蓝凌侧（蓝凌配置流程参考 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. 集成功能使用
3.1 组织架构同步
以上步骤配置完成后，可在 2.2.2_2) 页面点击全量同步按钮 、增量同步按钮。
注：1. 全量同步前最好把蓝凌和帆软日志级别都修改为 debug，若同步过程出错，基于日志文件便于定位问题原因
2. 点击全量同步后蓝凌页面会提示 loading 动画，若同步时间较长，页面可能会报错 500 超时，该提示可忽略，不影响后台实际同步动作，待蓝凌侧优化
3. 增量同步结果可在蓝凌定时任务中查看执行结果
3.2 查看报表链接
配置完成后，打开蓝凌ekp管理后台-【集成管理】-【报表集成】-【帆软报表集成】-【报表链接生成器】
选中某张报表，可以直接看到报表的相对路径，此路径可配置到蓝凌门户中；绝对路径可在蓝凌已登录时，免登录直接访问帆软报表。
3.3 报表门户展示
操作步骤示例如下，详情可参考蓝凌帮助文档。
