金蝶s-HR与魔学院集成应用指南金蝶软件（中国）有限公司2022年03月金蝶s-HR与魔学院集成应用指南2/22目录前言.......................................................................................................................................3一、功能目标...........................................................................................................................4二、版本支持...........................................................................................................................4三、集成同步要求...................................................................................................................4四、集成同步配置及初始化...................................................................................................4第一步：【集成方案配置】：...........................................................................................4第二步：【集成方案启用】：...........................................................................................9第三步：【集成方案初始化同步】：...............................................................................9五、同步功能说明.............................................................................错误!未定义书签。1.基本功能：......................................................................................错误!未定义书签。2.数据映射：......................................................................................错误!未定义书签。3.集成日志：......................................................................................错误!未定义书签。3.1不进行同步映射的数据说明..................................................................................224.培训数据同步................................................................................................................18六、同步异常分析及处理.....................................................................................................21七、注意事项.........................................................................................................................22金蝶s-HR与魔学院集成应用指南3/22前言本文档是针对金蝶s-HR与魔学院使用集成应用的说明，包括应用环境、数据中心的支持，集成配置说明等。金蝶s-HR与魔学院集成应用指南4/22一、功能目标金蝶s-HR和魔学院集成主要为支持在包含人力资源的整体ERP解决方案当中，需要同时部署金蝶s-HR人力资源管理系统和魔学院企业培训管理系统，可以保持组织、员工基础资料的统一。最终保障整个业务系统的信息流连贯通畅，及全程的自动化处理。金蝶s-HR和魔学院集成，使用金蝶s-HR培训管理集成和魔学院开放平台协作处理。集成方案总体介绍：金蝶s-HR培训管理集成：s-HR系统针对魔学院开发平台提供标准化集成方案，且提供可视化配置能够快速匹配客户的动态集成需求，降低集成开发成本，对数据集成执行过程和执行结果进行全链条监控且提供补偿机制和处理措施，让集成开发简单、执行过程可靠、问题风险可控。魔学院开发平台：魔学院开放平台提供丰富的API接口，可借此实现其他系统和魔学院的数据对接，实现单点登录和应用互通。二、版本支持金蝶s-HR（以下简称s-HR）支持s-HRCloud2021H1版本，补丁要求必须打上：PTM155668和集成补丁PT163455；可参见《金蝶s-HRCloud2021H1安装部署说明》三、集成同步要求仅支持s-HR一个数据中心到魔学院一个数据中心进行单向集成同步，不支持一对多或多对一的集成同步，也不支持同一应用服务器下挂多个数据中心分别同步。四、集成方案配置及数据同步第一步：【注册魔学院企业账号】1.在魔学院注册企业账号，获取企业id，企业Key等信息（方案配置时需要使用）2.企业id获取方法，登陆魔学院官方网址注册地址：（http://mxy.chinamobo.com/admin.php/login/register/puborg/private）金蝶s-HR与魔学院集成应用指南5/221）点击“免费注册”2）跳转到免费开通企业账号界面，在注册界面填写完相关信息后即可注册成功3）获取企ID：注册成功后，登陆魔学院管理后台获取企业相关信息，路径：系统设置—>系统集成—>开放平台注：“CorpSecret”，“Token”，“Key”这3个字段信息在未点击【确认】前明码显示，填写应用名称点击【确定】以后将加密显示，点击【确认】前请拷贝记录，点击【确认】后将获取“CorpId”，这个字段会在页面上明码显示；界面上“CorpId”，“CorpSecret”，“Token”“Key”4个字段信息，在s-HR分别对应“企业id”“企业密钥”，“企业token”，“企业key”金蝶s-HR与魔学院集成应用指南6/22第二步：【单点登陆配置】1.单点登录配置及白名单配置：使用administrator管理员身份登陆s-HR系统->系统设置->单点登录配置1）界面上所有勾选的选项均可勾上，监听信息配置勾选后才会进行数据监听；2）SSO数据中心：选择要设置的数据中心；3）登录认证器：默认填写，不需要选择，可以打开下拉框确认是否有OTP，没有OTP请提单到s-HR基础平台获得支持;4）白名单地址：非必填项，根据需求填写；参考下图设置，修改后保存并重启服务器才能生效；第三步：【集成方案配置】金蝶s-HR与魔学院集成应用指南7/22前置条件：使用administrator账号登陆s-HR系统进行配置1.重启服务器后进行方案配置，路径：开发平台—>集成配置—>培训管理集成配置；2.点击进入后，在界面上选择魔学院，学习平台地址默认填写，点击【集成方案配置】3.跳转到培训平台集成同步方案首页，页面显示操作功能按钮和方案列表；目前系统默认预置两个方案，一个测试环境一个正式环境，可以根据需求选择对应环境方案进行数据配置金蝶s-HR与魔学院集成应用指南8/221）选择一个方案，点击进入方案配置界面，界面显示基本信息填写项和接口配置列表；2）方案必填项：方案编码，方案名称，集成模式（选择“推送与拉取”），企业id，企业密钥，企业token，企业key均为必填项，企业相关数据注册魔学院企业账号后在魔学院管理后台中可以获取；其他数据系统默认配置；3）方案编码：唯一性，作为方案的唯一识别，不可重复，重复时无法保存成功；4）接口配置：默认已填写，不需进行操纵；后续有新的数据需求可以根据需求进行新增或删除；5）数据填写完成保存成功后，在平台集成同步方案首页勾选方案点击【启用】按钮即可启用集成方案；金蝶s-HR与魔学院集成应用指南9/22第四步：【集成方案启用】1.选择配置完成的方案（启用或禁用），点击【测试连接】按钮，提示“测试成功”，说明方案已经配置成功；2.选择已配置完成的方案点击【启用】即可启用该方案；已启用的方案点击【禁用】可以将方案禁用；3.同时只能启用一个方案，需要切换方案使用时，启用即可，另一个方案会自动禁用；注：未配置完成的方案无法启用；启用的方案无法编辑但可以禁用；方案禁用状态下s-HR数据不进行同步推送第五步：【初始化同步】场景一：先使用魔学院，后使用有s-HR系统的账号，在方案初始化同步之前，需要先拉取魔学院成员信息进行手动导入生成映射，否则初始化之后这部分成员无法生成映射关系：1）进入拉取员工数据路径：培训平台集成同步方案—>数据映射—>第三方平台员工数据—>拉取员工数据2）点击拉取员工数据按钮后，将魔学院成员列表显示在界面，“集成方案”显示目前系统已启用的方案名称；成员姓名和账号对应显示，所有成员均未建立映射，“是否建立映射”金蝶s-HR与魔学院集成应用指南10/22字段均显示为“否”且s-HR员工编码显示为空；3）拉取平台员工数据后，可以手动填写映射关系进行导入，导入路径：培训平台集成同步方案—>数据映射—>第三方平台数据映射—>导入映射关系—>下载导入模板4）填写导入数据,表格中数据均为必填项，“数据领域”只能选择“员工”，组织和职位目前暂时不支持导入；“数据编码”和“数据名称”分别对应s-HR系统中员工编码和姓名，“数据映射”指魔学院平台成员编码，数据正常填写导入成功后，便可以将魔学院成员与s-HR系统员工生成映射关系；原则上成员与员工的映射是一一对应，不可一对多或多对一；5）导入映射成功后，便可以将先有魔学院账号的成员与s-HR现有员工生成映射关系；进入培训平台集成同步方案—>数据映射—>第三方平台员工数据界面查看数据显示，成员姓名和账号对应显示，生成映射的成员“是否建立映射”字段均显示为“是”，且s-HR员工编码显示为对应映射关系员工的员工编码；金蝶s-HR与魔学院集成应用指南11/226）导入成功后，即可返回培训平台集成同步方案首页进行初始化同步；场景二：先使用s-HR系统后使用魔学院账号，方案启用后，可直接进行初始化同步；初始化同步操作【场景一】和【场景二】使用方法相同，如下：1.方案启用后，首先需要完成初始化同步，建立s-HR系统（组织与员工）和魔学院（部门与成员）映射，路径：培训平台集成同步方案—>初始化同步—>点击【初始化同步】按钮即可，可以进行多次初始化；注：暂不支持s-HR职位数据推送；2.执行初始化同步操作后，可以在【初始化同步任务】中查看当前任务同步进度（等待执行，执行中，完成，终止，错误终止5个状态）；路径：培训平台集成同步方案—>初始化同步—>点击【初始化同步任务】1）导出选中，导出全部：可以导出任务列表中任务，以表格形式导出；2）停止任务：可以选中将执行中的初始化任务进行停止，停止后【同步状态】显示为“终止”，未同步完的数据在任务日志中显示同步失败：金蝶s-HR与魔学院集成应用指南12/223）选择已完成的同步任务可以查看当前初始化同步任务日志，详细记录本次同步全部数据，包括组织和员工，同步成功与否：4）初始化同步完成后，在数据映射表中生成映射关系数据，在魔学院中也将同步显示部门与成员；集成数据映射和魔学院界面显示：金蝶s-HR与魔学院集成应用指南13/223.执行初始化同步后，s-HR系统组织和员工便与魔学院对应部门和成员建立了数据映射关系，在s-HR系统中组织数据的更新，以及在职员工信息的更新或变动等都会触发数据同步至魔学院；第六步：【数据映射】数据映射包含【第三方平台员工数据】和【第三方平台数据映射】两个功能页面，路径：培训平台集成同步方案—>数据映射—>第三方平台数据映射：金蝶s-HR与魔学院集成应用指南14/221.1【第三方平台员工数据】魔学院成员数据，未初始化之前【拉取员工数据】后，界面数据全为魔学院成员数据且均未与s-HR系统员工生成映射；执行初始化同步后，【拉取员工数据】后的数据，包括生成映射成员和未生成映射成员1）拉取员工数据：是指拉取魔学院成员列表数据，已经生成映射和未生成映射的成员均可拉取显示；2）删除培训平台员工数据：只能删除未与s-HR系统生成映射的成员，且删除后在魔学院列表成员也会被删除，慎删；1.2【第三方平台数据映射】：可以根据方案过滤显示所需查看方案数据；当组织或员工发生变更时，数据映射表中数据会对应刷新更新显示；注：导入映射关系：是针对先创建了魔学院账号，后有s-HR员工的魔学院成员，需要金蝶s-HR与魔学院集成应用指南15/22实施人员手动进行维护映射（有内置映射表格模板可以使用），将魔学院成员与s-HR员工手动配置映射，导入成功后，映射关系形成；目前设定在方案未进行初始化同步前导入映射关系；1.3数据映射更新：1.3.1组织：前置条件：使用专业用户（专员）账号登陆同一账套的s-HR系统进行组织和员工的操作启用状态下s-HR组织更新数据时会即时同步至魔学院，在魔学院只显示组织对应的名称，不显示编码，修改组织编码时，在魔学院部门列表中不发生更新；组织同步到魔学院监听逻辑：s-HR组织与魔学院部门对应关系，从上之下一一对应，s-HR根结点则为魔学院部门父结金蝶s-HR与魔学院集成应用指南16/22点，自上至下对应映射：1.3.2员工：s-HR系统内在职员工信息修改/变更（员工编码，员工姓名，员工手机号，邮箱，所属业务组织）、离职，退休，跨公司调动，返聘终止（用户状态更改为禁用）等业务操作后，系统会向魔学院系统内自动同步。在职员工是指用工关系类型的用户状态为“启用”的员工：金蝶s-HR与魔学院集成应用指南17/22员工映射同步到魔学院监听逻辑：s-HR组织和员工操作更新同步魔学院数据说明如下：金蝶s-HRCloud2021H1组织与员工更新同步魔学院场景.xlsx第七步：【集成同步日志】前置条件：使用administrator账号登陆s-HR系统进行查看日志s-HR系统可以查看映射数据的同步日志，通过集成同步日志可以直观查看同步失败的原因，便于分析原因。初始化同步时，系统根据s-HR中的基础数据（组织和员工）编码与魔学院的对应基础数据（部门和成员）编码进行匹配，生成对应数据内码的映射表，后续数据更新均通过映射表中的映射数据进行匹配更新；启用组织和在职员工的增删改操作，每一次操作都将在集成日志表中生成记录，新增的数据会在魔学院创建并返回映射数据记录到映射表中。数据同步成功和失败均在s-HR集成日志，s-HR可由administrator管理员查看，路径：开发平台—集成配置—培训管理集成配置-集成同步日志；金蝶s-HR与魔学院集成应用指南18/22第八步：【魔学院培训数据拉取】1.制定培训计划：使用企业账号登陆魔学院（http://mxy.chinamobo.com），业务中心—培训计划—制定培训计划，路径界面：2.成员上课：企业账号制定计划选择培训成员保存后，对应的成员将收到信息通知，1）成员可以通过手机验证码在（http://e2736.pc.mxy.chinamobo.com）成员登陆上课金蝶s-HR与魔学院集成应用指南19/222）在s-HR系统登陆员工账号后免登录跳转，路径：员工自助—更多—我的培训—学习平台点击跳转到魔学院培训界面进行学习培训，进入培训任务界面选择对应课程进行培训，培训完成后，次日凌晨2点会进行事务触发，将魔学院培训完成的课程数据同步到s-HR员工信息界面；金蝶s-HR与魔学院集成应用指南20/223.培训数据拉取方法：在EAS端使用administrator账号登陆—>后台事务定义—>人力资源（s-HR）—>员工管理—>培训集成管理—>第三方培训集成事务，点击【发布】后，系统会根据设定的频度执行后台事务，将s-HR系统中与魔学院生成映射员工的培训数据拉取，并在s-HR对应员工信息中显示；事务发布：1）员工已完成的培训数据在s-HR员工信息中培训课程（魔学院）页签下显示：金蝶s-HR与魔学院集成应用指南21/224）同一账套下，专员对组织和员工进行增删改一系列操作，使用管理员账号登陆时，均能在集成方案映射表中看到对应数据更新；5）员工是专员时，登陆跳转到培训界面的路径为：培训管理—学习平台6）员工可以通过网页登陆（http://mxy.chinamobo.com/）使用手机号密码或者验证码登陆魔学院学习平台五、同步异常分析及处理1.初始化同步时，管理员可通过s-HR菜单“开发平台—集成配置—培训管理集成配置-集成同步日志”进入查看，同步失败的请检查失败原因，修复数据后重新同步。金蝶s-HR与魔学院集成应用指南22/22金蝶s-HRCloud2021H1魔学院同步异常场景.xlsx1不进行同步映射的数据说明1.封存状态下的组织，初始化时不同步魔学院；2.组织名称长度大于50字时，初始化时不同步魔学院；3.同级重名的组织，初始化时只会同步一个魔学院，其他重名组织不会同步；4.不在职员工，用户状态为“禁用”的员工，初始化时不会同步魔学院；5.导入人员时，未生成业务组织时，初始化不会同步魔学院；6.在职员工姓名长度大于50字时，初始化时不会同步魔学院；7.在职员工手机号为非大陆手机号时，初始化时不会同步魔学院；六、注意事项1.s-HR系统内进行行政组织的新增、修改、变更、封存、启用、删除、批量组织架构调整。这些业务操作后，系统都会向魔学院系统内自动同步。需要配置方案数据启用并初始化，且启用单点登陆的监听，才能同步s-HR的操作。2.s-HR系统内进行员工的新增、修改、变更、删除等这些业务操作后，系统都会向魔学院系统内自动同步。需要配置方案数据启用并初始化方案，且启用单点登陆的监听，才能同步s-HR的操作。3.员工同步添加过手机号，在s-HR将员工手机号置为空时，魔学院手机号不更新置空；4.导入映射关系：是针对先创建了魔学院账号后有s-HR员工的成员，需要实施人员手动进行维护映射，将魔学院成员与s-HR员工手动配置映射，导入成功后，映射关系形成，目前设定在方案未进行初始化同步前导入映射关系；5.培训课程数据同步，需要再EAS客户端发布后台事务，才会进行同步已学习完成的课程数据；
