组织同步
功能及平台机制说明
提供将平台组织机构同步到企业微信平台功能,以实现消息推送及单点登录
支持自动同步组织和手工映射操作设置
从38版本开始,增加针对部分手工映射后,后续实现自动同步能力
映射表说明
在企业集成应用中,不管是使用自动同步还是手工映射方式,最终都是通过orgsync_orgs_mapping表进行建立关系
表字段说明如下
fid varchar(254) 主键(uuid)
fuaaid varchar(254) 门户组织数据ID
fuaaname varchar(254) NULL 组织数据名称(手工映射显示用,自动同步可不设置)
fextconfognid varchar(254) NULL 企业微信对应机构ID(如果是默认架构为null)
fextconfogn varchar(254) NULL 企业微信对应机构(如果是默认架构为null)
fwxcpid varchar(254) NULL 企业微信ID
fdingtalkid varchar(254) NULL 钉钉ID
fcreatetime datetime NULL 创建时间
fupdatetime datetime NULL 更新时间
fkind varchar(254) NULL 映射类型(机构:ogn , 部门: dpt , 岗位: pos , 人员: psm)
fmanual int(11) NULL 是否人工映射(1=true,0=false , 如果需要支持自动同步,需要设置为false;针对自行手工维护映射表后,后续仍然要实现自动同步时,则字段值为2)
具体操作
- 手工映射
- 打开企业集成菜单,在组织映射配置中设置组组织部门及人员对应钉钉、企业微信ID号
- 点击新建,选择组织管理中对应部门或者人员进行配置外部系统ID(外部系统ID可在钉钉、企业微信通讯录详情中获取)
- 打开企业集成菜单,在组织映射配置中设置组组织部门及人员对应钉钉、企业微信ID号
- 自动同步设置
- 打开系统管理中【组织同步配置】功能
- 点击“添加需要同步组织的服务”,选择integration服务
- 设置完成后,在组织管理中设置一个集成用户,并在授权管理中给改用户分配“系统集成”应用角色
- 打开企业集成中【企业集成配置】菜单,设置上个步骤设置集成用户的用户名和密码
- 打开系统管理中的【组织管理】,并点击【同步组织】按钮,同步成功后则会提示同步成功,否则提示失败
- 如要看组织同步日志,可打开【组织数据同步日志】菜单,可查看相关日志
- 同步完成后,可在企业微信通讯录里查看组织同步情况
- 打开系统管理中【组织同步配置】功能
- 针对平台组织和企业微信组织各自独立并且后续平台组织更新后,要实现自动同步情况时,在映射表中自行维护映射数据,字段fmanual值为2即可,完成维护后,按照步骤2方式设置自动同步即可。
关联补充说明
在使用企业微信集成前,需要在平台里配置企业微信参数后方可正常使用,参数具体参考:第三方平台参数配置说明 。