【关键提示】.......................................................................................................................................1一、云之家资源授权.........................................................................................................................21.1授权oAuth1.0，通过绑定云之家管理员进行授权.........................................................21.1.1给菜单授权..............................................................................................................21.1.2绑定云之家管理员..................................................................................................21.2授权oAuth2.0，通过资源授权秘钥进行授权.................................................................21.2.1签到同步权限秘钥获取..........................................................................................21.2.2秘钥配置..................................................................................................................3二、配置启用接口（公有云配置）..................................................................................................42.1云之家签接口.....................................................................................................................42.2云之家签到（外勤确认）.................................................................................................42.3云之家签到（外勤确认）推荐使用.................................................................................52.4云之家签到同步201906版...............................................................................................5三、数据同步.......................................................................................................................................53.1后台同步............................................................................................................................53.2手动同步............................................................................................................................6四、FAQ...............................................................................................................................................64.1、关于外勤打卡数据的审核操作？..................................................................................64.2、什么是外勤打卡？.........................................................................................................64.3、所有或某段时间云之家签到数据都没有同步到s-HR中？.........................................74.4、后台同步事务成功完成，部分员工签到数据没有同步到s-HR系统.........................74.5、云之家部分员工的数据未同步成功，如何重新同步？..............................................84.6、拍照签到与外勤确认待办的关系..................................................................................84.7、移动端外勤确认相关问题..............................................................................................94.7.1、云之家外勤由谁确认？.......................................................................................94.7.2、负责人如何确认部门的外勤记录？...................................................................94.7.3、为什么负责人没有收到待办消息呢？.............................................................104.7.4、外勤未确认的记录会同步么？.........................................................................104.7.5、非当天确认的记录如何同步？.........................................................................10【关键提示】1、该文档针对s-HR8.2SP2+PT139814及s-HR8.5PT139815以上版本客户应用2、请认真看完整个文档。云之家签到数据同步是建立在已经做了云之家用户同步的基础上的，如果没有做过用户同步，同步过来的数据会对应不到s-HR中的人员。一、云之家资源授权云之家对外开放的接口都需要通过云之家授权协议进行授权后才能访问，只有通过了云之家的资源授权才可以进行云之家打卡数据的同步。目前云之家有两套不同的资源授权方式1.1授权oAuth1.0，通过绑定云之家管理员进行授权1.1.1给菜单授权以administrator登录金蝶s-HR客户端，选择一个用户（一般为考勤专员），例如UserXXX，执行菜单权限分配（如果已经有权限，请忽略此步骤）。客户端授权路径：企业建模->安全管理->权限管理->用户管理选择分配权限的菜单为：人力资源（s-HR）->系统设置->考勤数据设置->绑定云之家管理员1.1.2绑定云之家管理员已授权用户登录到s-HRweb系统，如果没有绑定云之家管理员，还需要绑定管理员账号。这里绑定的管理员账户是云之家工作圈的管理员账号，这个账号的默认工作圈必须是要同步数据的工作圈。如果需要重新绑定，无法显示绑定界面，则需要先清理浏览器缓存。路径：系统设置->考勤数据设置->绑定云之家管理员1.2授权oAuth2.0，通过资源授权秘钥进行授权1.2.1签到同步权限秘钥获取管理员账号登陆云之家-->管理中心-->系统设置-->系统集成-->资源授权-->复制签到数据的秘钥1.2.2秘钥配置打开客户端，找到参数设置-->人力资源(s-HR)-->考勤管理，然后设置好云之家打卡同步团队id和云之家打卡同步资源授权秘钥,如果是私有云，请同时设置私有云的同步地址二、配置启用接口（公有云配置）目前云之家提供四个签到数据同步的接口，但是只能使用其中的一个进行数据同步，可以根据各个接口特性选择合适的接口进行数据同步。路径：8.2s-HR系统-系统设置-考勤基础资料-云之家签到接口配置；8.5s-HR系统-系统设置--云之家签到接口配置。2.1云之家签接口该接口会同步绑定管理员默认工作圈中的签到数据。内勤数据会自动同步至s-HR打卡记录表；外勤数据会同步至s-HR移动签到审核表，审核状态为未审核，需在s-HRweb端进行移动签到审核后，外勤数据才会在打卡记录表显示（审核同意不需要走工作流）。2.2云之家签到（外勤确认）该接口会同步绑定管理员默认工作圈中的签到数据。内勤数据会自动同步至s-HR打卡记录表；已确认过的外勤数据同步至s-HR移动签到审核处，并标记为“同意”，且同步至s-HR打卡记录表；未确认过的外勤数据同步s-HR移动签到审核处，也可以在s-HRweb端进行移动签到审核。2.3云之家签到（外勤确认）推荐使用该接口会同步绑定管理员默认工作圈中的签到数据。内勤数据会自动同步至s-HR打卡记录表；已确认过的外勤数据同步至s-HR移动签到审核处，并标记为“同意”，且同步至s-HR打卡记录表；未确认过的外勤数据同步s-HR移动签到审核处，也可以在s-HRweb端进行移动签到审核。2.4云之家签到同步201906版该本接口旨在修复数据遗漏问题。该接口会同步绑定管理员默认工作圈中的签到数据。内勤数据会自动同步至s-HR打卡记录表；已确认过的外勤数据同步至s-HR移动签到审核处，并标记为“同意”，且同步至s-HR打卡记录表；未确认过的外勤数据同步s-HR移动签到审核处，也可以在s-HRweb端进行移动签到审核。三、数据同步提示:将云之家打卡数据同步到s-HR系统有两种方式：后台事务同步和前台手动同步，同步之前请确保前面的授权操作顺利完成。3.1后台同步路径：登录s-HR客户端->系统平台->后台事务->事务定义->后台事务定义->人力资源（s-HR）->假勤管理->云之家签到数据同步【说明】：首次同步会从2015-01-01开始同步，时间会比较长，建议修改同步时间，改为云之家有签到记录的时间。后续同步会同步前一天和当天两天的签到数据。如果不需要从这个时间点开始执行，可以修改表时间(修改下面语句标红的时间点即可)：Updatet_hr_ats_bizdatasynchassistsetflastsynchtime={ts'2017-08-0100:00:00'}wherefid='bSvNRciAEU6cJb24RAS0lKlojLM='3.2手动同步路径：s-HR系统->考勤管理->打卡记录->云之家签到同步四、FAQ4.1、关于外勤打卡数据的审核操作？审核操作支持云之家和s-HR审核，所有接口同步到的未审核的外勤数据都可以在s-HR进行审核，一旦经过审核操作，将不能再次审核。4.2、什么是外勤打卡？在云之家设置的打卡地点之内的数据属于内勤打卡，也就正常打卡，否则称为外勤打卡。内勤打卡会直接同步到打卡记录表，外勤打卡都会在移动签到审核表中有一份记录，而审核通过的外勤同时也会存在打卡记录表中。4.3、所有或某段时间云之家签到数据都没有同步到s-HR中？检查s-HR中同步事务是否正常执行（可在WEB端后台事务监控处检查）。如果执行成功，请检查事务监控看板内的日志信息；如果执行失败，可按事务监控看板内的提示信息检查，可能的原因有：原因1：网络问题，本地服务器访问云之家接口延时，超时等，需检查本地网关是否允许对云之家的访问或网络稳定性（可查看apusic日志，是否有超时、500等错误）原因2：云之家签到接口不通或鉴权信息未完善，先完善鉴权信息。原因3：apusic服务器拦截了云之家对OSF接口的访问，需要将云之家服务器地址加入apusic服务器的安全访问白名单（默认已配置白名单）4.4、后台同步事务成功完成，部分员工签到数据没有同步到s-HR系统原因：可按事务监控看板内的异常提示信息检查，s-HR中用户与云之家用户映射关系有异常，同一个员工存在多个映射或找不到映射关系（找不到映射关系有一种特殊情况是员工已离职。离职员工无法进行签到数据同步，可以进行打卡记录导入。BOS已出补丁修复，离职员工不删映射关系，补丁号：PT117697）修复：根据事务监控看板内的异常提示信息，利用s-HR中云之家用户同步功能，修复对应员工与云之家的用户映射关系，然后针对性选择异常员工单独进行同步，或修改开始同步时间重新执行任务全部同步。4.5、云之家部分员工的数据未同步成功，如何重新同步？见FAQ4.4，针对性选择异常员工单独进行同步，或修改开始同步时间重新执行任务全部同步。4.6、拍照签到与外勤确认待办的关系拍照签到与外勤确认待办是不一样的，拍照签到是正常内外勤签到的补充。特别是在无法签到的异常情况下可使用。拍照签到记录需要负责人（包括兼职负责人；若无部门负责人，将由管理员审核）审核后才可作为有效的签到记录。，若未审核或审核不通过，都不会同步到至s-HR系统。内勤的拍照签到，云之家审核后，会同步到s-HR的打卡记录表；外勤的拍照签到，云之家审核后，会变为有效的外勤记录，旧接口（云之家签到）会同步到s-HR的“移动签到审核”；新接口（云之家签到（外勤确认））会同步到“移动签到审核”并标记为“同意”，且同步到“打卡记录”表。4.7、移动端外勤确认相关问题4.7.1、云之家外勤由谁确认？外勤确认分为自动确认和部门负责人确认。4.7.2、负责人如何确认部门的外勤记录？方法1：进入“云之家-签到-签到统计”，查看团队外勤记录并确认方法2：通过每天推送的待办消息中进入查看并确认4.7.3、为什么负责人没有收到待办消息呢？请先确认部门中是否有员工进行了外勤签到。其次，外勤待办消息隔天推送，负责人会在第二天收到外勤确认消息4.7.4、外勤未确认的记录会同步么？会同步至s-HR系统的“移动签到审核”表，也可以由专员在WEB端进行同意确认。（详细可参考FAQ4.2：启用不同接口，哪些数据会同步至s-HR“打卡记录”，哪些数据会同步至“移动签到审核”）4.7.5、非当天确认的记录如何同步？非当天确认的记录，将在确认后，同步任务执行后，重新同步至s-HR系统。4.8关于资源授权oAuth2.0私有云同步数据的配置使用2.0方式鉴权的接口按本文档配置后可不用绑定云之家管理员，当切换到1.0版本的鉴权时还是要绑定云之家管理员的，所以在切换接口的时候请注意接口鉴权方式。另外，若同步为私有云，私有云的地址在原来的方式中要配置，同时，在参数设置里面也要设置。
