目录【考勤数据集成配置说明】..............................................................................................................3【关键提示】.......................................................................................................................................3一、配置启用接口（分别说明旧接口、新接口）.........................................................................31.1、旧接口数据集成（内勤数据自动同步+外勤数据s-HRWEB端移动签到审核）..................................................................................................................................................31、修改配置文件参数....................................................................................................32、进行通用配置（见后面的通用配置）.....................................................................43、s-HRWEB端进行移动签到审核............................................................................41.2、新接口数据集成（内勤数据自动同步+外勤数据移动端外勤确认或s-HRweb端移动签到审核）..................................................................................................................41、修改配置文件参数..................................................................................................42、进行通用配置（见后面的通用配置）..................................................................63、移动端云之家管理员开启【外勤确认】，如下图：..........................................64、部门负责人确认外勤。...........................................................................................6【注意】..........................................................................................................................7二、通用配置.......................................................................................................................................72.1、给菜单授权.....................................................................................................................72.2、绑定云之家管理员.........................................................................................................82.3、配置发布云之家签到数据同步后台事务.....................................................................8三、FAQ...............................................................................................................................................93.1、新接口（云之家签到（外勤确认））、旧接口（云之家签到）有什么区别？......93.2、启用不同接口，哪些数据会同步至s-HR“打卡记录”，哪些数据会同步至“移动签到审核”？......................................................................................................................93.3、所有或某段时间云之家签到数据都没有同步到s-HR中...........................................93.4、后台同步事务成功完成，部分员工签到数据没有同步到s-HR系统.....................103.5、云之家部分员工的数据未同步成功，如何重新同步？...........................................103.6、拍照签到与外勤确认待办的关系...............................................................................113.6.1、拍照签到与外勤确认待办的关系....................................................................113.7、移动端外勤确认相关问题...........................................................................................123.7.1、云之家外勤由谁确认？....................................................................................123.7.2、负责人如何确认部门的外勤记录？................................................................123.7.3、为什么负责人没有收到待办消息呢？............................................................133.7.4、外勤未确认的记录会同步么？........................................................................133.7.5、非当天确认的记录如何同步？........................................................................13【考勤数据集成配置说明】云之家移动签到增加新接口，支持调用云之家签到外勤审核数据。升级后，用户需修改配置文件重新启用旧接口，或者配置新接口。新接口（云之家签到（外勤确认））旧接口（云之家签到）【关键提示】1、请认真看完整个文档。云之家签到数据同步是建立在已经做了云之家用户同步的基础上的，如果没有做过用户同步，同步过来的数据会对应不到s-HR中的人员。2、新接口和旧接口不能同时启用。3、新接口集成了旧接口的功能，同时支持移动端外勤确认。4、新、旧接口版本支持：旧接口针对V1.5SP及以上版本；若要使用新接口，8.2SP2已支持；8.2SP1版本请先部署安装补丁PT110771或最新补丁；2.0版本请先部署安装20170112应用包或最新应用包。一、配置启用接口（分别说明旧接口、新接口）1.1、旧接口数据集成（内勤数据自动同步+外勤数据s-HRWEB端移动签到审核）1、修改配置文件参数将hr_ats_punchCardSrcCfg.xml文件（路径：eas\server\properties）中punchCard下面对应的enablstate的value值设置为1。2、进行通用配置（见后面的通用配置）3、s-HRWEB端进行移动签到审核在云之家签到数据同步后台事务执行后，外勤数据会插入到移动签到审核表中，可以在移动签到审核菜单中查看，移动签到审核的数据审核通过之后会直接写入打卡记录表，审核不需要走工作流，只要有权限的人员都可以审核。1.2、新接口数据集成（内勤数据自动同步+外勤数据移动端外勤确认或s-HRweb端移动签到审核）1、修改配置文件参数将hr_ats_punchCardSrcCfg.xml文件（路径：eas\server\properties）中punchCardNew下面对应的enablstate的value值设置为1。若找不到punchCardNew，则在旧接口参数配置下方添加新接口参数配置：【备注】：若有如下配置，则按图将配置内容修改好。
keykdcloudpunchcardenablestate0authkeykdweibourlhttp://kdweibo.com/snsapi/attendance/list.jsoneid4671876启用新接口，设置value为1，如上图；同时禁用旧接口applicationFor="punchCard"，设置value为0。【注】：新接口和旧接口不能同时启用。2、进行通用配置（见后面的通用配置）3、移动端云之家管理员开启【外勤确认】，如下图：4、部门负责人确认外勤。外勤记录是由部门负责人（包括兼职负责人）确认，负责人的外勤记录由上级部门的负责人（包括兼职负责人）确认。如下图：【注意】1、新接口只针对云之家管理员启用了外勤确认功能时间点之后的数据有效，时间点之前的数据无效；移动签到审核的数据，不会立马进入系统，需待后台事务执行后才会更新，存在一定时间差。2、移动端进行外勤确认，且云之家签到数据同步后台事务执行后，外勤数据会与内勤数据一样同步到打卡记录表中；已确认过的外勤数据同步到移动签到审核表并标记为“同意”，且同步到打卡记录表；未确认过的外勤数据同步到移动签到审核表，也可以在WEB端进行移动签到审核。二、通用配置2.1、给菜单授权以administrator登录金蝶s-HR客户端，选择一个用户（一般为考勤专员），例如UserXXX，执行菜单权限分配（如果已经有权限，请忽略此步骤）。客户端授权路径：企业建模->安全管理->权限管理->用户管理选择分配权限的菜单为：人力资源（s-HR）->系统设置->考勤数据设置->绑定云之家管理员2.2、绑定云之家管理员已授权用户登录到s-HRweb系统，如果没有绑定云之家管理员，还需要绑定管理员账号。（如果需要重新绑定，无法显示绑定界面，则需要先清理浏览器缓存）路径：系统设置->考勤数据设置->绑定云之家管理员【注意】：这里绑定的管理员账户是云之家工作圈的管理员账号（这个账号的默认工作圈必须是要同步数据的工作圈）。2.3、配置发布云之家签到数据同步后台事务登录s-HR客户端，配置发布云之家签到数据同步后台事务。路径：系统平台->后台事务->事务定义->后台事务定义->人力资源（s-HR）->假勤管理->云之家签到数据同步【说明】：首次同步会从2015-01-01开始同步，时间会比较长，建议修改同步时间，改为云之家有签到记录的时间。后续同步会同步前一天和当天两天的签到数据。待执行结束之后查看后台事物是否执行成功。如果不需要从这个时间点开始执行，可以修改表时间(修改下面语句标红的时间点即可)。Updatet_hr_ats_bizdatasynchassistsetflastsynchtime={ts'2017-08-0100:00:00'}wherefid='bSvNRciAEU6cJb24RAS0lKlojLM='正常打卡的数据（在云之家设置的打卡地点之内的数据）会直接同步到打卡记录表，在打卡地点之外的打卡数据会算成外勤。同步完成后，云之家签到数据会同步到s-HR系统的打卡记录表，或者移动签到审核内。（详细同步逻辑见常见问题）三、FAQ3.1、新接口（云之家签到（外勤确认））、旧接口（云之家签到）有什么区别？旧接口：不支持负责人审核外勤，外勤记录将同步至s-HRweb端移动签到审核中，需要HR专员统一审核。新接口：集成了旧接口的功能，支持在云之家中负责人对外勤记录进行外勤确认。3.2、启用不同接口，哪些数据会同步至s-HR“打卡记录”，哪些数据会同步至“移动签到审核”？云之家中有效的内勤签到会同步至s-HR“打卡记录”表中。对于外勤签到：若用户使用了新接口（云之家签到（外勤确认）），已在移动端进行了外勤确认的外勤数据，会同步到“移动签到审核”表并标记为“同意”，且同步到“打卡记录”表；未确认过的外勤数据同步到“移动签到审核”表，也可以在WEB端进行移动签到审核。若用户使用旧接口（云之家签到），外勤数据同步到“移动签到审核”表，需专员在WEB端进行移动签到审核。3.3、所有或某段时间云之家签到数据都没有同步到s-HR中原因1：检查s-HR中后台事务“云之家签到数据同步”是否正常发布运行。如果后台事务执行成功，请检查配置文件；如果后台事务执行失败，请按下列检查。原因2：网络问题，本地服务器访问云之家接口延时，超时等，需检查本地网关是否允许对云之家的访问或网络稳定性（可查看apusic日志，是否有超时、500等错误）原因3：未正确绑定云之家管理员，请根据提示和配置说明进行操作绑定后再启动同步原因4：apusic服务器拦截了云之家对OSF接口的访问，需要将云之家服务器地址加入apusic服务器的安全访问白名单（默认已配置白名单）3.4、后台同步事务成功完成，部分员工签到数据没有同步到s-HR系统原因：s-HR中用户与云之家用户映射关系有异常，同一个员工存在多个映射或找不到映射关系（找不到映射关系有一种特殊情况是员工已离职。离职员工无法进行签到数据同步，可以进行打卡记录导入。BOS已出补丁修复，离职员工不删映射关系，补丁号：PT117697）修复：根据任务执行提示，利用s-HR中云之家用户同步功能，修复对应员工与云之家的用户映射关系，然后修改开始同步时间重新执行后台任务全部同步。8.2补丁可以针对性选择异常员工单独进行同步。3.5、云之家部分员工的数据未同步成功，如何重新同步？V8.2补丁选择组织、员工、未同步成功的日期，进行手工同步。路径：考勤管理->打卡记录->同步签到数据说明：要用前台这个手工同步功能，前提是配置文件里有新接口的配置，数据才能从云之家拉下来，但不一定要启用新接口，数据从云之家拉下来后，我们会根据启用了什么接口来保存数据。V1.5、V2.0版本，需要修改表时间来更改同步开始时间，修改后，再重新同步。Updatet_hr_ats_bizdatasynchassistsetflastsynchtime={ts'2017-08-0100:00:00'}wherefid='bSvNRciAEU6cJb24RAS0lKlojLM='3.6、拍照签到与外勤确认待办的关系3.6.1、拍照签到与外勤确认待办的关系拍照签到与外勤确认待办是不一样的。拍照签到是正常内外勤签到的补充。特别是在无法签到的异常情况下可使用。拍照签到记录需要负责人（包括兼职负责人；若无部门负责人，将由管理员审核）审核后才可作为有效的签到记录。拍照签到由负责人确认之后才会同步至s-HR系统，若未审核或审核不通过，都不会同步。内勤的拍照签到，云之家审核后，会同步到s-HR的打卡记录表；外勤的拍照签到，云之家审核后，会变为有效的外勤记录，旧接口（云之家签到）会同步到s-HR的“移动签到审核”；新接口（云之家签到（外勤确认））会同步到“移动签到审核”并标记为“同意”，且同步到“打卡记录”表。3.7、移动端外勤确认相关问题3.7.1、云之家外勤由谁确认？云之家外勤是由部门负责人确认。外勤记录是由部门负责人（包括兼职负责人）确认，负责人的外勤记录由上级部门的负责人（包括兼职负责人）确认。如下图：3.7.2、负责人如何确认部门的外勤记录？方法1：进入“云之家-签到-签到统计”，查看团队外勤记录并确认方法2：通过每天推送的待办消息中进入查看并确认3.7.3、为什么负责人没有收到待办消息呢？请先确认部门中是否有员工进行了外勤签到。其次，外勤待办消息隔天推送，负责人会在第二天收到外勤确认消息3.7.4、外勤未确认的记录会同步么？会同步至s-HR系统的“移动签到审核”表，也可以由专员在WEB端进行同意确认。（详细可参考问题：启用不同接口，哪些数据会同步至s-HR“打卡记录”，哪些数据会同步至“移动签到审核”）3.7.5、非当天确认的记录如何同步？非当天确认的记录，将在确认后，同步任务执行后，重新同步至s-HR系统。
