最新历史版本 :蓝凌EKP集成(新版) 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

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/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. 集成功能使用编辑

3.1 组织架构同步


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

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

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

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

3.2 查看报表链接

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

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

3.3 报表门户展示

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