企业微信拉取数据到IDaaS

最后更新时间：2023年05月08日

1. 场景描述

image.png

  1. 从企业微信 查询相关数据，拉取到数据同步模块。

  2. 数据同步模块对原始数据进行映射转换，生成IDaaS需要的目标数据。

  3. 数据同步模块调用IDaaS接口推送数据到IDaaS系统。

2. 支持的对象

支持同步组织机构，账户数据到IDaaS系统。

3. 数据同步配置

在管理员界面，点击同步任务 -》 添加同步任务 -》上游同步 -》企业微信。
image.png
image.png

3.1. 基本信息配置

3.1.1. 同步任务名称：

同步任务名称不允许重复。长度不超过32字符。
image.png

3.1.2. 上游配置：

新建配置，或者选择已有配置。
新建配置：

  • 上游配置名称：不允许重复。长度不超过32字符。

  • 企业ID：企业微信的CropId，查看方式：登录企业微信管理后台 –》我的企业 –》企业ID

image.png

  • 应用secret：企业微信应用的secret，查看方式：应用管理 –》找到对应的应用，点击查看secret

image.png
注意，请配置企业可信IP
image.png

  • 接受事件token：接收事件token在企业微信管理平台，管理工具 – 》通讯录同步 –》已设置的接收事件服务器–》token

image.png
image.png

  • 接收事件EncodingAESKey：接收事件EncodingAESKey在企业微信管理平台，管理工具->通讯录同步->已设置的接收事件服务器->EncodingAESKey


image.png
注意：事件token和encodingAESKey为非必填项，当需要开启企业微信回调功能时，需要填写这两项。并且通讯录同步权限改为API编辑通讯录，并且需要设置企业可信IP。
image.png

  • 用户接收事件URL：请把该地址填入企业微信管理平台，管理工具->通讯录同步->已设置的接收事件服务器->URL，其中host为connector服务的host地址（一般情况下，如果数据同步服务没有配置额外请求地址，该地址为：{当前IDaaS地址}/connector，如：https://www.idaas.com/connector），taskId为对应任务的id。

image.png

  • 多企业微信同步：是否开启多企业微信同步到同一个IDaaS，若开启的话，组织机构id和账户名称会自动对应加上前缀”enterprise_wechat_任务ID_”

  • 连接测试：测试是否能和企业微信服务器通信，填写的企业ID和secret是否正确。

image.png

3.1.3. 授权信息：

关联应用是为了根据应用进行接口范围和数据范围的管理，保证IDaaS数据的安全性。
image.png
应用API状态：开启：允许调用IDaaS接口。关闭：不允许调用IDaaS接口。
接口范围：设置同步任务允许调用哪些接口。请根据需要，选择开放调用的接口。
数据范围：设置在拉取IDaaS数据时，可以从哪些组织层级查询到数据。

3.1.4. 规则配置：

  • IDaaS根节点标识：

选择需要同步到IDaaS的组织机构根节点，选择后，后续所有数据以该节点为根节点进行同步。如果不选择， 默认同步到IDaaS人事组织根节点。

  • 上游系统根节点标识：

填入企业微信的部门ID，查看方式：企业微信管理后台 –》通讯录 –》点击部门的信息查看。如下图
image.png

  • 同步类型：

选择需要同步的对象类型，如：组织机构，账户。

  • 默认密码：

同步账户时，若账户映射的密码字段值为空，则使用该默认密码进行填值。该项非必填。

  • 增改模式：

开启后，系统在同步数据前，将根据检测字段检测数据是否已存在，如存在则进行修改同步，否则进行新建同步。企业微信同步只支持外部ID字段检测。
image.png

4. 字段映射

字段映射主要作用为把来源的原始数据，根据所配置的字段映射规则，转换成目标所需要的数据。该同步场景下，已经预设了一些常用字段映射规则，如需更改，请自行修改即可。
字段映射方式分为：字段映射和脚本映射。
字段映射：一对一的直接映射，直接把来源字段映射为目标所需要字段。
脚本映射：根据groovy脚本所配置的内容，对来源数据进行处理之后，再映射到目标字段。groovy脚本配置方式请参考文章：
connector groovy脚本使用文档

新增字段映射：
点击添加按钮，选择映射方式，选择字段值，如果字段值在下拉列表中不存在，可以手动输入。
image.png

5. 同步策略

5.1. 同步方式

同步方式分为三种：手动，定时，实时。

5.1.1. 手动：

手动同步指管理员手动触发同步任务。可在同步任务页面点击立即同步按钮，进行立即同步。该同步方式下，同步任务会根据配置好的信息，从来源默认根节点下，拉取所需要同步的对象（组织机构，账户），同步到下游系统中。

5.1.2. 定时：

定时同步指根据同步任务配置的定时任务执行计划，进行数据的同步。也可以进行手动触发。
定时任务又分为周期执行和定时执行两种。
周期执行：勾选“周期执行”并勾选“周二”并选择“间隔02:00”，表示在每个周二每隔2小时执行一次同步任务。
定时执行：勾选“定期执行”并勾选“周二”并选择“02:00:00”，表示在每个周二的2点执行一次同步任务。
image.png

5.1.3. 实时：

实时同步表示当数据源发生变化时，上游业务系统自动触发同步任务实时变更数据。（企业微信上游同步不支持实时同步），如需要企业微信数据发生变化时，更新IDaaS数据，请在上游配置时，配置企业微信回调。

5.2. 失败自动重试

该功能主要应对在数据同步过成中，如出现网络短暂波动而造成的数据同步失败的情况。选择失败重试之后，失败的数据将会立即进行重推。重推数据时，不再从来源拉取数据，使用之前已经拉取到的来源数据进行重推。失败重试可以选择重试1，2，3次。
注意：该功能无法解决由于来源数据错误而导致的数据推送失败的情况。