s-HRcloud配置文档1s-HR招聘集成Moka系统配置手册一、集成方式：s-HR招聘需求——Moka职位发布、简历寻源&获取、面试——s-HR录用审批&Offer——s-HR预/入职二、集成业务说明：1、s-HR招聘需求推送到Moka的职位1)推送业务：a)s-HR招聘需求审批通过后，是自动还是手工进入Moka的职位，可在“系统设置-招聘系统集成第三方配置-业务集成配置”中自定义；b)如果自动推送失败，或者选择了手工推送，可操作需求列表按钮【推送到Moka】进行手工推送；s-HRcloud配置文档2c)推送成功与否，可在需求列表字段“推送结果”中查看，失败结果可查看“推送详情”。推送成功后的需求不会再次推送到Moka职位。2)需求变动同步：a)如果在s-HR操作了【反审批】，系统会根据推送状态来确认，如果推送成功不允许反审批；b)s-HR招聘需求单修订后，会单向同步到Moka；Moka有调整目前不会同步到s-HR;c)推送到Moka的招聘需求，在Moka中禁止删除；d)s-HR招聘需求“终止”，Moka的职位会同步“暂停”；e)s-HR招聘需求根据自己的规则“已完成”，则同步Moka的职位为“结束招聘”。2、Moka“沟通Offer”的候选人进入s-HR的录用报批1)推送给Moka的职位、或者Moka历史职位（开启中的）下的候选人，在进入Moka“沟通Offer”阶段后，可选择自动或者手工推送到s-HR；2)Moka简历信息进入s-HR简历中（包括附件），面试信息进入到录用报批单中，报批单状态为“待报批”；3)候选人的入职信息、转正信息、离职信息传回给Moka。三、使用前配置：配置位置如图：管理员账号登录进入：开发平台-第三方招聘系统集成配置s-HRcloud配置文档31.集成第三方账号：管理集成账号，通过秘钥打通2.集成第三方字段映射：管理不同类型的字段的值转换3.集成第三方集成接口映射：管理外部接口的调用逻辑4.集成业务配置：与集成相关的招聘业务的规则设置5.集成第三方初始化配置：集成上线前需要初始化的摩卡历史行政组织、职位四、配置流程说明（此次集成以Moka为主，项目如果集成了其它招聘系统，比如北森、大易，可通过该配置进行二开）1、集成第三方账号1)集成账号列表：2)集成账号单据页面：说明：s-HRcloud配置文档4a)“集成第三方”为：“Moka”；企业“集成秘钥”通过“Moka”客服获取并录入；“集成状态”选择“是”。保存即可成功打通。（摩卡的集成秘钥无须验证）b)每个第三方招聘系统创建一条“集成账号”即可。在业务自动化对接的时候，会自动获取Moka的秘钥。2、集成第三方字段映射说明：s-HR招聘系统的基础资料，比如学历等与Moka的“学历要求”字段的值映射。如果在Moka中启用了自定义的同名字段（比如有两个学历要求），那么该映射只针对启用的字段。1)集成字段映射列表：2)集成字段映射表单：a)可通过导入功能快速创建：导入前，需要建立对应的字段映射配置，并设置启用。导入的时候，选择对应的字段配置即可s-HRcloud配置文档5b)配置字段映射后，在接口映射配置中，配置在对应的字段上即可。c)字段值映射处理，s-HR值一般是接口映射的query查询出的结果，第三方招聘系统值是需要在请求接口的时候，进行转换的值。3、集成第三方接口映射1)集成接口列表：s-HRcloud配置文档62)集成接口配置表单：3)接口映射的配置逻辑：a)映射类型分为query映射，OSF映射，二者选一。b)集成第三方【triggerType】：Moka。接口映射配置被激活的时候，获取对应的集成第三方账号配置。c)启用：改接口映射是否正在启用。当启用的时候，会被对应的后台业务触发或者调用；禁用的时候，不会进行响应。d)接口地址：外部第三方的api地址e)HTTP类型：https或httpf)请求类型：GET||POST||DELTE||PUTs-HRcloud配置文档7g)每分钟限制：Moka对每个api限制默认80次h)触发业务【triggerKey】：该接口映射，在后台被调用的关键key。i)集成执行方式：单条执行或者批量执行。根据第三方系统api的要求，设置对应的逻辑即可。j)是否初始化：限制当前接口映射是否针对初始化的场景业务。（初始化业务请见配置第五项的“初始化配置”，系统预置的两个初始化业务请务必选“是”）k)接口参数：外部第三方的api入参json格式，会对json格式进行验证l)Query配置：shr的query元数据，需要全路径，会进行校验m)Query过滤条件：执行query的时候，设置过滤条件，非必填n)OSF名称：shr的osf接口名称，会进行校验4)字段值映射：a)原字段：设置query的时候，会自动把query的所有字段渲染到表格的原字段，默认不启用；b)目标字段：为接口请求json格式内的参数，会进行匹配校验；c)字段映射：F7弹出所有的启用的字段映射，进行选择。d)原值和目标值不为空，默认启用。5)需求同步到Moka注意点：a)同步的前提：需要初始化组织架构、职位职能、职位优先级。如果没有初始化组织架构，则同步会提示职位部门不存在，同步失败；b)如果招聘需求填写了招聘负责人，那负责人邮箱必须跟Moka职位负责人一致，否则同步失败。s-HRcloud配置文档86)配置Moka简历同步到shr的映射关系：a)字段值映射中，存在字段映射的，可在“集成第三方字段映射”找到对应的映射字段配置“s-HR值与第三方招聘系统值”，配置完成后要重启服务器才会生效。b)Moka中字段为文本类型的，s-HR为基础资料或者枚举类型的，当上面的映射配置不能满足需求时，可将该字段映射改动为s-HR自定义的一个字段，同时需要考虑入职后进入人事的数据映射关系。c)接口映射中预置的字段，如果需要增加、删除、修改原字段和目标字段，可调整接口中Moka对应数据赋值到s-HR的字段。d)在Moka自定义多行表后，需配置s-HR接收的多行表对应的映射数据，预置映射数据请在总部的支持下修改，以免发生问题。e)字段值映射中，stageIds为限制Moka阶段id，清空后可拉取所有Moka阶段的简历；f)updateAtStartTime、updateAtEndTime为Moka的更新开始时间、结束时间，修改后在EAS客户端-后台事务定义-人力资源（s-HR）-招聘管理-推送Moka简历-测试，即s-HRcloud配置文档9可选择这段时间内有修改的Moka简历进行拉取，拉取成功后需要还原updateAtStartTime、updateAtEndTime的值g)Moka“招聘阶段”与简历“招聘状态”映射：系统预置了s-HR“待报批”与Moka“沟通Offer”的映射关系并默认启用，那么进入到Moka“沟通Offer”的候选人会进入到s-HR录用报批菜单中。（如果禁用，Moka简历会默认同步到s-HR并处于待筛选阶段，那么简历的状态、面试数据同步暂时会有问题。二期会继续新增简历筛选、面试阶段的映射，具体可咨询研发冷雁林（15019400440）），h)映射关系区分大小写：如果Moka的招聘阶段名称为“沟通offer”，会导致简历数据传输错误或失败。解决方式：新增待报批与沟通offer的映射，两边大小写保持一致。i)Moka的简历来源为三级渠道，s-HR中的来源方式、简历来源、来源类型分别对应Moka的一、二、三级渠道，都可在接口映射配置列表中找到并配置s-HRcloud配置文档104、集成业务配置1)系统预置两个业务配置项：选择不同招聘类型的需求进入已集成招聘系统、Moka集成业务规则设置2)选择不同招聘类型的需求进入已集成招聘系统场景：如果企业针对不同的招聘类型（社招、校招等）同时使用多套招聘系统，在集成时可配置s-HR的哪些招聘类型进入到已集成的第三方招聘系统的社招、校招…3)Moka集成业务规则设置场景：业务使用中的规则配置配置需求、简历进入到对方招聘系统的手工、自动方式；获取第三方招聘系统的简历信息的选择5、集成第三方初始化同步在正式开始集成前，需要完成数据初始化操作后再进行日常的集成。目前相对于Moka集成来讲，组织架构是一切同步的基础。s-HRcloud配置文档111)行政组织同步a)场景1：新上线Moka，还未使用，可以直接进行组织架构初始化在初始化同步列表直接勾选“Moka集成组织架构初始化”点击【初始化执行】按钮即可。b)场景2：Moka已经使用了一段时间，需要对于历史数据先建立集成映射关系在初始化同步列表勾选“Moka集成组织架构初始化”点击【数据映射】按钮，进入数据映射列表。在数据映射列表点击按钮【拉取第三方数据】，获取Moka现有的全量组织架构数据生成列表s-HRcloud配置文档12通过导入映射关系或单独维护的方式将Moka系统中拉取过来的数据和shr系统中的组织数据进行映射匹配点击【同步第三方数据映射关系】按钮，将维护好得映射关系同步推送给到Moka系统映射关系同步成功后，回到初始化同步列表，勾选“Moka集成组织架构初始化”点击【同步第三方数据映射关系】按钮，手动将当前shr的组织架构数据全量同步s-HRcloud配置文档13推送到Moka系统。c)组织结构日常定时同步对于招聘业务来说，组织架构对于数据同步的即时性要求并不高，本次处理定时全量同步。Moka组织架构全量同步接口如图：金蝶s-HRMoka系统其他描述name_L2行政组织名称departments[].name部门名称ID行政组织IDdepartments[].departmentCode部门IDparentId上级行政组织IDdepartments[].parentCode上级部门IDdepartments[].type部门类型s-HR组织数据无此标准属性对应，不传值，默认为普通部门index排序码departments[].sequence部门排序s-HRcloud配置文档14组织架构同步接口映射关系后台事务定时执行-组织架构全量同步新增Moka组织架构全量同步后台事务，预置每天执行一次，执行时间为凌晨2点每次推送同步的数据范围是启用了s-HR应用的且启用状态的行政组织数据（通过query进行过滤，不要代码写死）2)招聘业务数据初始化a)Moka职位初始化到招聘需求准备：在初始化前，请先执行Moka初始化组织架构、职位职能、职位优先级，否则可能导致职位初始化失败。b)Moka职位初始化招聘需求场景：客户先使用了Moka，使用前需要将进行中的职位初始化到s-HR初始化操作如下图所示，选中数据点击【初始化执行】，即可将Moka职位同步新增到shr招聘需求中。s-HRcloud配置文档15
