#### 此贴旨在简单说明EAS同步工具的基本同步逻辑, 以便开发和支持同事理解, 便于处理问题, 如无说明,文中范例截图均以云之家为例 ## 1. 同步参数配置 第一步,需要配置同步参数, 配置获取第三方系统token的必要参数, 并选择需要的同步项, 主要分为几个大类: 组织,人员,部门负责人,兼职, 直接上级 ::: hljs-center  ::: ## 2. 同步范围设置 第二步, 同步之前需要设置同步范围, 根据现场需要将不需要同步的部门和人员设置为不可同步, 有多个维度可以设置,包括人员, 部门, 职位 ::: hljs-center  ::: ## 3. 同步前处理 在同步每一个大类前, 会进行同步前的处理, "数据更新"操作也指的是这一步. 先说明一下同步工具的表结构, 大致分为四类: 1. 第三方数据表: 存储从第三方系统获取的数据, 例如T_XT_USER, 为从云之家获取的用户信息 2. EAS数据表: 以职员相关表为主, 为EAS端数据, 例如T_BD_PERSON, 为职员表 3. 中间表: 将第三方数据和EAS数据匹配绑定,存储双方的映射关系, 可以说最重要的表, 例如T_PM_EASXTUSERMAP, 为EAS和云之家的用户中间表 4. 日志表: 记录同步日志, 例如T_XT_LOG, 存储云之家同步相关的日志数据 这一步的内容是从第三方系统获取数据,并将新获取的数据更新到中间表, 获取数据依据客户配置的同步参数, 在进行数据更新时, 此步骤会进行数据绑定, 更新中间表的绑定关系: 组织绑定一般通过长名称对比, 人员则是姓名与手机号或者姓名与邮箱 ==此处有例外, 因企微接口限制,企微的人员绑定逻辑在同步执行步骤的新增人员时== ## 4. 同步执行 这一步, 就是具体向第三方系统更新数据. 通过同步参数配置和设置的可同步数据范围, 将筛选出的需要更新的数据整理出来,调用第三方系统接口进行更新, 部分场景分为全量更新和增量更新,一般建议增量方式, 请求数据量较小,效率更高  #### 说明: 数据准备为同步前处理, 数据处理为同步后处理, 同步XX为执行同步 因企微同步的人员绑定在此步, 故说明一下大致逻辑: 1. 首先,尝试新增人员, 如果成功, 直接绑定 2. 若新增失败, 判断是否是是手机号或邮箱重复, 如果是通过手机号或邮箱获取已存在的userid 3. 最后通过手机号(邮箱)和姓名绑定, 将userid更新到中间表 ## 5. 同步后处理 同步完成后, 会执行同步后的一些事务, 主要包括向第三方系统请求更新最新的数据确认, 和更新相关表 ## 6. 日志记录 同步日志记录在对应日志表中, 比如T_XT_LOG, 表中会记录同步批次, 同步类型, 基本同步数据和同步是否成功  ## 7. 异常数据处理 这个功能是为了协助用户处理不能自动绑定或者绑定错误的员工, 可以通过对比双方信息, 进行手动绑定或者修复错误信息