1. 云之家集成简介

   此方案仅适用于云之家10.0.00 以上版本。（私有云和公有云皆可）   云助手云之家应用的集成，只需要简单的配置对应参数，即可完成与云之家公有云和私有云应用的对接。

2. 集成步骤：

2.1. 一、云助手开启集成：

前往云助手企业平台 → 设置中心 → 集成到第三方OA → 选择集成方案

2.1.1. 1.1、应用集成-获取应用的URL

集成模式说明：应用在云之家平台作为独立入口存在，有几个应用就有几个入口。好处是入口路径比较快捷。缺点是应用入口较多。

2.1.2. 1.2、工作台集成-获取应用的URL

集成模式说明：在云之家平台仅会存在唯一的入口，即云助手工作台。点击云助手工作台进入后才可以看到应用的入口。好处是应用全部聚集在一个入口中，比较方便。缺点是入口路径比较长。

2.2. 二、云之家平台创建应用

2.2.1. 2.1、创建应用

云之家后台，点击全部应用→创建应用

按照云之家要求填写参数。详情填写方式可参考云之家官网： https://open.yunzhijia.com/openplatform/resourceCenter/doc#/gitbook-wiki/self-build-app/appCreateGuide.html

2.2.2. 2.2、获取应用参数---App ID和App Secret

点击创建好的应用，在详情页复制App ID和App Secret字段

2.2.3. 2.3、获取应用的公共号的账号和秘钥

云之家管理后台--管理中心--公共号--公共号服务平台 复制账号和秘钥

2.2.4. 2.4、获取通讯录系统秘钥

云之家后台--管理中心--系统设置--系统集成，复制秘钥。

该参数对应云助手云之家集成方案中【系统集成密钥】

2.3. 三、云助手填写参数

2.4. 四、用户同步

备注说明：

①云之家用户同步需先配置【云之家企业注册号、系统集成秘钥、用户关联字段(APP)、用户关联字段(云之家)】

②云之家用户关联只支持一对一

关联规则说明：

方式1：用户关联字段(APP)【用户code】 拉取用于关联的字段默认为【jobno】 tip：【云之家用户表】中jobno字段必须跟【erp的用户表】中usercode一致。

方式2：用户关联字段(APP)【手机号】 拉取用于关联的字段【需要咨询云之家开发】 tip：云之家提供的【关联字段】必须跟erp的【手机号字段】一致。

2.4.1. 4.1、自动同步

• 云之家集成成功后每隔12小时会同步一次用户关系，新增用户12小时之后才会生效(或者登陆明源企业平台进行手动同步)

2.4.2. 4.2、手动同步

4.2.1、操作入口

通讯录管理→企业通讯录→组织架构→更多→云之家账号关联

4.2.2、同步类型说明：

• 增量同步：不破坏现有的关联关系，增量拉取云之家用户，并按照现在配置的关联规则进行云之家用户与云助手用户的关联
• 全部智能重新关联：会清除现有云助手与云之家用户关联关系，重新按配置的关联规则进行用户关联

2.4.3. 4.3、手动修改云助手与云之家用户关联关系

1、对于系统自动智能关联结果不满意的场景，可以通过手动进行修改

2、云助手与云之家用户只只支持一对一绑定

4.3.1、手动建立关联关系

4.3.2、手动修改已有的关联关系

2.5. 五、常见问题及解决方案

2.5.1. 1001-未找到通讯录中的用户

出错现象

出错原因：第三方登录用户不在erp中

解决方案

1、换一个明源中有的用户编码登录;

2、在明源中增加一个这样的用户编码.

2.5.2. 1002-解析username失败

出错现象

出错原因：第三方登录用户代码对应的用户认证解密钥匙错误，与明源的解密算法不一致

解决方案

1、填写正确的用户认证解密钥匙;

2、修改用户认证解密钥匙为现在所填写的秘钥.

2.5.3. 1003-帐号已经被禁用

出错现象

出错原因：第三方登录链接中的用户在明源系统中已经被禁用了

解决方案

1、换一个明源中非禁用状态的用户编码；

2、在明源中启用这个用户。

2.5.4. 1004-登录的用户账号在明源ERP中不存在

出错现象

出错原因：第三方登录用户不在erp中，或者在erp中，但该用户编码被禁用

解决方案

1、换一个明源中有的用户编码登录

2、在明源中增加一个这样的用户编码

3、查看是否用户编码被禁用，如禁用则解除禁用或者换一个非禁用的用户编码

2.5.5. 1005-未设置appid参数，无法被第三方应用集成

出错现象

出错原因：云助手中台-设置中心-集成到第三方OA-appid参数没有填写

解决方案

1、在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写appid参数

2.5.6. 1006-未设置appsecret参数，无法被第三方应用集成

出错现象

出错原因：云助手中台-设置中心-集成到第三方OA-appsecret参数没有填写

解决方案

1、在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写appsecret参数

2.5.7. 1007-未设置云之家用户映射表表名参数

出错现象

出错原因：云助手中台-设置中心-集成到第三方OA-“云之家用户映射表表名”参数没有填写

解决方案

1、 在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写“云之家用户映射表表名”参数；

2.5.8. 1008-未设置云之家用户映射表中的openid存储字段参数

出错现象

出错原因：云助手中台-设置中心-集成到第三方OA-“云之家用户映射表表名”参数没有填写

解决方案

1、 在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写“云之家用户映射表表名”参数；

2.5.9. 1009-未设置云之家用户映射表中usercode存储字段参数

出错现象

出错原因：云助手中台-设置中心-集成到第三方OA-“云之家用户映射表中usercode存储字段”参数没有填写

解决方案

1、 在云助手中台-设置中心-集成到第三方OA-配置集成参数页面，填写“云之家用户映射表中usercode存储字段”参数

2.5.10. 1010-getaccess_token接口出错

出错现象

出错原因：云助手中台-设置中心-集成到第三方OA-“云之家appid”和“云之家appsecret”参数填写有误，导致认证不通过；

解决方案

1、 正确填写参数“云之家appid”和“云之家appsecret”的值；

2.5.11. 1011-获取usercodeapi报错对象名”testtable”无效

出错现象

出错原因：

1、在对应的erp数据库中添加云之家用户映射表表名”testtable”； 2、“云之家用户映射表表名”的参数“testtable”填写错误；

解决方案

1、在对应的erp数据库中添加云之家用户映射表表名”testtable”； 2、将“云之家用户映射表表名”的参数修改正确;

2.5.12. 1012-获取usercodeapi报错列名“openid1”无效。列名“usercode1”无效。

出错现象

出错原因：

1、“云之家用户映射表中openid存储字段”所填参数与“云之家用户映射表表名”对应字段不一致；

2、“云之家用户映射表中usercode存储字段”所填参数与“云之家用户映射表表名”对应字段不一致；

解决方案

1、修改“云之家用户映射表中openid存储字段”参数与“云之家用户映射表表名”对应字段保持一致；