系统集成——金蝶s-HR与星空旗舰版组织人员主数据集成介绍

栏目:s-hr cloud知识作者:金蝶来源:金蝶云社区发布:2024-09-22浏览:1

系统集成——金蝶s-HR与星空旗舰版组织人员主数据集成介绍

【功能简介】

业务背景:使用s-HR人力资源管理系统,同时使用金蝶云星空旗舰版财务系统,需要保持主数据的统一。

功能介绍:

1)支持行政组织、人员主数据的初始化同步;

2)支持行政组织、人员主数据的变动监听与即时同步;

3)支持同步日志的查看,针对同步失败的数据支持手动触发重新同步;

4)增加定时机制对组织人员数据进行增量补偿同步,进一步保障两边数据一致。

【适用版本】

 s-HR和星空一体化集成功能在s-HR Cloud V8.8 SP1及以上版本发布和支持。星空旗舰版为公有云,取最新迭代即可,无版本。

s-HR版本号
相关补丁支持情况
V8.8 SP1PTM171251、

平台补丁PT175951、

集成补丁PT175946、

薪酬补丁PT176500、

考勤补丁PT177379;

(若对应领域有最新补丁,则安装最新补丁即可)

支持组织员工主数据集成,支持凭证集成、银行代发单集成、出差单集成。

V9.0PTM176002、

考勤补丁PT177421

(若对应领域有最新补丁,则安装最新补丁即可)

支持组织员工主数据集成,支持凭证集成、银行代发单集成、出差单集成。

【备注】:若对应版本对应领域有最新补丁,则安装最新补丁即可,s-HR各版本最新补丁清单可以从以下链接获取:https://vip.kingdee.com/article/61509631671398912


【详细功能介绍】

1.前期集成配置

集成配置步骤简介如下图。详细操作请参考https://vip.kingdee.com/article/604738211826163712 中配置手册说明。

2.组织、人员数据初始化同步

完成以上配置后,进行行政组织、员工的初始化同步。

1. 请在“开发平台->集成配置->苍穹平台系统集成配置”对应集成配置详情界面,点击【集成系统初始化】按钮调整到初始化同步界面,如下图:

2. 据说明进行操作,先设置和确保确保s-HR启用的行政组织类型编码都有星空旗舰的组织形态编码进行映射转换,如下图:



3. 需要调整两边系统中已有数据的行政组织编码(包括根组织)和员工工号对应一致,初始化时将按照组织编码和员工工号进行匹配更新;确认好后点击【初始化同步】按钮进行初始化同步处理。

4. 查看初始化同步结果,有失败的数据可以挑战到日志列表进行查看,处理后可以重新进行初始化同步。

【备注】:

初始化同步数据范围包括系统内所有启用的行政组织和在职员工(在职员工判定标准:员工用工关系状态对应的ERP人员状态为在职、在职或返聘)。

初始化同步不对已经封存的组织、及已离职的员工(员工用工关系状态上的ERP人员状态为离职、离退休)进行同步。

初始化同步逻辑: s-HR的行政组织对应编码或员工工号在星空系统中不存在时,新增对应行政组织和人员数据并建立数据映射;s-HR的行政组织对应编码或员工工号在星空系统中存在时,二者对应匹配更新并建立数据映射关系


3.组织、人员数据日常同步

        集成同步配置完成并执行初始化同步后,后续系统将会自动同步更新行政组织和员工数据。在s-HR系统中组织数据的更新,以及员工管理中对员工信息的更新及员工变动等都会触发数据同步至去星空(旗舰版)系统中。

       s-HR系统内进行行政组织的新增、修改、变更、封存、删除、批量组织架构调整,这些业务操作生效后,系统都会向星空旗舰系统内自动同步。

【特别说明】:s-HR系统内行政组织封存,星空旗舰系统对应行政组织会自动置为封存,这可能影响星空旗舰相关的行政组织架构部门的财务、供应链、制造等相关的业务,需谨慎处理。

s-HR系统内进行员工的入职、员工信息的修改、员工信息的变更、调动事务、兼职事务、员工离职、删除、批量组织架构调整造成的员工任职变化,这些业务操作生效后,系统都会向金蝶云星空系统内自动同步。

【特别说明】:s-HR系统内管理的企业员工更新、转正、调动、离职、删除等,根据s-HR对应员工状态和星空旗舰系统的参数设置,可能会将星空旗舰的对应人员禁用,这可能影响员工相关的财务、供应链、制造等相关的业务及供应链业务员的设置,以及工作流的应用,需谨慎处理。


行政组织、员工数据更新机制及字段对应关系,请参考下面Excel的描述:

组织、员工数据同步(标准预置)

s-HR业务操作更新金蝶云星空(旗舰版)数据说明如下:


s-HR与金蝶云星空(旗舰版)集成字段同步标准预置说明如下:


若有同步失败的数据,可以在s-HR的集成同步日志里边重新同步(参见本章第2节)。


3.1 不进行同步推送的数据说明

       部分数据因关键数据不完整、关联的上级或前置基础资料未同步成功,将不会金蝶云星空同步这些数据,这些数据的失败日志将写入s-HR和星空旗舰的错误日志:

    • 同步组织:行政组织类型没有和星空旗舰组织形态建立映射关系的组织无法同步,失败原因为:“参数【patternNumber】必填。”

      • 同步组织:上级组织未新增同步成功的,失败原因为:【上级部门】数据不存在:编码“XXXX””

      • 同步组织:金蝶云星空业务组织为空的,失败原因为:“金蝶云星空业务组织编码为空,不进行同步推送”;

      • 同步员工:员工任职部门编码在星空旗舰不存在(即组织未新增同步成功的),失败原因为:【部门】数据不存在:编码“XXXX””

      • 同步员工:员工编码和用户名不符合规范的,失败原因为:“用户名”只能包含中文、字母、数字、下划线,并且不能以下划线开头和结尾

      • 同步员工:手机号码、邮箱号码不符合格式校验的,失败原因为:“手机号位数不对”或“区号不对”

      • 同步员工:直接上级不存在(即直接上级员工未同步成功)的,失败原因为:“直接上级”下“工号=XXXXXX”引入不成功。


3.2  同步禁用金蝶云星空基础数据说明

组织

s-HR组织封存时,同步到星空旗舰版会自动封存对应部门;

s-HR组织删除时,星空旗舰对应部门不会封存,只会删除数据映射关系。

员工

s-HR员工同步到星空旗舰系统是否禁用该员工,根据员工当前用工关系状态上的ERP人员状态设置和星空旗舰对应参数进行综合判断。

若ERP人员状态为离职、离退休,则同步至星空旗舰时调用处理员工映射关系接口。如:员工离职后用工关系状态变为辞职(用工关系状态为“辞职”的基础数据上的ERP人员状态为离职),同步至旗舰时会调用对应接口进行处理。请根据需要设置对应用工关系状态上的用户状态,如下图:

       当星空旗舰接收到s-HR对应的接口调用后,会根据星空旗舰系统【基础服务云-公共设置-参数配置-系统参数】菜单里基础服务系统参数中s-HR集成参数进行判定是否进行用户禁用和人员禁用:  

参数名称

参数说明

员工离职/删除时同步禁用用户

参数为默认开启状态。开启该参数,则s-HR系统中员工离职禁用或删除时,会同步禁用当前星空系统中与之映射的用户账号;关闭该参数,则不同步禁用,需要管理员手工调整用户状态。

员工离职/删除时同步禁用人员

参数为默认开启状态。开启该参数,则s-HR系统中员工离职禁用或删除时,会同步禁用当前星空系统中与之映射的用户账号;关闭该参数,则不同步禁用,需要管理员手工调整用户状态。


【备注】:组织、员工在星空旗舰同步禁用,将可能影响到相关的星空旗舰业务,涉及:工作流/审批流、业务单据/基础资料/凭证等引用,若有特殊需要,请做好业务协调,在s-HR更新操作前,确保走完金蝶云星空(旗舰版)相关业务或者不会影响到星空对应业务。


4. 同步日志记录及映射表

       在星空旗舰和s-HR系统均可以查看同步数据的同步日志和映射关系表。通过同步日志可以直观查看同步失败的原因,便于分析原因,通过映射关系的查看可以溯源。

       在初始化同步时,系统根据s-HR中的基础数据(行政组织、员工)编码与旗舰版系统中的对应基础数据(行政部门、员工/人员)编码或工号进行匹配,生成对应数据内码的映射表,后续数据更新均通过映射表中的ID进行匹配更新;新增的数据在映射表中不存在,会先根据编码进行匹配,若匹配成功则生成对应数据内码的映射表,若未找到匹配数据,则在星空期间中创建数据并返回内码记录到映射表中。

       数据同步成功和失败均在s-HR和星空旗舰同时记录同步日志,s-HR可由管理员或有权限的用户通过【开发平台->集成配置->星空旗舰版集成日志】进行查看,每次同步均会新增日志记录。


4.1 s-HR系统记录同步日志

       有权限的用户进入【开发平台-集成配置-星空旗舰版集成日志】查看,每次同步都会新增一条日志记录,主要记录数据的编码、名称、同步状态以及失败原因等信息。同步失败的数据,可以批量选择重新同步,同步后会以最新的同步结果更新金蝶云星空的数据,并生成最新的日志,如下图:


4.2 金蝶云星空(旗舰版)记录集成同步日志

       星空旗舰系统由用户针对具体的基础资料分别查看接口调用同步日志,功能路径:【行政组织(部门)/人员】的【其他】->【s-HR同步日志】菜单;星空旗舰系统这里的同步日志主要记录同步接口的调用日志,如下图:

【行政组织(部门)/人员】的【其他】->【s-HR同步映射关系】可以查看相关基础数据的对应关系如下图:



系统集成——金蝶s-HR与星空旗舰版组织人员主数据集成介绍

【功能简介】业务背景:使用s-HR人力资源管理系统,同时使用金蝶云星空旗舰版财务系统,需要保持主数据的统一。功能介绍:1)支持行政组织...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息