1考勤扩展与集成2019年7月HR产品事业部2纲要0102考勤单据写入s-HR系统考勤计算二次开发考勤机同步033考勤单据同步到s-HR系统4第三方系统取s-HR主数据信息osfshr_sso_client.jar2.请假单写入请求5.返回json数据http1.调用接口(saveLeaveBill)6.返回数据单点认证osf服务引擎s-HR系统3.认证通过4.调用osf（写入请假单据）第三方系统（OA，钉钉）比如：单据流程审批在OA，员工的出勤明细在s-HR查看什么情况下要单据写入s-HR系统？5考勤单据写入s-HR系统怎样同步到s-HR系统？通过金蝶s-HR强大的OSF（OpenServiceFramework）框架前提：配置单点6http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=saveLeaveBill&timeOffApplyType=JQLX000001Y&timeOffStartDate=2016-11-0808:00:00&timeOffEndDate=2016-11-0818:00:00&excuse=test&leaveLength=1&personNum=27460服务名:saveLeaveBill参数说明：timeOffApplyType：申请的假期类型编码timeOffStartDate：开始时间timeOffEndDate：结束时间excuse：请假原因(非必填)leaveLength：请假时长personNum：请假申请人请假单同步s-HR系统7http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=saveFillCardRecord&fillcardDate=2016-11-07&filecardTime=08:00&fillcardReason=002&fillcardRemark=kingdeetest&personNum=27460服务名:saveFillCardRecord参数说明：fillcardDate：补卡日期filecardTime：补签卡时间点fillcardReason：补签卡原因编号fillcardRemark：备注(非必填)personNum：补签员工编号补签卡同步s-HR系统8http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=saveOverTimeBill&oTdate=2016-11-08&realStartTime=2016-11-0108:00:00&realEndTime=2016-11-0820:00:00&restTime=0&applyOTTime=2&otType=001&otReason=001&otCompens=002&description=&personNum=27460服务名:saveOverTimeBill参数说明：oTdate：加班日期realStartTime：实际加班开始时间realEndTime：实际加班结束时间restTime：休息时长applyOTTime：加班小时数otType：加班类型编码otReason：加班原因编码otCompens：加班补偿方式编码description：描述(非必填)personNum：加班申请人编码加班单同步s-HR系统9http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=saveTripBill&tripStartPlace=sz&tripEndPlace=sh&tripType=001&tripStartTime=2016-11-0808:00:00&tripEndTime=2016-11-0818:00:00&tripDays=1&tripReason=001&personNum=27460服务名:saveTripBill参数说明：tripStartPlace：出发地点tripEndPlace：目的地点tripType：出差类型编号tripStartTime：出差开始时间tripEndTime：出差结束时间tripDays：出差天数tripReason：出差原因personNum：出差申请人出差单同步s-HR系统108.5±£´æµ¥¾Ý½Ó¿Ú8.5版本部分OSF接口第三方系统调用是可能会报错，需要在补丁PT134017基础上部署以下私包，该私包功能将在8.5后续补丁纳入。接口私包11考勤计算二次开发12为什么需要考勤计算二次开发考勤计算整体结构以及数据封装介绍内置项目二次开发的过程考勤自定义项目自定义函数13为什么需要考勤计算二次开发14一、什么是考勤以及什么是考勤计算考勤计算是考勤模块计算员工每天的出勤情况（比如迟到、早退、旷工等）的功能模块二、为什么需要考勤计算二次开发s-HR考勤计算是考勤业务中的重要一环，随着代码的不停迭代，目前的考勤计算功能已经能够高效准确地完成既定的任务。但是，考虑到业务的多样性和延展性，出厂的考勤计算功能可能不能100%地满足每个公司的业务需求，为了让广大客户能够更全面的使用和更个性化地定制自己的业务，在最新版本的系统中，考勤计算已经能具有一定继承性和扩展性，可以进行深度的二次开发。二、考勤计算二次开发途径有哪些所谓的二次开发，就是基于目前考勤计算框架，在现有的软件上进行定制修改，功能的扩展，然后达到自己想要的功能。而考勤计算的二次开发，主要包括以下两方面的内容：1、考勤内置项目计算的重写开发；2、考勤自定义项目自定义函数的扩展开发；考勤计算二次开发15考勤计算整体结构介绍16考勤项目考勤项目：针对员工日常出勤情况的考核项，比如请假、加班、出差等17考勤计算器计算器：考勤计算的计算器是二次开发的主要内容，它包含了考勤计算全部内置项目的计算，一个业务可能有一到两个计算器，每个计算器对应了一个类，每个类中计算了多个内置考勤项目（可以在考勤计算二开文档中查看）在考勤制制度中各块业务的选项卡中可以配置，依次为：异常：只有一个计算器，只会在打卡考勤中生效；请假：分为打卡考勤/不打卡考勤两个计算器；出差：分为打卡考勤/不打卡考勤两个计算器；加班：分为打卡考勤/不打卡考勤两个计算器；取卡：只有一个计算器，只会在打卡考勤中生效；其他：分为打卡考勤/不打卡考勤两个计算器；注意：严禁修改出厂计算器对应的后台类。18考勤计算整体结构扩展点：计算器以及自定义平台19计算器20内置项目计算器整体结构不打卡请假不打卡加班不打卡出差不打卡其他打卡异常打卡其他打卡加班打卡出差打卡请假取卡计算21计算器取卡结构注意：FetchCardPro只是取卡计算的入口，FetchCardInf是取卡计算的真正逻辑,两者是组合关系一段取卡二段取卡三段取卡22数据准备IcalAttendanceProjects接口+Process(Contextctx,Mapparam,AttendanceDynamicResInforesult)所有的计算器必须实现IcalAttendanceProjects接口通过param.get(“globalMap”)获取globeMap。（globeMap中的具体数据结构请参考考勤计算二次开发文档）在整个计算过程中，不进行数据库交互整个数据准备分为两部分：一、与人员、日期无关的静态数据（考勤制度、班次设置）二、与人员、日期相关的动态数据（排班信息、打卡、请假）所有的数据来源都已经封装在MapglobeMapAttendanceDynamicResInfo是对应考勤明细记录实体，每个内置考勤项目都有对应的字段，每次计算都回更新对应的项目值23内置项目二次开发的过程24内置项目二次开发的过程一、确定需要重写的项目，以及继承对应项目的计算器二、在对应的考勤制度配置自身实现类路径三、具体自身业务的实现逻辑四、具体项目值的保存（AttendanceDynamicResInfo）25示例演示接下来将展示考勤计算那种【异常】业务相关的二次开发。¿¼ÇÚ¼ÆËã¶þ´Î¿ª·¢Îĵµ注意：二次计算结果要覆盖掉AttendanceDynamicResInfo中对应的项目值；某个计算器对应的考勤项目请参考二次开发文档26考勤自定义项目自定义函数27自定义考勤项目计算自定义的考勤项目计算是基于公式平台的，通过定制自定义公式，调用自定义函数实现考勤结果的二次运算。考勤计算公式在【考勤制度】-点击某个考勤制度-【计算公式】页面可以配置自定义公式，自定义公式是基于自定义函数的，通过一个或多个函数的组合运算，得到自定义公式。自定义函数自定义函数在用administrator登录后，在【核算函数】页面配置28自定义考勤项目计算目前【核算函数】内置了若干个考勤相关的函数，对于内置函数不能满足需求的，可以进行自定义函数的二次开发。一个函数对应了后台类的一个方法，若要自定义函数的开发，首先必须进行后台方法的实现，然后再在【核算函数】页面进行函数的注册配置。函数体的书写格式参考上图传入参数必须和实现方法一一对应。注：禁止修改内置的自定义函数。注意性能！~！29内置考勤函数30考勤预置OSF及考勤机集成方案31考勤预置OSF及考勤机集成方案考勤机s-HR通过getAttendanceFilesOSF获取档案实体返回json格式的考勤档案通过transmitPunchCardRecordOSF返回插入成功条数考勤机编号，考勤编号，打卡日期，打卡时间点¿¼ÇÚosfʹÓÃÏêÇé打卡数据考勤档案32getAttendanceFiles33直接调用举例：（登陆shr后可以直接将下面的连接放到浏览器地址栏看运行结果）http://192.168.66.86:6991/shr/shrosf.jsp?serviceName=getAttendanceFiles¶m={'rows':'2','page':'1','transmitStartTime':'1900-01-01','flag':'add'}返回数据格式举例：{"errorMsg":"","data":{"totalPage":10,"attendanceFileList":[{"adminOrgUnit.displayName":"环球集团_环球集团本部_集团人力资源服务中心_人力发展部_组织人事部","attendanceNum":"10875","position.name":"培训专员","attendFileState":"1","adminOrgUnit.name":"组织人事部","proposer.id":"60Cjl1IpQ1S2qkQIDPETOYDvfe0=","flag":"add","proposer.name":"陈君","proposer.number":"10875"},{"adminOrgUnit.displayName":"环球集团_环球集团本部_集团人力资源服务中心_人力发展部_组织人事部","attendanceNum":"10876","position.name":"培训专员","attendFileState":"1","adminOrgUnit.name":"组织人事部","proposer.id":"Ch+/39OqSBijZWUfJRVZQYDvfe0=","flag":"add","proposer.name":"陈飞扬","proposer.number":"10876"}],"totalRecords":20,"realRows":2,"realPage":1},"msgCode":"200","sucess":"true"}34transmitPunchCardRecord353、直接调用举例：http://192.168.66.86:6991/shr/shrosf.jsp?serviceName=transmitPunchCardRecord¶m={'records':[{'EquNo':'0008','CardId':'10875','RecDate':'2014-11-11','RecTime':'08:21:20'},{'EquNo':'0008','CardId':'10876','RecDate':'2014-11-11','RecTime':'11:00:20'}]}返回结果举例：{"errorMsg":"","data":{"notExistRecords":[],"formatErrorRecords":[],"recordCtn":2,"duplicateRecords":[],"successCtn":2},"msgCode":"200","sucess":"true"}Mapparam=newHashMap();param.put("records","[{'EquNo':'0008','CardId':'10875','RecDate':'2014-11-11','RecTime':'08:21:20'},{'EquNo':'0008','CardId':'10876','RecDate':'2014-11-11','RecTime':'11:00:20'}]");Responsers=shrClient.execute(request,"transmitPunchCardRecord",param);注意参数，只一个参数record，参数值是json数组36添加考勤设备，设备编号对应EquNo参数37Thanksterimakasih感謝谢谢ありがとうขอบคุ�ณ
