1. 简介
云助手-蓝凌应用的集成
1.1. 功能说明
云助手蓝凌应用的集成，只需要简单的配置对应参数，即可完成与蓝凌应用的对接。此集成方案不支持移动审批消息的发送，移动审批的消息统一由erp端发送
1.2. 方案列表
功能导航：设置中心》集成到第三方OA》选择蓝凌KK
2. 具体方案说明
2.1. 主界面展示
2.1.1. 功能说明
蓝陵KK集成方案支持发送消息和用户认证。 通过蓝凌是否推送消息总开关来控制集成是否需要发送消息,应用是否推送消息来控制应用是否需要发送消息，通过配置蓝陵用户认证解密秘钥实现用户身份认证。
2.2. 集成参数说明
| 参数 | 说明 |
|---|---|
| 蓝陵服务器地址 | 蓝陵服务器请求地址，用于推送消息，如：格式为http://域名或ip:port |
| 蓝陵企业代码 | 企业代码，必填，一般填0001 |
| 蓝陵应用消息接收器代码 | 应用消息接收器代码，一般填KK_AppMessage_Receiver1 |
| 蓝陵用户认证解密秘钥 | 蓝陵用户认证解密秘钥 |
| 移动报表，移动审批等是否推送消息 | 控制应用是否需要推送消息 |
| 蓝凌是否推送消息 | 集成总开关，总开关关闭，所有应用不会推送消息，总开关开启才会检查应用消息开关状态 |
2.3. KK后台配置的示例如下
如果需要推送应用的消息，则开启各个应用，并且设置消息的应用代码，应用代码从蓝凌后台获取：
3. 常见问题
3.1. 1001-未找到通讯录中的用户
出错现象
出错原因：第三方登录用户不在erp中
解决方案
1、换一个明源中有的用户编码登录;
2、在明源中增加一个这样的用户编码.
3.2. 1002-解析username失败
出错现象
出错原因：第三方登录用户代码对应的用户认证解密钥匙错误，与明源的解密算法不一致
解决方案
1、填写正确的用户认证解密钥匙;
2、修改用户认证解密钥匙为现在所填写的秘钥.
3.3. 1003-帐号已经被禁用
出错现象
出错原因：第三方登录链接中的用户在明源系统中已经被禁用了
解决方案
1、换一个明源中非禁用状态的用户编码；
2、在明源中启用这个用户。
3.4. 1004-未设置秘钥，无法支持集成
出错现象
出错原因：云助手中台-设置中心-集成到第三方OA-用户认证解密秘钥没有填写
解决方案
1、去云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写用户认证解密秘钥
3.5. 1005-获取usercodeapi报错找不到578eee89e4b0978967fb5ad5对应的usercode
出错现象
出错原因：578eee89e4b0978967fb5ad5”在用户映射表中不存在
解决方案
1、在用户映射表中添加“578eee89e4b0978967fb5ad5”及对应erp用户的usercode
2、换一个在用户映射表中存在的客户登录；
3.6. 1006-登录的用户账号在明源ERP中不存在
出错现象
出错原因：第三方登录用户不在erp中，或者在erp中，但该用户编码被禁用
解决方案
1、换一个明源中有的用户编码登录;
2、在明源中增加一个这样的用户编码
3、查看是否用户编码被禁用，如禁用则解除禁用或者换一个非禁用的用户编码。
3.7. 1007-蓝凌KK的后台配置可信域名错误
出错现象
出错原因：kk后台配置可信域名错误，详见前面第二节具体方案说明里面KK的后台截图中的域名
解决方案
1、明源这边测试环境域名为 qy-qa.fdccloud.com，生产环境域名为 www.fdccloud.com，切记前面不能加http或者https;
2、配置正确则此问题解决