WeLink（苍穹-WeLink）集成使用手册

作者：刘文锐 2020/8/21

注意：该方案已做过DEMO验证，客户现场需要根据实际情况进行必要的调整，并且无论是否调整都必须再次验证才可使用。

1. 集成前准备

许可说明：WeLink的连接走WebAPI连接许可，WebAPI有许可的情况下才可以使用。

WeLink的WebApi连接器是通过于We码小程序(或者H5轻应用)与WeLink服务端API后台集成，实现免登, 通讯录查询等接口的集成。

开发者进入开放平台开发者后台

（https:/open.welink.huaweicloud.com/wecode-site/myapp/list.html）,

打开具体的应用，在应用的“基本信息”中获取相应的client_id和client_secret。

用户可以进入WeLink管理后台查看人员和组织的数据状况（https://welink.huaweicloud.com/admintenant/#/）

WeLink服务端对外接口文档（https://open.welink.huaweicloud.com/docs/#/990hh0/ka0vzc/vwd3yr?type=internal）

集成方案获取：https://pan.yunzhijia.com/s/MTE0Nzk4NSxkMzc2#/ 来自：云之家企业云盘 密码请查看云之家群“苍穹集成云产品交流群”公告

2.新建连接配置

连接配置如下图设置

需要注意如下三点：

1. WeLink连接类型启动并需要刷新环境。

2. 服务器IP和域名字段公有云和私有云的不同，公有云直接填图中的域名 open.welink.huaweicloud.com，服务端端口为443，HTTP协议为https；私有云用户填写自己的WeLink服务器信息。

3. client_id和client_secret填写上一步获取到的client_id和client_secret。

3.WeLink连接类型

WeLink连接类型中的API调用脚本里面未对WeLink服务器的返回结果做任何处理，用户如果需要注册WeLink的集成对象时，需要注意在结果转换脚本自行编写脚本处理，可以参考人员同步(post://api/contact/v2/users/bulk)或者

组织同步(post://api/contact/v2/departments/bulk)的集成对象。

4.组织同步

开发人员需确定组织同步的业务需求，我们提供组织同步的相关方案。

全量同步的启动方案(Org(IERP_WeLink)_Init)，根据组织编码同步的启动方案(Org(IERP_WeLink)_FilterByNumber)。

组织同步使用的是异步的API，因此在在执行结果中的成功日志并不一定是就是成功，所以我们提供组织全量同步的服务流程(Org(IERP_WeLink)_Init)。

服务流程提供后置的结果请求，支持组织同步完成后自动请求同步结果，将失败的结果发送到苍穹的消息中心，因此用户在使用此方案的时候需要修改流程中通知节点的消息接收人，通知节点如下位置。

注意：组织同步的集成方案和服务流程不会同步封存的行政组织。

          组织同步只同步行政组织视图默认方案下的行政组织。

5.人员同步

人员同步我们同样提供全量同步的启动方案(User(IERP_WeLink)_Init),根据人员工号同步的启动方案(User(IERP_WeLink)_FilterByNumber)。

人员同步的服务流程(User(IERP_WeLink)_Init)，请求同步的结果，将失败的结果发送到苍穹的消息中心，用户需要在服务流程中的通知节点指定消息接受人。

注意：用户使用服务流程需要入参员工工号，全量同步填写 *。

集成服务云使用指南：https://club.kdcloud.com/article/45312

集成服务云新特性发布汇总：https://club.kdcloud.com/article/146134

集成云常见问题处理合集: https://vip.kingdee.com/article/45556