版权所有©1993-2019金蝶国际软件集团有限公司④内部公开请勿外传同步工具日常运维金蝶中国技术支持部2020/02/202课程收益了解同步工具的基本功能快速定位及解决同步工具使用过程中遇到的问题3提纲功能使用02基本概念01常见问题034基本概念5同步工具是做什么的？同步工具，是将符合要求的EAS组织和人员数据同步到云之家。注意：①是EAS单向同步到云之家，并非双向的同步。只有手机号目前是有条件的支持双向同步。②能同步的数据有前提条件限制。③EAS和云之家数据并非100%一致。6哪些数据可以同步？-组织同步前提条件•EAS组织必须是行政组织，才能与云之家同步。映射条件•按照组织长名称（不含根组织）映射，即EAS组织长名称与云之家长名称一致才会映射。处理逻辑•新增组织：EAS组织是正常状态。上传数据为组织长名称，云之家会按照上传的组织长名称的层级，建立云之家的多级组织。•删除组织：EAS组织是封存或删除状态，且已与云之家组织映射。注意：若组织未绑定，会导致后续人员、部门负责人等接口出现问题，必须优先解决。7哪些数据可以同步？-新增人员同步注意：若人员未映射，会导致后续上级、兼职等数据出现问题，必须优先解决。前提条件•必须是有职位的职员，才能与云之家同步。映射条件•EAS人员与云之家人员的手机号+姓名（或邮箱+姓名）一致，才会建立映射关系。•若手机号或邮箱都不相同，则可以通过异常情况手工绑定功能手工建立绑定关系。处理逻辑（必须满足以下所有条件才能上传云之家）•职员状态为正常、试用、返聘员工；•关联用户的职员：职员未禁用、用户未删除；•未关联用户的职员：职员未禁用。•手机或者邮箱正常：不都为空，不重复。•与云之家用户未映射。8哪些数据可以同步？-删除人员、兼职、部门负责人、上级删除人员：前提条件：已与云之家映射的人员•职员状态不是正常、试用、返聘员工；•职员禁用•用户删除满足以上3个条件任意其一，则删除云之家人员。部门负责人同步：•部门负责人同步，必须组织、人员都已与云之家组织和人员建立映射关系。•部门负责人为某组织的负责人岗位包含的职员。兼职同步：•兼职同步，必须组织、人员都已与云之家组织和人员建立映射关系。•兼职信息为该人的非主职位及所在组织信息。上级同步：•上级同步，必须人员都已与云之家建立映射关系。•上级为该人的上级岗位中所包含的职员。•（行政汇报关系的上级）9同步原理EAS数据、中间表数据和云之家数据三套数据系统•首先将EAS数据创建到中间表（映射关系）中，扫描并标识数据是否可同步；•然后中间表再上传数据到云之家，同时将云之家的数据拉取到中间表（云之家数据），通过组织、人员的映射规则，对EAS数据和云之家数据进行绑定。•同步结论更新至中间表日志中。10功能使用11同步工具如何使用？1、部署2、入口菜单3、参数配置4、同步数据范围设置5、同步执行6、查看同步日志7、异常数据处理12部署部署方式：•8.5和Cloud版本：发版时就带了同步工具的功能（8.5建议先更新同步工具的补丁和企业门户管理的补丁）。•8.2版本：补丁部署。•8.2以下版本：私包部署（打开【帮助指引】查看如何部署）EAS8.5版本同步工具最新补丁可以这样查看：BOS管理控制台–补丁管理–补丁下载–BOS_XTSYNC领域（8.2版本同步工具领域模块名称：云之家同步工具）注意：推荐使用谷歌浏览器访问。仅administrator有权操作同步工具。13入口菜单其它版本的入口菜单请查看帖子:•https://club.kingdee.com/forum.php?mod=viewthread&tid=1501697&page=1&extra=#pid421402814参数配置-初始化同步环境初始化同步环境第一次部署同步工具，避免之前遗留的脏数据存在影响,可做初始化同步环境操作。进行初始化同步环境操作之后，按钮会隐藏。功能：更新环境为未同步之前的状态，会删除之前的同步日志、中间表和Key文件配置，并重新生成全新的中间表。15参数配置–同步环境：云之家地址1、云之家地址系统已默认设置云之家公有云地址；云之家混合云需根据客户的云之家部署环境自行设置。说明：原域名mcloud.kingdee.com即将停用。网络要求：https://club.kingdee.com/forum.php?mod=viewthread&tid=1501683&page=1&extra=#pid421399216参数配置–同步环境2、同步环境上传云之家的key。下载Key的路径为：云之家管理中心-系统设置-系统集成。特别提醒：若变更企业注册号，系统将进行初始化，初始化后会清除EAS组织、用户与云之家所有的关联关系和同步记录。同步环境是数据库隔离的，登录的哪个账套，key就绑定了哪个账套；为了防止测试账套往云之家工作圈同步数据，上传key的时候会保存key和数据中心编码，也就是说同一个key文件在一个EAS环境中只能上传到一个账套中。（PS：8.2/8.5版本需要打补丁）。https://club.kingdee.com/forum.php?mod=viewthread&tid=1501679&page=1&extra=#pid421398417参数配置–同步项目3、同步项目系统已默认设置需要同步项目。用户也可根据自己的需求调整同步项目。特别说明：1、除了手机号外，其它都是单向同步，即从EAS往云之家同步。2、修改手机号往云之家同步受到诸多限制，所以，建议让员工在云之家操作，往EAS同步，需勾选【从云之家更新EAS手机】。如果【从云之家更新EAS手机】、【从EAS更新手机到云之家】同时勾选，则以晚修改的一方为准。18参数配置–同步策略4、同步策略定义后台事务自动同步。前提条件：1、同步的异常数据（重复上传、数据出现错误等现象）已经全部处理；2、手工同步多次后，数据传递稳定无异常。设置步骤如下：1、在系统平台后台事务事务定义后台事务定义;2、新建一个后台事务，任务选择：企业建模安全管理用户管理云之家同步云之家同步功能下的“autoSync”或“autoSyncNew”其它版本请参考：https://club.kingdee.com/forum.php?mod=viewthread&tid=1501910&page=1&extra=#pid421493319同步数据范围设置–手工设置•手工控制人员是否上传，按照职员来控制。若一个职员有多个用户，则选择一个用户为不上传，则会修改该职员对应所有的用户为不上传。•手工控制组织是否上传，若选择某一行政组织为不上传，则下级组织和人员都不上传。•手工控制职位下的人员是否上传，若选择某一职位为不可同步，则该职位下的职员都不上传。（EASCloud还没有这个功能）20同步数据范围设置–仅同步关联用户的职员•同步项目中勾选该选项之后，进行【快速同步】或【全量同步】操作时，会把未关联用户的职员的同步控制状态自动设置为“不上传”。21同步执行–异常数据扫描在开始同步数据前，可以用异常数据扫描将无手机号码且无邮箱、手机号码重复或邮箱重复的数据查询出来，并导出到excel中。此三类人员数据属于异常数据，不会同步到云之家。帖子：https://club.kingdee.com/forum.php?mod=viewthread&tid=1501693&extra=22同步执行–快速同步&全量同步全量同步：会下载云之家全量的数据与EAS信息进行对比；上传完成后，会下载更新后的云之家全量数据。快速同步：以上次同步时间为起点，只会下载该时间点之后更新过的云之家组织、人员数据与EAS信息进行对比；上传完成后，会下载本次同步时间之后云之家更新的数据。23同步执行–查看同步结果每次同步后，系统会有同步记录，可以查看同步成功和失败的数量配置了后台事务经常需要回查同步记录。24同步日志查看查看日志：组织、人员、负责人、兼职、上级•可按照不同的同步类型、同步时间、成功状态等过滤数据。可导出查询的数据，以便线下分析。可查看EAS下载的云之家组织、人员及手机修改记录。•说明：云之家组织、人员和手机修改记录都是上次同步云之家后的数据，非实时。25同步日志查看–人员日志26异常数据处理–组织状态查看勾选后，右侧列表会显示下级人员查看组织的绑定情况以及异常分析27异常数据处理–人员状态查看1、在职状态（中间表）：中间表中已存在的静态在职状态；2、在职状态（实时）：根据HR状态、职员禁用、用户删除等状态实时计算员工的动态在职状态。3、EAS详情：上次同步后EAS中人员信息云之家详情：上次同步后云之家人员信息特别说明：除在职状态（实时）外，此处查看的都是中间表的数据，不是EAS和云之家的实时数据。28异常数据处理–显示中间表不存在人员勾选后，可显示不在中间表中的人员，可查看已离职人员的信息。29异常数据处理–数据更新•功能：下载最新云之家数据，建立映射关系。在点击快速同步时，可提升数据同步的速度。•如果EAS不做为数据源上传云之家，又想建立与云之家的绑定关系，可只执行数据更新功能。30异常数据处理–导出数据•导出组织、人员映射表数据。•异常数据处理页面只显示了正常的行政组织。封存的组织可以通过导出全部组织查看。31异常数据处理–离职人员插入中间表1、如果云之家团队中有离职人员的数据，但是人员映射表中又没有绑定，那么为了删除云之家上已离职的人员，需要先使用“离职人员插入中间表”功能，把EAS离职人员全部插入到映射表，并绑定云之家上已有人员的openID，再执行快速同步，就会调用删除人员接口，删除云之家多出的人员。2、特殊情况下，如果人员在EAS已经离职，但是在云之家在职，且映射表无此人员映射关系，想离职掉此人时使用该功能。32异常数据处理–删除中间表人员删除人员映射关系。若数据发生错误时，需对某个人的数据进行初始化操作，可使用该功能，把该人从中间表删除掉。下次执行同步或点数据更新按钮时，会重新新增人员至中间表。如果人员在EAS修改手机号，在云之家还是旧手机号，删除映射关系同步后云之家会产生两个账号。33异常数据处理–删除云之家人员调用云之家接口，删除相关数据。云之家上部门负责人、兼职、上级有遗留的错误数据时可以全部删除后重新同步。34异常数据处理–异常情况手工绑定手工更新人员映射表的映射关系。选择一条数据记录，点击“异常情况手工绑定”，会过滤出与当前选择数据的姓名或手机号或邮箱号相同的云之家数据，管理员选择其中一条数据手工建立绑定关系。注意，手机号和邮箱都为空的话，无法通过异常情况手工绑定功能进行绑定操作。35常见问题36常见问题1–组织架构调整后同步到云之家组织混乱解决方案：8.2：打补丁PT143899（2019-12-30号发放）8.5：打补丁PT146534（2020-1-20）说明：如果云之家组织太混乱的话，也可以对云之家做组织初始化。初始化组织的影响：•初始化组织之后，所有组织都会删除，人员会进入到【无部门人员】下，再同步过来的组织是新的fid，即使组织名称一样。•初始化组织之后，人员角色不会丢失，但是角色的部门范围会丢失。•部门群可能会丢失人员。•云之家的移动签到、智能审批等跟组织相关的功能都会受到影响。37常见问题2–云之家出现组织和人员混乱情况原因分析：多源同步导致，如可能是测试环境的测试库，或者正式环境的测试库往该团队同步。这样的测试库往往都是正式环境的正式库备份出来的，因正式库中配置了云之家同步的后台事务，导致测试库也会定时把测试库的数据同步到云之家，导致云之家数据混乱。解决方案：方案1：如果是测试环境的数据中心同步导致的，可以把测试环境server/properties目录下的key文件删除；方案2：进入每个测试库的同步工具-参数配置中，将key文件替换掉（例如，找个云之家测试团队的key文件替换上，这样定时同步就会把测试库的数据同步到测试团队中）方案3：把每个测试库的云之家同步后台事务禁用，并且在同步工具-参数配置中将云之家地址改为一个不可访问的地址。38常见问题3–同步后人员状态仍然是未绑定解决方案：在异常数据处理页面导出未绑定人员之后可以可以查看到绑定不成功的原因，不成功的原因可能有：手机号为空，不合法，职员或用户的手机号或邮箱重复，云之家已有其他人使用该手机号等。请根据原因去修改，最后再进行同步。参考帖子：https://club.kingdee.com/forum.php?mod=viewthread&tid=1501699&page=1&extra=#pid421403439常见问题4–云之家上显示的兼职、上级、部门负责人不对解决方案：在异常数据处理页面，点击更多菜单下的“删除全部云之家负责人”，“删除全部云之家兼职”，“删除全部云之家上级”可以删除云之家的数据，删除后再同步。PS：同步的数据来较大时会丢失数据，8.2和8.5版本已有补丁已修复，请更新较新的补丁。低版本建议先不用该功能。40常见问题5–员工换了手机号，需要更新s-HR和云之家的手机号解决方案：方案一：在同步工具的参数配置中，勾选“从云之家更新手机到EAS”，由员工自行到云之家更换手机号，同步工具会自动更新s-HR端的手机号。推荐采用该方式。方案二：在同步工具的参数配置中，勾选“从EAS更新手机到云之家”，在s-HR端手工维护s-HR的员工联系方式，在满足特定条件时，同步工具可以更新云之家手机号。对于目标手机号，需满足如下任意条件方可修改成功：1、目标手机号未注册云之家账户。2、如果目标手机号已注册云之家账号，那么该用户需满足当前账号只有一个工作圈或所在圈都有一个相同管理员。注：人员同步日志中可以查看修改不成功的原因。当“从云之家更新手机到EAS”和“从EAS更新手机到云之家”都勾选时，会以较晚维护一方的手机号为准更新另一方。如果不满足条件，则更新手机号失败，请参考：https://club.kingdee.com/forum.php?mod=viewthread&tid=1501696&extra=41常见问题6–无部门人员存在的原因及解决方案1、云之家组织初始化，或组织删除，则人员会挪动到【无部门人员】下边。重新同步会将其拉回到对应部门下。2、新增人员所属组织在云之家不存在，那么同步时人员更新组织失败，提示找不到组织，同步后人员会显示在云之家的【无部门人员】下边。答复：先解决组织同步的问题，确保组织同步成功，再去同步人员。更新人员组织失败，提示找不到组织，请参考贴：https://club.kingdee.com/forum.php?mod=viewthread&tid=1501709&extra=3、其它产品直接调用云之家人员相关接口将人员同步到了云之家，因没有同步部门，所以人员显示到了云之家的【无部门人员】下边。4、金蝶的其它产品（如协同，星空等）通过同步注册用户到云平台，然后云平台的注册用户又进入到了云之家。目前所知的金蝶s-HR云托管租赁8.2、金蝶云星空、金蝶协同都会默认将注册用户同步到云之家圈子中。云平台增加了人企分离功能。建议设置人企分离，那么注册用户就不会进入到云之家圈子中了。1）登录云平台（https://cloud.kingdee.com/qy/home），找到云之家的工作圈/团队对应的企业；2）把该企业下的产品都启用人企分离步骤：进入产品的注册用户列表页面，点【管理用户-人企分离】，启用之后，当前产品的用户不会同步到产品所在企业的云之家圈中42常见问题7–工作手机号复用职员A离职后，需要将工作手机号给B用，那么请按照如下步骤操作：1）同步工具中进行快速同步，将云之家中手机号为xxx的用户A离职掉；2）注册用户同步，将A所占的许可释放掉（注意查看同步结果，看一下是否同步成功）；3）到同步工具-数据查看/异常数据处理页面中，将A的人员映射数据从中间表删除（搜索该人员，勾选后点【更多】-【删除中间表人员】）；4）把s-HR中A的手机号和A关联的用户的手机号都换成私人的手机号或者一个测试的手机号；5）职员B在sHR入职后维护手机号xxx，然后快速同步到云之家。注意：第3)步操作必须做。如果没有在同步工具中删除掉人员映射表的数据，此时若手机号xxx直接加盟云之家给B使用，那么这种情况下再进行同步操作，还是会将B离职掉，因为满足了删除人员同步的条件：43常见问题8–某个员工在云之家团队频繁入职和离职可能的原因是：1、人员映射表数据有问题首先在同步工具的【同步日志查看-云之家人员】页面中，按姓名或手机号搜索，找到人员XTID，然后在查询分析器中到人员映射表中查下：select*fromt_pm_easxtusermapwherefxtid='该人员的XTID'执行结果应该有两条数据，一条离职的，一条在职的（t_pm_easxtusermap的字段Fstatus的值，0离职，1在职，2禁用）将错误的那条数据删除掉再进行同步验证是否问题还出现。问题数据可能是s-HR入职反审批产生的问题数据，该功能在8.2/8.5最新补丁中完善了。2、有其他数据中心通过后台事务自动同步数据到云之家团队中这种情况下要排查客户所有的EAS数据中心，看一下同步工具中该人员的状态，跟正式库是否是不一致的，且是否往云之家团队同步。44常见问题9–企业工号在你本工作圈中存在重复更新人员编码，或者新增人员时，失败原因如下所示：45常见问题9–企业工号在你本工作圈中存在重复云之家同一个工作圈（团队）中，企业工号不允许重复。如何查看谁使用了这个工号呢？•导出云之家通讯录，用工号搜索；•在同步日志查看-云之家人员中，根据工号进行搜索。•查到是谁占用了该工号之后，请根据具体情况进行处理：•1）确认一下云之家占用了该工号的人跟EAS中使用了该工号的人，是否是同一个人。•2）如果是同一个人，可能因为手机号不相同或姓名不相同没有自动绑定，那么可以到【数据查看/异常数据处理】使用异常情况手工绑定功能进行绑定，然后再同步。•3）如果确认不是同一个人，那么需要将云之家人员所占的工号释放出来，然后再去同步。•4）另外，职员已经新建了一个用户同步到了云之家；过段时间又新建了一个用户，这种情况下，该用户进行同步时就会提示企业工号在你本工作圈中存在重复。46常见问题10–人员无法同步到云之家，中间表显示离职或不存在47常见问题10–人员无法同步到云之家，中间表显示离职或不存在问题分析：用户删除、禁用，不符合新增人员同步的条件。解决方案：需要到EAS客户端的【用户管理】（路径：企业建模->安全管理->权限管理->用户管理）页面，回收并启用用户。48常见问题11–人员无法同步到云之家，中间表显示无职位问题分析：s-HR中人员有职位，但是EAS中人员无职位。解决方案：同步工具同步的是EAS中的人员数据。在职员任职情况表t_org_positionmember中查不到数据就属于无职位人员，而无职位人员不允许同步到云之家。对于这种情况，需要s-HR修复数据，方法：s-HRweb员工管理-员工信息维护页面的同步ERP任职，重新生成t_org_positionmember表数据。49常见问题11–人员无法同步到云之家，中间表显示无职位50常见问题12–某用工关系状态的员工无法同步到云之家问题分析：用工关系为“实习”的员工都同步不到云之家。解决方案：使用s-HR8.2SP2（需要打补丁PT116190）及以上版本客户，可以根据企业实际需求定义用工关系状态对应的人员状态，进而控制哪类用工关系状态的员工同步至云之家。51更多FAQhttps://club.kingdee.com/forum.php?mod=viewthread&tid=1501678Thanksterimakasih感謝谢谢ありがとうขอบคุ�ณ版权所有©1993-2019金蝶国际软件集团有限公司
