金蝶s-HR-2019二开培训基础.pptx

1s-HR二次开发基础HR产品事业部2019-07-052纲要01s-HR框架技术体系02BIM基础DEP基础平台基础权限项菜单0304050607OSF08091011信息集导入配置部署&调试3s-HR框架技术体系4章节概述本章节培训内容s-HR开发框架技术体系本章节预期目标了解s-HR开发框架技术体系5相同底层的bos平台是一样的，包括元数据引擎、数据库引擎、消息引擎等都使用apusic中间件不同WebServer层不一样应用架构不一样核心应用不一样s-HR框架-与eas框架差别6s-HR框架-部署架构图利用开源软件作为反向代理和负载均衡、前端缓存装置。WebServer高可用：会话状态的持久化支持。7s-HR框架-技术架构图人事服务云薪酬服务云培训服务云时间管理云招聘服务云行业方案云组织档案岗位档案员工档案人事事务薪酬核算考勤管理人力效能人力成本人力发展扩展应用绩效流程扩展插件档案扩展插件烟草行业组件国资委组件考勤机二代身份证读卡器扩展行业设备核心应用元数据引擎数据库引擎规则引擎消息引擎国际化引擎工作流引擎数据转换引擎安全引擎WIF（WebInteractionFramework）前端交互框架OSF（OpenServiceFramework）开放服务框架S-HR应用架构BOS平台8s-HR框架-J2EE架构J2EE服务器J2EE服务器DBDBORM-RPCServer业务POJOOrmappingBussinessInterfaceSwingClientSwingClient界面框架ORM-RPCClientWebClientWebClientWeb框架WebServerJMSJMS基础服务组件基础服务组件工作流……EJBContainer…事务SessionBeanEJB容器EJB容器CacheDBCacheDB业务开发切入点业务开发切入点9s-HR框架-ORM-RPCRPC层对象Proxy本地对象JDK通讯层RPC层对象stub远程对象接口JDK通讯层TCP/IPTCP/IPRPCRPCCallCallMarshalMarshal10s-HR框架-面向伙伴的开放平台服务开放：OSF提供标准、安全的系统信息及业务服务，可通过任何第三方系统调用，支持用户级扩展；前端开放：WIF提供前端页面集成框架，能够通过自定义视图方式嵌入任意html页面；应用开放：通过应用规范约束的系统应用和第三方应用能够方便得在系统中安装和卸载，并支持热部署；作为企业组织、人员信息来源，HR系统如何更小成本得为其它系统提供信息服务？伙伴如何更加方便得进行系统扩展？OSFOpenServiceFrameworkWIFWebInterationFramework列表视图表单视图搜索视图核心视图视图管理、解析引擎主框架XHTML*.jsCrossFilter*.cssLessBootStrap服务注册、OpenAPI服务监控、安全管理员工信息服务薪酬服务…….人事变更服务云之家集成服务…….组织信息服务第三方服务11s-HR框架-WIF前端交互框架12s-HR框架-技术架构AppServerWebServerClientDBKSQLO/RMappingBusinessModelBusinessModelExtendBusiness/QueryInterfaceBusinessPOJO/ExtendORM-RPCServerMetadataEngineActionViewFormViewListViewKanbanView…ViewExtendTextFieldWidgetEventDateFieldSearch…F7/TagFieldEnumFieldORM-RPCJSONServiceDelegateContainerLayoutServiceDefineSHRURLThird-PartyRequestHTTPJSONQueryEngine纯正的EASBOS血统融合DEP优秀设计确保稳定性与大并发成果复用独创OSF与WIF体系确保系统开放性与开发效率保障前端扩展的灵活性基于Html5保障体验与交互性能移动应用13s-HR框架-OSF开放服务框架14s-HR框架-业务开发切入点WIF（视图）业务界面使用OSF数据接口使用handlerWebserver使用Controllerbeanappserver使用dep动态扩展使用Js、cssWeb界面使用15BIM基础16章节概述本章节培训内容认识BOS设计工具如何使用BOS设计工具注意事项本章节预期目标能够运用BOS设计工具进行设计17BIM基础-简介BIMBOS设计开发工具，生成元数据和核心代码；工作流配置等。18BIM基础-方案引入19BIM基础-可创建元数据种类entity，实体table，数据表façade，功能relation，实体关系query，查询exception，异常enum，枚举ui，GUI的界面function，函数permission，权限…20BIM基础-继承体系CoreBase，所有实体基类ObjectBase，对象基类CoreBillBase，业务单据基类CoreBillEntryBase，业务单据分录基类DataBase，基础资料基类TreeBase，树形基础资料基类HRBillBase，s-HR业务单据基类HRBillBaseEntry，s-HR业务单据分录基类SHRBaseItem，s-HR集团管控基础资料基类（8.5新增）BaseItemRelationHR，s-HR集团管控基础资料可使用关系基类（8.5新增）21BIM基础-扩展属性22扩展属性，支持工作流在web的portal上打开和审批pureWFBillUrl:/shr/dynamic.do?uipk={单据视图uipk}&isShrBill=true注：pureWFBillUrl此属性需要直接修改xxx.entity来增加isSupportWeb:truewebEditUI:/dynamic.do?uipk={单据视图uipk}编码规则:codingRuleEnabled，true开启编码规则组织属性:OrgType，业务单据HRO，其他看情况配置其他属性看说明工作流参考实体：CmpWorkFlowMainBillBIM基础-扩展属性（续）23BIM基础-发布&部署24BIM基础-注意事项s-HR自定义元数据开发的服务端目录com.kingdee.shr.custom.app下s-HR自定义元数据开发的客户端目录com.kingdee.shr.custom.client下注意添加逻辑键注意元数据检查方法事务的定义主键区分子系统，如：PK_SHR_XXXX合理创建索引，索引名区分子系统，如：IX_SHR_XXX存中文的字段注意使用多语言，类型使用NVARCHAR数值枚举、布尔类型，注意建表语句的默认值关联属性命名格式：FPropertyNameID25BIM基础-demoCustomDemo继承SHRBaseItem,以集团管控基础资料为例26DEP27章节概述本章节培训内容认识DEP本章节预期目标能够运用DEP进行元数据扩展28DEP-常用模板介绍模板名称模板编码模板业务单元说明员工单行页签EmpSinglePagecom.kingdee.eas.hr.emp.EmpSingleInfoCustom对应s-HRweb端员工单行表页签模板基础资料DataBasecom.kingdee.eas.ep.DataBaseCustom对应EAS基础资料模板多级明细基础资料TreeDetailcom.kingdee.eas.ep.TreeDetailCustom对应EAS多级明细基础资料模板分级基础资料TreeBasecom.kingdee.eas.ep.TreeBaseCustom对应EAS分级基础资料模板业务单据CoreBillBasecom.kingdee.eas.ep.CoreBillBaseCustom对应EAS单据模板s-HR基础资料实例模板BaseItemCustomcom.kingdee.shr.base.syssetting.BaseItemCustom对应s-HRweb端集团管控基础资料模板（8.5新增）员工多行页签EmpMultiPagecom.kingdee.eas.hr.emp.EmpMultiInfoCustom对应s-HRweb端员工多行页签模板s-HR业务单据基类模板HRBillBaseCustomcom.kingdee.eas.hr.base.SHRBillBaseTemplate对应s-HRWeb端单据模板（8.5新增）29DEP-介绍动态元数据扩展平台路径：业务员登录，企业建模->动态扩展平台高级版30DEP-步奏新建步奏需求分析，合理使用模板通过从模板复制创建动态元数据对创建的动态元数据，维护需要的属性保存启用在产品元数据上扩展需求分析，需要对那个元数据扩展通过方案的实体，将扩展元数据实体导入扩展需要属性保存启用31DEP-demoDepDemo从模板s-HR基础资料实例模板复制，生成基础资料对Person属性扩展32平台基础介绍33章节概述本章节培训内容了解平台核心功能了解一个session整个生命周期视图配置自定义业务逻辑本章节预期目标基本能够进行二次开发34shr_syssetting:s-HR平台服务端工程shr_baseconfig：结构配置、查询配置等服务端工程（8.5新）shr_permission:s-HR平台权限服务端工程（8.5新）shr_attachment:s-HR平台附件服务端工程（8.5新）shr_websso:s-HR平台单点登录服务端工程（8.5新）shr_shrimport:s-HR平台导入服务端工程（8.5新）shr_syssetting_web：s-HR平台web端核心工程shr_system_web:s-HR平台web端安全工程commonplate：s-HR平台web端通用逻辑处理工程commonservice:s-HR平台web端通用逻辑处理工程businesssetting:s-HR平台web端平台业务处理工程permission：s-HR平台web端权限处理工程（8.5新）平台基础-平台工程认识35平台基础-执行顺序1、拦截器：ShrDispatcherInterceptorlicense验权、权限项验权、部分上下文处理，ShrServiceInjectInterceptorBOS服务注入,如Controller层的远程BO对象的自动获取与注入，DynamicWebInterceptor用户上下文、对象转换（将前端的json串转换成对应元数据对象）2、视图解析：DBTemplateLoader，ITemplateTranslator，负责视图解析成freemarker模板并写入缓存3、spring的servlet：DispatcherServlet，负责控制跳转4、s-HR核心的控制器:DynamicController，DispatcherServlet转给DynamicController，指定给对应的XXXXHandler，调试的主要入口（DynamicController.executeAction()）5、s-HR处理器的类加载器：MsfClassLoaderFactory，负责通过视图配置，找到对应的处理器XXXXHandler，只有{安装目录}\eas\server\lib\addon\*.*的所有jar，通过此类加载器加载6、s-HR的所有处理器：ICoreHandler，对应是各个功能的具体处理器，在此处理里面调用BIMBOS设计器的EJB业务处理逻辑，并返回处理结果36平台基础-处理器体系各领域处理器，需根据需要分层继承平台处理器列表：继承ListHandler，表单：继承EditHandler，树形表单：继承TreeEditHandler37视图配置视图配置的js里的方法deleteAction:function(){}或者defaultActionHandle:function(option){}XXXHandler的publicStringdeleteAction(HttpServletRequestrequest,HttpServletResponseresponse,ModelMapmodelMap)throwsSHRWebException{}方法触发事件调用对应的js方法如果js没有设置对应的xxAction方法则js框架默认调用defaultActionHandle方法，然后调用视图配置对应的handler处理调用handler平台基础-js和handler方法映射38处理器对服务端异常处理：平台异常处理器：ShrExceptionHandlerResolver-对BOSException处理，不显示具体错误-对EASBizException处理，显示业务错误-对SHRWebException处理，不显示具体错误-对ShrWebBizException处理，显示业务错误服务器端抛出BOSException，捕获后抛出SHRWebException服务器端抛出EASBizException，捕获后抛出ShrWebBizException其他错误根据业务场景对用抛出平台基础-异常处理39平台基础-视图视图：整个s-HRweb端的核心，原理通过自定义freemarker指令，并通过视图解析引擎生成对应freemarker模板，最终渲染出页面，90%的页面都是通过视图配置。配置路径：管理员登录s-HR->开发平台->视图帮助文档路径：点击用户头像，选择帮助，打开连接，下载系统平台对应帮助文档指令定义路径：{安装目录}\eas\server\deploy\easweb.ear\shr_web.war\WEB-INF\freemarker，有兴趣可在此处找到视图配置的绝大部分指令标准视图扩展：按文档和指令操作，不详叙新增二开视图：按文档和指令操作，不详叙s-HR8.5ÊÓͼ³£ÓÃÖ¸Áî˵Ã÷s-HR8.5Ç°¶Ë¿Ø¼þ²Ù×÷4040Administrator配置页面Translator解析配置s-HRWidget组件加载DB存储配置Freemarker页面加载HTML5最终页面STEP01STEP02STEP03STEP06STEP05STEP04平台基础-视图解析流程41平台基础-视图对应4242平台基础-js继承体系43视图-demoCustomDemo对应表单、列表、搜索、F7、处理器、js等创建DepDemo对应表单、列表、搜索、F7、处理器、js等创建（不演示）对Person属性扩展视图扩展基础资料自动生成视图说明44权限项45章节概述本章节培训内容认识权限项权限项配置权限项使用本章节预期目标能配置权限项，对页面或者按钮做权限控制46权限跟人员,角色有关。是该角色的人员拥有该角色的权限菜单权限配置菜单时,如果权限项为空则默认显示，不为空，则按照该员工，角色拥有的权限项来显示按钮权限根据页面的uipk和按钮方法,匹配权限项中的url另外通过权限现实按钮显示不显示(这需要写代码实现)权限项-介绍47--员工信息初始化--员工信息维护--员工其他变动--员工变动管理--人事事务单据--员工明细查询--员工任职变动查询--人事统计分析报表--劳动合同--其他合同权限配置一个权限项可以控制多个操作入口权限项-web端定义和修改48与组织关系•无-按任意组织分配•管理单元-按管理单元分配•HR组织-按HR组织分配类型•系统管理功能-系统管理员默认拥有，不支持分配•业务管理功能-系统管理员和授权权用户默认拥有，不支持分配•业务功能-分配使用•综合功能-系统管理员默认拥有，支持分配注：二开配置权限项，请按红色字体标记选择操作类型•读•新增•修改•删除•执行•其他权限项-属性说明49权限项-配置方法URL配置格式：/dynamic.do?method=method#uri=uipkmethod:http或ajax请求服务端的真正方法名称，为空时候默认方法initalizeuipk:页面的uipk，可通过视图找到50按钮权限拦截器，对请求进行权限校验菜单权限登陆页面，serviceMenu.do缓存（localStorage）到浏览器端数据权限根据视图配置，对特殊页面进行数据权限过滤，8.5新增视图指令，进行数据验权{perm:{adminOrgField":"adminOrg","hrOrgField":"hrOrg","isDefaultManage":"isDefaultManage","checkMode":"server"}}注：1、adminOrgField的值，可以配置多个，用英文的逗号分开，验证行政组织范围权限2、hrOrgField的值，可以配置多个，用英文的逗号分开，验证业务组织范围权限3、isDefaultManage的值，只能有一个，验证默认委托4、checkMode的值，可选，client（web端验权）和server（服务端验证）中的一个，默认是server，5、checkRule的值,可以选值(OU、BU)分别表示按照行政组织验证、按照业务行政组织验证权限项-使用51--员工其他变动--员工变动管理--人事事务单据--员工明细查询--员工任职变动查询--人事统计分析报表--劳动合同--其他合同使用系统管理员登陆客户端通过用户管理，可以维护组织范围、查看权限、分配权限、分配角色通过角色管理，可以维护角色、角色分配权限、角色分配用户、角色查看权限、角色查看用户用户权限范围=用户拥有的角色的权限+用户直接分配的权限注：这里的权限是业务组织权限权限项-GUI授权52--员工信息初始化--员工信息维护--员工其他变动--员工变动管理--人事事务单据--员工明细查询--员工任职变动查询--人事统计分析报表--劳动合同--其他合同使用系统管理员登陆客户端通过用户管理【维护HR特殊权限】按钮进入界面，可以查看权限、分配权限。HR特殊权限是对行政组织的范围权限。权限项-HR特殊权限53权限项-demoDepDemo列表54菜单55章节概述本章节培训内容认识菜单菜单配置本章节预期目标自己能够配置菜单56菜单-简介57菜单-demoDepDemo列表58OSF59章节概述本章节培训内容认识OSF(OpenServiceFramework)配置和开发OSF调用OSF本章节预期目标开发OSF使用OSF60梳理OSF业务需求分析业务需求，了解OSF需要哪些参数，返回数据格式要求创建OSFadministrator用户登录s-HR系统，开发平台基础设置OSF配置->创建编写OSF实现类根据配置的实现类名称编写OSF实现类配置OSF（8个字段）编号、服务类型、名称、服务级别、所属领域、服务名称、类别、配置保存OSFOSF配置信息保存到数据库中启用OSFOSF运行引擎只会加载已启用的OSF重启s-HR服务器重新加载OSF类信息OSF-定义61OSF-配置说明编码：不重复即可名称：符合业务语义，一般是中文服务类型：本地服务服务级别:一般选择领域或者模块级别所属领域:根据业务，EMP-员工，ORG-组织，CMP-薪酬，ATS-考勤，PERF-绩效，TRAIN-培训服务名称：英文字符类型，调用的服务名，后缀为Ext，如:getPersonInfoExt类别：二开的OSF选择客制化开发服务配置：参考OSF配置模板(可参考系统任意一个OSF作为模板)62OSF-配置描述63如何编写OSF实现类定义一个java类，实现com.kingdee.bos.bsf.service.app.IHRMsfService接口实现process方法编写业务逻辑构造数据结构原则：java.util.Map对应js的对象，java.util.List对应js数组返回构造的数据，通常是java.util.Map对象OSF-编写实现类64OSF-自定义实现类1231.实现IHRMsfService接口2.实现process方法3.编写业务逻辑代码4.组装返回对象（按照需求构造数据结构，java.util.Map对应js的对象，java.util.List对应js数组）65OSF-执行流程逻辑写在这里661、服务端调用MSFServiceFacadeFactory.getLocalInstance(ctx).processService(serviceName,param)2、web端调用shr.js中callService方法shr.callService({serviceName:'GetWFNextPersonService',param:{param1:param1,param2:param2,…}});3、外部调用，需单点登录，在外部集成和单点登录中说明OSF-调用方式67OSF-常见问题请求流程未到达OSF实现类报错的可能原因OSF没有启用服务名称与传入的值不相同配置中的class属性值与实现类不匹配实现类有没有加载到虚拟机请求流程执行到OSF实现类报错业务实现代码检查，如参数、非空校验等68信息集69章节概述本章节培训内容认识结构配置和查询配置能够自己配置使用结构配置和查询配置本章节预期目标配置结构配置和查询配置使用结构配置和查询配置70定义：信息集是结构配置和查询配置的简称，又称查询结构配置，是s-HR系统定义的，基于BOS实体元数据的关联逻辑，通过对定义的父节点和关联属性将一些元数据关联起来。在运行期基于查询结构配置中的关联关系动态解析成sql语句，到达动态查询效果解决什么问题：查询多个有关联的实体元数据的时候，可以动态增加查询字段根据业务要求自定义数据源信息集-介绍71信息集-配置步骤1.BIM或者DEP维护元数据实体2.基于元数据实体，维护结构配置，如果是DEP扩展了现有结构配置实体，会自动生成结构配置3.基于结构配置，维护查询配置72结构配置是信息集应用的基础，实体与实体之间的引用关系、实体展示属性、条件限制等的定义。正向关联：父对象实体上保存子对象的id，从而与子对象进行关联反向关联：子对象实体上保存父对象实体的id，从而实现关联信息集-结构配置73查询配置是多个结构配置的属性集合。信息集-查询配置74动态列表导出模板页面设置方案过滤方案中高级过滤s-HR报表工具注意：通过查询结构配置生成的SQL语句只支持左连接信息集-何时使用75信息集-列举76信息集打开报空白等错使用信息集的动态列表，添加某些字段就会导致查询不到数据下载模板，一点下载模板就变成空白界面导出没有数据或者数据不对报表数据源报sql错误信息集-常见错误77信息集-demoDepDemo挂载在Person上，通过动态列表展示出来78导入配置79章节概述本章节培训内容配置导入模板使用导入功能本章节预期目标能够自行配置导入模板使用导入模板导入数据80导入配置-介绍81ImportInfoHandler中newImportTaskAction，视图界面配置button“importData”，名字不同，需js自行处理导入配置-使用82导入-demoDepDemo导入一条数据83部署&调试84本章节内容应用的目录结构认识怎么部署调试代码部署调试过程中有那些配置信息和注意事项解决生产环境启动集群，提示非法组件目标知道怎么部署知道怎么调试有不同的部署方式章节概述85部署&调试-二开开发模式配置1、{安装目录}\eas\server\bin\common.pm，以F:/develop/sHR为安装目录说明26行切换开发模式将$DEVELOP_MODE=“false”改为$DEVELOP_MODE=“true”188行$EAS_USER_LIB_FILE=“XXX”改成自己的配置文件路径，如：$EAS_USER_LIB_FILE="F:/develop/sHR/dev/server-user.liblist";192行$METAS_PATH=.$METAS_PATH;修改成前缀为自己元数据发布目录，如：$METAS_PATH=F:/develop/sHR/work/SHR820SP2/deployed_metas;=.$METAS_PATH;2、配置classes输出目录位置的文件server-user.liblist内容配置，如：F:\develop\sHR\dev\server-user.liblist,classes输出目录位置:F:\develop\sHR\workspace\dev\bin86部署&调试-二开开发模式配置(续){安装目录}\eas\server\profiles\server1\config\vm.properties添加前缀为自己元数据发布目录，用分号隔开，如：F:/develop/sHR850/work/sHR850/deployed_metas;（F:/develop/sHR850/work为元数据工作空间目录）87部署&调试-二开开发模式配置(续)自定义的handler继承至产品标准handler，在debug时候报ClassNotFoundException二开环境做如下调整：将{安装目录}\eas\server\lib\addon复制到{安装目录}\eas\server\lib\sp里面重启服务注：这个只限于开发环境调试代码，测试环境和正式环境还是正常部署88部署&调试-二次开发工程结构dev.zipdemo-metas.zip1、dev.zip解压后，可用eclipse导入，形成二开工程，里面含有一个简单的二开工程demo2、demo-metas.zip包含了二开demo的元数据，解压后可以直接复制到{元数据工作空间}/{导入方案名称}/metadata下，并进行发布89部署&调试-userlib生成和引入1、将generateliberary.bat文件，复制到本地s-HR的{安装目录}下，如图1，图中安装目录为sHR2、运行generateliberary.bat文件，会生成devlib_for_user.userlibraries，如图23、将devlib_for_user.userlibraries复制到{安装目录}\dev下，图中安装目录为sHR4、eclipse引入userlib，如图35、js等资源文件构建脚本，build.xml图1图2图3build.xmlgenerateliberary90部署&调试-目录介绍{安装目录}\eas\server\lib\sp--bos设计器发布的ejb服务端代码{安装目录}\eas\server\metas\sp--bos设计器发布的元数据{安装目录}\eas\server\deploy\fileserver.ear\easWebClient\lib\sp--bos设计器发布的ejb客户端代码{安装目录}\eas\server\deploy\fileserver.ear\easWebClient\metas\sp--bos设计器发布的元数据{安装目录}\eas\server\lib\addon\customer\lib--s-HR前端交互的web代码，如：**Handler.class{安装目录}\eas\server\deploy\easweb.ear\shr_web.war\addon\customer\web--s-HR前端交互的web资源文件，如css，js，图片等二开*Handler.class字节码jar放置目录二开js，css，图片等资源文件放置目录91什么时候使用customer包形式部署？，什么时候使用sp目录部署？如果没有新增、修改元数据或者修改ControllerBean等appserver层内容的情况下使用webserver应用包形式在有修改元数据或者ControllerBean等appserver层内容是是必须要sp部署的，如果没有js、handler等webserver层内容时，可以不包含webserver应用包部署，否则就要保护webserver应用包部署方式部署&调试-方式选择92部署&调试-apusic9从apusic9开始第三方登录s-HR，需要添加白名单信任配置文件路径：{安装目录}\apusic\domains\server1\config\web.xml找到节点serverNameWhiteList，配置param-value，多个三方信任，用“，”隔开如：serverNameWhiteListhttp://kdweibo.com/,http://kingdee.yunzhijia.com/93部署&调试-Eclipse94部署&调试-Browser{安装目录}\eas\server\deploy\easweb.ear\shr_web.war\addon\customer\web以上路径为s-HR二次开发webserver工程调试和运行时js、css、资源文件的部署位置，调试时在浏览器地址的url后面加上debug=true，使环境js处于调试模式注意：不建议修改系统标准的js、css等资源文件，避免出现补丁更新或者环境更新导致标准产品的内容覆盖客户化修改的内容如果要扩展标准的业务js（如：xxx.js），需要新建js(如：xxxExt.js，xxxExt.js需要继承xxx.js，xxxExt.js必须部署在{安装目录}\eas\server\deploy\easweb.ear\shr_web.war\addon\customer\web\js下），视图将扩展的js引入95部署&调试-集群启动96部署&调试-问题解决启动集群提示非法组件:检查管理控制台，配置参数，路径：{安装目录}\eas\admin\config\admin.vmoptions，如果没有isDetectIllegalComponents参数,如果没有添加参数isDetectIllegalComponents=false重启管理控制台启动集群97Thanksterimakasih感謝谢谢ありがとうขอบคุ�ณ