1. 简介
云助手-云之家应用的集成 适用于云之家10.0.00 以下版本
1.1. 功能说明
云助手云之家应用的集成，只需要简单的配置对应参数，即可完成与云之家公有云和私有云应用的对接。
1.2. 方案列表
功能导航：设置中心》集成到第三方OA》选择集成方案
2. 具体方案说明
2.1. 主界面展示
2.2. 功能说明
云之家集成方案支持发送待办消息、更改待办消息状态和用户认证。
通过云之家是否推送消息开关来控制集成是否发送消息。通过移动报表，移动审批等是否推送消息等来控制应用是否要发送消息。通过配置企业注册号，appid等参数实现用户身份认证
2.3. 集成参数说明
云之家发送方企业的企业注册号(eID),如：206
第三方平台：管理中心-应用管理（公共号）-公共服务
云之家公共号编码：云之家发送使用的公共号编码(pubid)，如：XT-6bb6e3c8-9a54-4371-911e-000000；
云之家公共号秘钥：云之家公共号秘钥，如：57d41c685c741723a793bde7b27e7f5；
第三方平台：管理中心-应用管理（公共号）-公共服务
云之家appid：云之家appid，如：20607；
云之家appsecret：云之家appsecret,如：123456；
第三方平台：管理中心-应用管理（公共号）-管理中心（应用-应用中心）-企业应用
云之家服务器地址：云之家服务器请求地址，用于推送消息和用户认证，如：格式为http://域名或ip:port；
云之家用户映射表表名：云之家和erp的用户打通的表，需存储到erp中，并将云之家的openid和明源usercode对应起来表结构名称；
云之家用户映射表中openid存储字段：云之家服和erp的用户打通的表，openid存储字段的名称；
云之家用户映射表中usercode存储字段：云之家服和erp的用户打通的表，usercode存储字段的名称；
注意：若要开启消息推送，需要先将“设置中心-基础参数设置-消息推送设置”一项设置为 “开启”。
①云之家集成成功后每隔12小时会同步一次用户关系，新增用户12小时之后才可生效。
②云之家集成需要配置用户关联字段（APP）和用户关联字段（云之家）。
方式1：用户关联字段（APP）【用户code】 拉取用于关联的字段默认为【jobno】
tip：云之家jobno字段必须跟erp的usercode一致。
方式2：用户关联字段（APP）【手机号】 拉取用于关联的字段【需要咨询云之家开发】
tip：云之家提供的关联字段必须跟erp的手机号一致。
3. 常见问题
3.1. 1001-未找到通讯录中的用户
出错现象
出错原因：第三方登录用户不在erp中
解决方案
1、换一个明源中有的用户编码登录;
2、在明源中增加一个这样的用户编码.
3.2. 1002-解析username失败
出错现象
出错原因：第三方登录用户代码对应的用户认证解密钥匙错误，与明源的解密算法不一致
解决方案
1、填写正确的用户认证解密钥匙;
2、修改用户认证解密钥匙为现在所填写的秘钥.
3.3. 1003-帐号已经被禁用
出错现象
出错原因：第三方登录链接中的用户在明源系统中已经被禁用了
解决方案
1、换一个明源中非禁用状态的用户编码；
2、在明源中启用这个用户。
3.4. 1004-登录的用户账号在明源ERP中不存在
出错现象
出错原因：第三方登录用户不在erp中，或者在erp中，但该用户编码被禁用
解决方案
1、换一个明源中有的用户编码登录
1、在明源中增加一个这样的用户编码
1、查看是否用户编码被禁用，如禁用则解除禁用或者换一个非禁用的用户编码
3.5. 1005-未设置appid参数，无法被第三方应用集成
出错现象
出错原因：云助手中台-设置中心-集成到第三方OA-appid参数没有填写
解决方案
1、在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写appid参数
3.6. 1006-未设置appsecret参数，无法被第三方应用集成
出错现象
出错原因：云助手中台-设置中心-集成到第三方OA-appsecret参数没有填写
解决方案
1、在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写appsecret参数
3.7. 1007-未设置云之家用户映射表表名参数
出错现象
出错原因：云助手中台-设置中心-集成到第三方OA-“云之家用户映射表表名”参数没有填写
解决方案
1、 在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写“云之家用户映射表表名”参数；
3.8. 1008-未设置云之家用户映射表中的openid存储字段参数
出错现象
出错原因：云助手中台-设置中心-集成到第三方OA-“云之家用户映射表表名”参数没有填写
解决方案
1、 在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写“云之家用户映射表表名”参数；
3.9. 1009-未设置云之家用户映射表中usercode存储字段参数
出错现象
出错原因：云助手中台-设置中心-集成到第三方OA-“云之家用户映射表中usercode存储字段”参数没有填写
解决方案
1、 在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写“云之家用户映射表中usercode存储字段”参数
3.10. 1010-getaccess_token接口出错
出错现象
出错原因：云助手中台-设置中心-集成到第三方OA-“云之家appid”和“云之家appsecret”参数填写有误，导致认证不通过；
解决方案
1、 正确填写参数“云之家appid”和“云之家appsecret”的值；
3.11. 1011-获取usercodeapi报错对象名”testtable”无效
出错现象
出错原因：
1、在对应的erp数据库中添加云之家用户映射表表名”testtable”； 2、“云之家用户映射表表名”的参数“testtable”填写错误；
解决方案
1、在对应的erp数据库中添加云之家用户映射表表名”testtable”； 2、将“云之家用户映射表表名”的参数修改正确;
3.12. 1012-获取usercodeapi报错列名“openid1”无效。列名“usercode1”无效。
出错现象
出错原因：
1、“云之家用户映射表中openid存储字段”所填参数与“云之家用户映射表表名”对应字段不一致； 2、“云之家用户映射表中usercode存储字段”所填参数与“云之家用户映射表表名”对应字段不一致；
解决方案
1、修改“云之家用户映射表中openid存储字段”参数与“云之家用户映射表表名”对应字段保持一致；