蓝凌EKP集成(新版)

1.1 版本

1.2 功能简介

帆软平台与蓝凌 EKP 应用集成，核心实现两大能力：

• 报表链接单点登录：将帆软报表链接集成至蓝凌平台，实现蓝凌用户一键访问帆软报表，无需重复登录

• 组织架构同步：将蓝凌 EKP 的用户、部门、岗位信息同步至帆软平台，支持自动同步

1.3 注意事项

1）环境与插件要求

• 帆软平台需安装开放平台插件与蓝凌 EKP 集成 (新版) 插件；蓝凌 EKP 平台需具备帆软集成模块功能（具体可联系蓝凌确认）。

• 蓝凌 EKP 支持版本：v16；其他版本集成需联系蓝凌咨询。

• 帆软支持版本：v10、v11。

• 插件升级规范：旧版蓝凌集成插件需先删除，再安装新版插件，禁止新旧插件共存；蓝凌侧需同步升级至新的帆软集成模块。

2）同步规则说明

• 蓝凌侧部门、机构在帆软中统一映射为部门；蓝凌部门禁用增量同步后，帆软中对应部门将被删除。

• 同步范围不包含帆软平台中的角色信息。

• 全量同步前置操作：需先清空帆软平台内用户、部门、岗位数据，避免重名导致同步失败（可通过导入、同步数据集功能完成清空）。

• 岗位同步说明：当前版本暂不支持岗位同步，部门岗位下的用户直接挂载至对应部门；后续蓝凌优化后将支持岗位同步，届时会将现有挂载至部门的用户迁移至对应部门岗位下。

2.1 安装插件

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

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

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

2.2 帆软平台配置

2.2.1 单点属性配置

管理员登录帆软平台， 点击「管理系统>系统管理>常规」，按以下说明完成「蓝凌EKP集成（新版）配置」：

• 蓝凌认证地址：示例格式为 http://host(/ekp)/api/third-finereport/sysOrg/getUserInfoByToken；其中host为蓝凌服务器实际地址，/ekp路径可通过测试接口状态码判断是否需要添加（若状态码为404，需尝试添加该路径）。

• 账号认证开关：控制向蓝凌认证地址请求时是否携带用户密码信息；开启后，需同步配置「账号认证用户」和「账号认证密码」，配置值需与蓝凌侧保持一致（蓝凌侧配置参考2.3.1）。

• 账号认证用户：向蓝凌认证地址请求时携带的用户名参数，配置值与蓝凌侧一致（参考2.3.1）。

• 账号认证密码：向蓝凌认证地址请求时携带的密码参数，配置值与蓝凌侧一致（参考2.3.1）。

• 报表平台地址：示例格式为 http://host/webroot/decision；其中host为帆软工程地址，默认无需填写；若经过nginx转发后无法正确获取报表地址，需手动配置该选项。

2.2.2 开放平台应用配置

参考《开放平台插件帮助文档》，点击对应菜单新建应用并配置相关权限，，用于蓝凌侧同步组织架构。具体说明如下：

1）新建应用：按照开放平台插件文档流程完成应用创建。

2）应用权限配置：应用创建完成后，手动开启所有分组的权限

注：若为新版本开放平台插件，需先点击页面右上角「显示旧版本接口」，再开启所有分组权限。

3）同步配置：应用创建成功后，复制应用ID和密钥，留存备用（用于后续蓝凌平台配置）。

2.2.3 安全设置

管理员登录帆软平台，点击「管理系统>安全管理」，关闭「点击劫持攻击保护」，否则可能影响集成功能正常使用。

2.3 蓝凌平台配置

2.3.1 单点属性配置

打开蓝凌EKP管理后台，点击「集成管理>Restservice服务」，找到帆软报表集成单点服务，进行访问策略设置，配置如下：

• 访问控制策略：需与帆软2.2.1中「账号认证开关」保持一致（帆软开启则蓝凌对应配置，帆软关闭则蓝凌无需额外设置）。

• 登录账号：与帆软2.2.1中「账号认证用户」完全一致。

• 登录密码：与帆软2.2.1中「账号认证密码」完全一致。

• 可访问的REST服务：必须勾选「帆软报表集成单点服务」，否则单点登录功能无法生效。

2.3.2 集成属性配置

打开蓝凌EKP管理后台，点击「集成管理>报表集成>帆软报表集成」，按以下说明配置参数：

• 蓝凌插件版本：选择「蓝凌EKP集成（新版）」。

• 帆软系统地址：示例格式为 http://IP:port/webroot/decision/；其中IP:port为帆软服务器实际地址和端口，需准确填写，避免连接失败。

• 应用ID：复制帆软2.2.2中创建的应用ID，粘贴至此处，需与帆软侧完全一致。

• 密钥：复制帆软2.2.2中创建的应用密钥，粘贴至此处，需与帆软侧完全一致。

• 重名岗位处理：因帆软系统中职位不允许重名，若蓝凌存在重名岗位，会导致同步失败；启用该开关后，同步时将以「岗位名称+岗位ID」作为职位名称同步至帆软，规避重名限制。

• 全量同步：需先清空帆软平台的用户、部门、岗位信息（参考（参考前文注意事项相关说明）），再点击“全量同步”按钮，完成组织架构初始化同步（首次同步必做）。

• 增量同步：可设置每日定时同步时间，也可手动点击「增量同步」按钮，触发日常更新（适合后续用户、组织架构变更后同步）。

2.3.3 报表权限配置

打开蓝凌EKP管理后台，点击「组织权限管理>权限管理>角色分配」，为需要访问帆软报表的用户/部门，分配「帆软报表集成」权限。

若未配置该权限，用户访问帆软报表集成链接时，会提示「无应用权限」，无法正常访问。

3.1 组织架构同步

上述配置完成后，进入2.3.2页面，点击「全量同步」或「增量同步」按钮即可执行同步。

注意事项：

1）全量同步前，建议将蓝凌、帆软日志级别改为 debug ，便于同步出错时定位问题。

2）全量同步时页面若出现 500 超时报错，可忽略，不影响后台同步，后续蓝凌将优化此问题。

3）增量同步结果可在蓝凌「定时任务」中查看，确认同步是否成功。

3.2 查看报表链接

配置完成后，打开蓝凌EKP管理后台，点击「集成管理>报表集成>帆软报表集成>报表链接生成器」。

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

3.3 报表门户展示

报表门户展示操作步骤示例如下，详情参考蓝凌帮助文档。