金蝶s-HR-金蝶s-HRV8.5OSF接口说明及开发指导_人事篇.pdf

金蝶s-HRV8.5OSF接口说明及开发指导_人事篇1/87金蝶s-HRV8.5OSF接口说明及开发指导_人事篇金蝶软件（中国）有限公司2018年12月金蝶s-HRV8.5OSF接口说明及开发指导_人事篇2/87目录1概述.........................................................................51.1总体说明.............................................................51.2使用范围.............................................................51.3注意事项.............................................................51.4服务规范.............................................................51.5数据规范.............................................................62获取s-HR主数据OSF接口......................................................62.1业务背景.............................................................62.2s-HR系统提供组织职位人员数据给第三方系统调取（全量接口）.............72.2.1第三方系统部署“调用s-HR系统OSF接口”代码......................72.2.2组织取数接口（全量）.............................................72.2.3职位取数接口（全量）.............................................92.2.4员工取数接口（全量）............................................112.2.5员工任职取数接口（全量）........................................152.2.6职务取数接口（全量）............................................162.2.7用户同步接口（全量）............................................212.2.8增量接口说明....................................................222.2.9扩展说明........................................................232.2.10字段及OSF说明（附件）..........................................233行政组织字段配置............................................................233.1业务背景............................................................233.2配置说明............................................................233.2.1预留字段说明....................................................233.2.2字段扩展配置（举例）............................................244导入开发....................................................................284.1业务背景............................................................284.2导入模板配置说明....................................................284.2.1业务实现类......................................................294.2.2导入类型........................................................29金蝶s-HRV8.5OSF接口说明及开发指导_人事篇3/874.2.3uipk............................................................294.2.4按钮名称........................................................294.2.5绑定功能........................................................304.2.6是否预置........................................................304.2.7是否数据源模板类型和数据源编码..................................304.3导入实现类API......................................................314.3.1主要方法说明....................................................314.3.2模板下载方法说明................................................314.3.3数据校验方法说明................................................324.3.4数据保存说明....................................................334.4预置单据导入添加字段示例............................................344.5新增单据导入示例....................................................374.5.1单据导入基类API................................................374.5.2新增外事办理单导入类............................................384.5.3页面新增按钮....................................................394.5.4新增外事办理单导入模板..........................................394.6预置的数据源导入实体上扩展字段示例..................................404.6.1实体上新增字段..................................................404.6.2维护对应的结构配置和查询配置....................................414.6.3维护导入模板....................................................434.6.4添加校验逻辑....................................................434.7员工信息维护页签新增示例............................................444.7.1新增动态扩展方案................................................444.7.2新增扩展实体....................................................454.7.3维护新增实体的结构配置和查询配置................................464.7.4维护导入模板....................................................474.7.5维护银行账号视图................................................484.7.6维护权限........................................................494.7.7添加逻辑校验代码................................................504.8综合信息多实体导入示例..............................................514.8.1维护导入模板....................................................514.8.2添加逻辑校验....................................................525人事单据开发................................................................535.1业务背景............................................................53金蝶s-HRV8.5OSF接口说明及开发指导_人事篇4/875.2开发必备............................................................535.3单据扩展字段，并自动反写。..........................................545.4新增单据开发步骤....................................................585.5劳动合同扩展字段....................................................625.5.1劳动合同单据....................................................635.5.2劳动合同批量....................................................735.5.3其他合同批量....................................................736管理者分析开发..............................................................736.1业务背景............................................................736.2开发必备知识........................................................736.3基本开发流程........................................................746.3.1流程一览........................................................746.3.2卡片模板配置....................................................746.3.3视图配置........................................................766.3.4Htm开发........................................................776.3.5Directive开发..................................................776.3.6controller开发.................................................786.3.7OSF中可使用的相关方法..........................................796.4常用开发实例........................................................796.4.1预警区指标修改..................................................796.4.2主题分析区修改..................................................816.4.3隐藏卡片........................................................826.4.4新增卡片........................................................846.4.5新增主题........................................................87金蝶s-HRV8.5OSF接口说明及开发指导_人事篇5/871概述1.1总体说明金蝶s-HRV8.5（以下简称V8.5）系统中，一些客户因业务诉求，需要针对组织人事模块功能进行二次开发（以下简称为二开）或者新增功能开发，但二次开发人员对系统中的接口并不了解，只能在开发过程中逐步摸索与整理。为了帮助二次开发人员提高开发的效率，现将组织人事相关接口及其常见开发场景整理出来，包括一些二次开发必备知识、一些重要的代码实现类说明、以及一些常见的二次开发实例，供二次开发人员在开发过程中参考。本文档主要是s-HR系统中常用接口，以及常见的二次开发方案介绍，方便二开自行扩展时候参考。包括主数据接口说明、行政组织字段扩展、数据导入、合同字段扩展、人事单据等内容。1.2使用范围适用范围：基于s-HR产品的二次开发；适用人员：二次开发人员、具体有开发能力的实施顾问；适用版本：金蝶s-HRV8.5。1.3注意事项二次开发增加的代码最好是以继承的方式，不要直接修改原有的文件，避免后续打补丁覆盖私包导致二次开发包失效。1.4服务规范s-HR系统提供服务接口，第三方系统通过OSF调用s-HR系统提供的接口：规范规范说明通讯协议HTTP数据格式Json字符集UTF-8金蝶s-HRV8.5OSF接口说明及开发指导_人事篇6/871.5数据规范类型描述字符文本信息，标明最大的长度。该长度是按单字节进行计算的，对于双字节数据按照长度为2为计。数值有正负符号的整数和小数两种：1、整数，标明最大的位数。2、小数，标明p精度（位数）和s等级（小数点后位数）。如：(3,2)表明[-9.99,+9.99]。日期泛指日期（Date）和时间（Time），根据使用的情况可以仅包含日期部分，也可能包含小时、分钟等部分；格式为：年月日时分秒，yyyy-mm-ddHH:mm:ss.SSS布尔代表了一个两价逻辑值（或者假）。用0，代表假或否；用1，代表真或是枚举枚举型是字符型的扩展类型，通常用于限制元素的取值。2获取s-HR主数据OSF接口【说明】：在s-HR系统中，有些字段是对象型（即枚举型，参照s-HR系统的基础资料档案），如用工关系状态，调配类型等。对于这种类型的字段，接口中传递的是基础资料档案的编码，如用工关系状态，如果这个用工的用工关系状态为“正式员工”，传递值为001（在员工基础资料“用工关系状态”中可以查询到正式员工的编码为001。对于这种类型的字段，对接的两个系统直接做对应关系，如果两个系统的字段都是对象型，参照的基础资料档案数据设置成编码一致，如果其中一个系统不是，直接在接口中写上对应关系。不建议采用在传递数据的时候，一个系统从另外一个系统中去实时的调取基础资料档案数值。基础资料档案编码和名称的对应关系可以找现场实施顾问在s-HR系统中查询。2.1业务背景s-HR系统中组织、职位和员工数据是主数据，需要和第三方系统进行数据交互。在s-HR系统应用中，组织、职位和员工有现成的接口，但二次开发人员对系统中的接口并不了解，只能在开发过程中逐步的摸索和整理。为了帮助机构开发人员提高接口开发的效率，将系统中的组织、职位和员工数据的标准接口整理出来，供机构开发人员在开发过程中参考。金蝶s-HRV8.5OSF接口说明及开发指导_人事篇7/872.2s-HR系统提供组织职位人员数据给第三方系统调取（全量接口）2.2.1第三方系统部署“调用s-HR系统OSF接口”代码第三方系统如果需要调取s-HR系统的接口，需要通过OSF认证，具体请参考平台的文档《s-HR8.5核心平台常用接口说明文档(外部)》，外部系统调用数据接口的相关章节2.2.2组织取数接口（全量）2.2.2.1请求地址http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=inteOAGetAdminOrgDataService2.2.2.2参数描述参数参数名称描述superior上级行政组织ID上级行政组织ID（非编码）status是否封存是否封存name组织名称组织名称easdept_id组织ID组织IDsupname上级行政组织名称上级行政组织名称fnumber组织编码组织编码endflag是否叶子节点为1是，为0否fcreateTime创建时间创建时间fLastUpdateTime最后修改时间最后修改时间sortCode排序码排序码金蝶s-HRV8.5OSF接口说明及开发指导_人事篇8/872.2.2.3参考样例[{FLastUpdateTime:"2005-08-0617:47:01.0",superior:null,easdept_id:"00000000-0000-0000-0000-000000000000CCE7AED4",supname:null,fnumber:"01",status:"0",endflag:"0",fcreateTime:null,name:"管理单元"},{FLastUpdateTime:"2015-07-0221:35:26.0",superior:"00000000-0000-0000-0000-000000000000CCE7AED4",easdept_id:"5eKN4Pr5Rea9BBdPF3wACMznrtQ=",supname:"管理单元",fnumber:"0701006",status:"0",endflag:"0",fcreateTime:"2015-07-0221:35:25.0",name:"连胜公司"金蝶s-HRV8.5OSF接口说明及开发指导_人事篇9/87},{FLastUpdateTime:"2015-07-0221:36:02.0",superior:"5eKN4Pr5Rea9BBdPF3wACMznrtQ=",easdept_id:"bvUKtf7JSTaxA4c42AWoSMznrtQ=",supname:"连胜公司",fnumber:"070100361",status:"0",endflag:"1",fcreateTime:"2015-07-0221:36:02.0",name:"储蓄所"}]2.2.3职位取数接口（全量）2.2.3.1请求地址http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=inteOAGetPositionDataService2.2.3.2参数描述参数参数名称描述deletedstatus封存状态为1是正常，为2是封存descn职位描述职位描述Name职位名称职位名称positiontype_id职层ID职层ID（不是编码）positiontype_name职层名称职层名称金蝶s-HRV8.5OSF接口说明及开发指导_人事篇10/87isrespposition负责人职位为1则是，为0则否dept_id组织ID组织IDeffectdate职位生效日期职位生效日期eas_id职位ID职位IDparent_id上级职位ID上级职位IDfnumber职位编码职位编码fcreateTime创建时间创建时间fLastUpdateTime最后修改时间最后修改时间2.2.3.3参考样例[{deletedstatus:"1",effectdate:"2000-01-0200:00:00.0",descn:null,dept_id:"+w6fHwzKSnaufJ9EMl3mE8znrtQ=",fnumber:"11.01.01.01",isrespposition:"0",positiontype_name:null,fcreateTime:"2015-06-2914:13:43.0",fLastUpdateTime:"2015-06-2914:13:43.0",parent_id:"EVKsRWYpQ725cbo/bQlOv3SuYS4=",Name:"董事长兼总裁",eas_id:"dEnoJqkATvi2ftfHqkPDN3SuYS4=",positiontype_id:null},金蝶s-HRV8.5OSF接口说明及开发指导_人事篇11/87{deletedstatus:"1",effectdate:"2000-01-0200:00:00.0",descn:null,dept_id:"+w6fHwzKSnaufJ9EMl3mE8znrtQ=",fnumber:"11.01.01.02",isrespposition:"0",positiontype_name:null,fcreateTime:"2015-06-2914:13:43.0",fLastUpdateTime:"2015-06-2914:13:43.0",parent_id:"dEnoJqkATvi2ftfHqkPDN3SuYS4=",Name:"总裁",eas_id:"Tyh3Ta9aSc2KUjKLEQmlJHSuYS4=",positiontype_id:null}]2.2.4员工取数接口（全量）2.2.4.1请求地址http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=inteOAGetPersonDataService&filterType=1【备注】：参数filterType不填或者filterType=1时，取的是系统中用户状态为启用的用工关系状态的员工；参数filterType=0时，取的是用户状态为禁用的用工关系的员工。金蝶s-HRV8.5OSF接口说明及开发指导_人事篇12/87如下图：2.2.4.2参数描述参数参数名称描述birthday出生日期出生日期sex性别男性为1，女性为2status用户状态1启用，2禁用loginid员工编码员工编码fnumber员工编码员工编码descn员工描述员工描述username用户名（姓名）用户名（姓名）dept_id所在部门所在部门email电子邮箱电子邮箱address通信地址通信地址officephone办公室电话办公室电话金蝶s-HRV8.5OSF接口说明及开发指导_人事篇13/87eas_loginid用户编码，唯一标识用户编码，唯一标识easuser_id员工ID员工IDhomephone家庭电话家庭电话mobile手机号码手机号码fcreateTime创建时间创建时间fLastUpdateTime最后修改时间最后修改时间enterDate入职日期入职日期2.2.4.3参考样例[{loginid:"20150702-00038",easuser_id:"Xvz4auxDTDCNcglk//YQCIDvfe0=",mobile:null,officephone:null,address:null,descn:null,dept_id:"rScPCTrGSP2+AwRdTd/6Q8znrtQ=",status:"1",fnumber:"20150702-00038",fcreateTime:"2015-06-2914:17:17.0",sex:"2",fLastUpdateTime:"2015-06-2914:17:17.688",eas_loginid:"00153",username:"王蕙",email:null,金蝶s-HRV8.5OSF接口说明及开发指导_人事篇14/87homephone:null,birthday:"1985-08-1400:00:00.0"},{loginid:"20150702-00037",easuser_id:"gUV+U4SmSTm82VARIyiRVIDvfe0=",mobile:null,officephone:null,address:null,descn:null,dept_id:"rScPCTrGSP2+AwRdTd/6Q8znrtQ=",status:"1",fnumber:"20150702-00037",fcreateTime:"2015-06-2914:17:18.0",sex:"1",fLastUpdateTime:"2015-06-2914:17:18.561",eas_loginid:"01856",username:"王娟",email:null,homephone:null,birthday:"1973-09-0600:00:00.0"}]金蝶s-HRV8.5OSF接口说明及开发指导_人事篇15/872.2.5员工任职取数接口（全量）2.2.5.1请求地址http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=inteOAGetEmpOrgRelationService2.2.5.2参数描述参数参数名称描述position_id职位ID职位IDisprimary任职类型0：兼职，1：主要任职，3：无user_id员工ID员工IDeas_id任职ID任职IDfcreateTime创建时间创建时间fLastUpdateTime最后修改时间最后修改时间2.2.5.3参考样例[{isprimary:"1",user_id:"/QZI1kykSXunn9BKKosWMYDvfe0=",fLastUpdateTime:"2015-07-1514:26:47.0",eas_id:"lJYQh4tzS2SANPyCngm5ZikoiSk=",fcreateTime:"2015-07-1514:26:47.0",position_id:"KZKLEhcUTEGoFbSedfOngnSuYS4="},{isprimary:"1",user_id:"/ZtujvxyQs+QzxB4WeBLWoDvfe0=",金蝶s-HRV8.5OSF接口说明及开发指导_人事篇16/87fLastUpdateTime:"2015-06-2914:17:05.0",eas_id:"vruPUnkiSBK4GSavJXm+5CkoiSk=",fcreateTime:"2015-06-2914:17:05.0",position_id:"5Jh2+bsgSQuxTbD8ks8FgHSuYS4="}]2.2.6职务取数接口（全量）2.2.6.1请求地址http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=inteOAGetJobRelatedDataService2.2.6.2参数描述字段字段名称job.id职务idjob.name职务名称job.number职务编码job.state状态job.jobCategory_id职务的职务类idjob.jobCategory_name职务的职务类名称job.jobCategory_number职务的职务类编码job.jobSubCategory_id职务的职务子类idjob.jobSubCategory_name职务的职务子类名称job.jobSubCategory_number职务的职务子类编码job.jobFamily_id职务的职务族idjob.jobFamily_name职务的职务族名称job.jobFamily_number职务的职务族编码job.createTime职务的创建时间job.lastUpdateTime职务的最后修改时间金蝶s-HRV8.5OSF接口说明及开发指导_人事篇17/87jobCategory.id职务类idjobCategory.name职务类名称jobCategory.number职务类编码jobCategory.jobFamily_id职务类的职务族idjobCategory.jobFamily_name职务类的职务族名称jobCategory.jobFamily_number职务类的职务族编码jobCategory.createTime职务类的创建时间jobCategory.lastUpdateTime职务类的最后修改时间jobFamily.id职务族idjobFamily.name职务族名称jobFamily.number职务族编码jobFamily.createTime职务族创建时间jobFamily_lastUpdateTime职务族最后修改时间jobSubCategory.id职务子类idjobSubCategory.name职务子类名称jobSubCategory.number职务子类编码jobSubCategory.jobCategory_id职务子类的职务类idjobSubCategory.jobCategory_name职务子类的职务类名称jobSubCategory.jobCategory_number职务子类的职务类编码jobSubCategory.createTime职务子类_创建时间jobSubCategory.lastUpdateTime职位子类的最后修改时间金蝶s-HRV8.5OSF接口说明及开发指导_人事篇18/872.2.6.3参考样例{"jobFamily":[{"lastUpdateTime":"2015-07-1610:16:09","createTime":"2015-07-1609:44:26",name:"管理族",id:"h1aXvae9TAW/DZifZLYpeOd1mhw="},{"lastUpdateTime":"2015-07-1609:44:46","createTime":"2015-07-1609:44:46","name":"支持族","id":"HRAdu2xiTCaueGU3Q9XLsud1mhw="}],"jobSubCategory":[{"lastUpdateTime":"2015-07-2109:52:50",jobCategory_name:"管理类","jobCategory_id":"aYozUIvNSgiuGaBSaCvbnrSLLbY=","name":"管理子类（1）","id":"nvksZbB0RAi4Enk7Nui1hQYR06Y="},{金蝶s-HRV8.5OSF接口说明及开发指导_人事篇19/87"lastUpdateTime":"2015-07-1510:02:03","createTime":"2015-07-1510:02:03","jobCategory_name":"客服类","jobCategory_id":"iT+XYY9CRlm/MWLUJa+ygbSLLbY=","name":"客服子类（4）","id":"u9VLWIjiT2q/364nniT79wYR06Y="}],"jobCategory":[{"parentCategory_id":null,"jobFamily_name":"管理族","parentCategory_name":null,lastUpdateTime:"2015-07-1610:17:17","createTime":"2015-07-1610:13:31","jobFamily_id":"h1aXvae9TAW/DZifZLYpeOd1mhw=","name":"管理类","id":"aYozUIvNSgiuGaBSaCvbnrSLLbY="},{"parentCategory_id":null,"jobFamily_name":"技术族","parentCategory_name":null,"lastUpdateTime":"2015-07-1517:40:53",金蝶s-HRV8.5OSF接口说明及开发指导_人事篇20/87createTime:"2015-07-1510:00:07","jobFamily_id":"PcJLFxAHRk6fh+5hWjvWJud1mhw=","name":"技术类","id":"Dq85ICJtSKuO3uLlzw6eMLSLLbY="}],"job":[{"jobFamily_name":"客服族","lastUpdateTime":"2015-07-1510:06:29","jobSubCategory_id":"c+zJ9L5MR9+1jxmimyCPFAYR06Y=",createTime:"2015-07-1510:06:01","jobFamily_id":"NSbVGVz3TK6+RjTv8W94tOd1mhw=","jobCategory_name":"客服类","jobCategory_id":"iT+XYY9CRlm/MWLUJa+ygbSLLbY=","name":"客服部经理（1）","id":"Hss1fgj1T5Wtqu9gYXzfOnVwJJg=","jobSubCategory_name":"客服子类（1）"},{"jobFamily_name":"客服族","lastUpdateTime":"2015-07-1610:18:38","jobSubCategory_id":"c+zJ9L5MR9+1jxmimyCPFAYR06Y=","createTime":"2015-07-1610:18:38",金蝶s-HRV8.5OSF接口说明及开发指导_人事篇21/87"jobFamily_id":"NSbVGVz3TK6+RjTv8W94tOd1mhw=","jobCategory_name":"客服类","jobCategory_id":"iT+XYY9CRlm/MWLUJa+ygbSLLbY=","name":"客服部副经理","id":"tf8200RHTRSWHFUiqbtWO3VwJJg=","jobSubCategory_name":"客服子类（1）"}]}2.2.7用户同步接口（全量）2.2.7.1请求地址http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=inteOAGetUserDataService2.2.7.2参数描述字段字段名称描述personName用户实名用户实名userNumber用户名用户名userId用户ID用户IDpersonId员工ID员工IDpersonNumber员工编码员工编码updateUserId最后修改人ID最后修改人IDupdateTime最后修改时间最后修改时间金蝶s-HRV8.5OSF接口说明及开发指导_人事篇22/872.2.7.3参考样例[{updateUserId:"256c221a-0106-1000-e000-10d7c0a813f413B7DE7F",updateTime:"2015-06-2914:17:14.0",personNumber:"00979",userId:"sCbyNuC5QNulMNp5/HxOyRO33n8=",personId:"167OOO5rTpuhdgheQl0hboDvfe0=",userNumber:"00979",personName:"徐晓桦"},{"updateUserId":"256c221a-0106-1000-e000-10d7c0a813f413B7DE7F",updateTime:"2015-06-2914:17:15.0",personNumber:"01124",userId:"wSdDe646SlGw5X5fSwvcAxO33n8=",personId:"Myrz2ZPoSJS3EHLylLGE74Dvfe0=",userNumber:"01124",personName:"林敏芝"}]2.2.8增量接口说明目前针对所有的第三方系统只提供了上述的全量取数接口，不支持增量。如果需要实现增量需要第三方自行处理。可参考方案1：第三方系统取全量数据后与系统中的数据对比，根据对比结果进行新增或者修改，间接实现增量功能。金蝶s-HRV8.5OSF接口说明及开发指导_人事篇23/872.2.9扩展说明上述标准的OSF接口中返回字段如果不符合现场要求，需要对返回的字段进行扩展的话，需要客户自定义一个OSF以及OSF对应的实现类，进行调用，不能直接修改标准的OSF，否则会影响后续版本的升级。2.2.10字段及OSF说明（附件）上述相关OSF的字段说明文档如下。字段及osf说明.xlsx3行政组织字段配置3.1业务背景如果需要在行政组织上增加扩展字段，应该如何二次开发处理？本章节主要对行政组织的增加字段进行说明。3.2配置说明3.2.1预留字段说明因为行政组织不支持在DEP进行扩展，所以在行政组织的元数据定义的时候，预留了四个可供扩展的字段：两个预留文本字段、两个预留组织基础资料，这些字段已经支持记录历史。两个预留文本字段：reserveFieldFirst、reserveFieldSecond；两个预留组织基础资料：reserveItemFirst、reserveItemSecond。基础资料字段对应实体如下：com.kingdee.eas.basedata.org.app.ReserveItemFirstcom.kingdee.eas.basedata.org.app.ReserveItemSecond金蝶s-HRV8.5OSF接口说明及开发指导_人事篇24/87元数据预留字段如下图。3.2.2字段扩展配置（举例）1、文本字段文本字段直接配置到组织界面使用即可。比如在组织的form表单界面配置，新增修改保存时，可以走系统的统一逻辑，保存该字段数据；列表及表单的查看界面也可以走系统统一逻辑展示字段值。2、基础资料字段列表视图（必要）：用于整体基础资料数据的展示；表单视图（必要）：用于单个基础资料数据的维护及查看；三级菜单（必要）：进入列表视图的入口；F7视图（必要）：用于组织表单界面基础资料的选择。3、使用步骤如下：1)新建列表视图示例管理员登录s-HR，进入【开发平台】-【>基础配置】->【三级菜单】视图，新增列表视图，如下图：金蝶s-HRV8.5OSF接口说明及开发指导_人事篇25/872)新建表单视图示例，如下图；3)将列表视图和表单视图配置到三级菜单，方便进行维护；管理员登录s-HR，进入【开发平台】->【菜单管理】->【三级菜单配置】，新建基础资料维护对应三级菜单，示例如下图。金蝶s-HRV8.5OSF接口说明及开发指导_人事篇26/87业务用户登录s-HR，点击该菜单进入基础资料列表界面，对基础资料进行查看和维护；4)新建F7视图示例，如下图；金蝶s-HRV8.5OSF接口说明及开发指导_人事篇27/875)将该F7视图配置到组织的视图上使用；扩展shr.org.AdminOrgUnit_edit视图，增加基础资料字段，如下所示。6)组织日常维护表单界面效果展示，如下图；【备注】：针对组织预留的扩展字段，组织的新增、修改、查看，将会由系统统一处理，不需要进行代码的二次开发。金蝶s-HRV8.5OSF接口说明及开发指导_人事篇28/874导入开发4.1业务背景导入目前支持数据源导入和非数据源导入，此文档介绍了数据源导入和单据导入的二次开发场景。数据源导入是基于结构配置和查询配置实现的多实体导入，单据导入目前满足入职、转正、调动、离职、职等调整等单据的标准校验和数据导入功能，但是，考虑到业务的多样性和延展性，为了让客户能够个性化的定制自己的业务，在s-HRV8.5版本的系统中，导入具有一定继承性和扩展性，可以进行深度的二次开发。下面的文档内容将会全面介绍导入功能，通过示例，讲解二次开发的流程以及注意事项。在阅读之前我们希望您已经具有一定的人事导入业务基础和java基础。4.2导入模板配置说明导入模板示例图如下。【备注】：红色部分将着重介绍。金蝶s-HRV8.5OSF接口说明及开发指导_人事篇29/874.2.1业务实现类业务实现类概念:导入的逻辑处理类。业务实现类说明:如上图，当前值为com.kingdee.shr.base.syssetting.app.io.impl.PersonDataSourceImportService，则导入将会由该类处理导入后台逻辑；为空，则默认由系统基础导入类com.kingdee.shr.base.syssetting.app.io.fileImport.BaseImportService处理导入后台逻辑。现场如进行二次开发，则该值填写对应的二次开发处理类全路径。4.2.2导入类型导入类型：如下图所示序号名称别名值说明1New_Import新增10仅能新增数据,如果存在，提示错误2Override_Import覆盖20有记录则覆盖，无记录则新增（单行表保留ID）3Update_Only_Import更新（不新增记录）30匹配记录更新，未匹配到提示错误4Update_Add_Import更新（新增记录）40匹配记录更新，未匹配到则新增目前的综合信息导入支持的类型为:更新（不新增记录），单据导入支持的类型为：新增。4.2.3uipkuipk：为当前导入功能所在页面的uipk。4.2.4按钮名称按钮名称:导入页面视图配置的按钮名称。默认按钮名称：当按钮名称为import的时候，不需要复写平台js代码就可使用。平台js如下图所示:金蝶s-HRV8.5OSF接口说明及开发指导_人事篇30/87非默认按钮名称：当按钮名称不是import的时候，需要复写平台js代码。综合信息导入复写的js如下所示:4.2.5绑定功能绑定功能：由业务实现类加uipk生成，无需填写。4.2.6是否预置是否预置：表示该模板是否是系统预置的，目前平台对预置的而模板做了控制，系统预置的模板不可编辑，如需要编辑应先复制一份编辑复制后的模板。4.2.7是否数据源模板类型和数据源编码是否数据源模板类型：表示该模板是否是数据源模板，如果是则需填写数据源编码，综合信息导入的数据源编码为001。如果为否则无需填写数据源编码。金蝶s-HRV8.5OSF接口说明及开发指导_人事篇31/874.3导入实现类API二次开发时主要关注BaseImportService、AbstractBaseImportService。其他类都被声明为final，不可继承，主要是整个导入逻辑的实现，与业务逻辑校验无关，因此二次开发时无需重点关注。4.3.1主要方法说明导入的方法主要分为3大类，模板下载、数据校验、数据保存。4.3.2模板下载方法说明1.getColumnSelectValue方法逻辑:获取模板下拉菜单值的集合。方法修饰符：protected请求参数:类型名称说明com.kingdee.shr.base.syssetting.app.io.fileImport.BaseColumnInfocolumnInfo当前列信息java.util.Map<String,String>customParam自定义参数，较少用到返回值：java.util.List<String>异常处理：com.kingdee.shr.base.syssetting.app.io.fileImport.ImportException2.getRelatedFieldCollection方法逻辑：获取模板下拉菜单值的集合，上述的getColumnSelectValue会调用该方法。方法修饰符：protected请求参数:类型名称说明java.lang.StringentityName当前列对应的实体名称com.kingdee.shr.base.syssetting.app.io.fileImport.BaseColumnInfocolumnInfo当前列信息返回值：com.kingdee.eas.framework.CoreBaseCollection异常处理:无金蝶s-HRV8.5OSF接口说明及开发指导_人事篇32/873.getDefaultFilterByEntityInfo方法逻辑:获取关联字段取数过滤条件，上述的getRelatedFieldCollection会调用该方法。方法修饰符:protected请求参数:类型名称说明java.lang.StringentityName当前列对应的实体名称com.kingdee.shr.base.syssetting.app.io.fileImport.BaseColumnInfocolumnInfo当前列信息返回值：com.kingdee.bos.metadata.entity.FilterInfo异常处理:无。4.3.3数据校验方法说明1.verifyRow方法逻辑:导入校验数据的入口。方法修饰符:protected请求参数:类型名称说明com.kingdee.shr.base.syssetting.app.io.fileImport.BaseRowInforow导入数据行封装返回值：void异常处理：com.kingdee.shr.base.syssetting.app.io.fileImport.ImportException2.verifyRowSystem方法逻辑:行基本信息验证与数据转换，有修饰符final，不可复写，上述的verifyRow方法会调用该方法。因此复写上述的verifyRow方法时建议还是调用该方法。方法修饰符：protectedfinal请求参数:类型名称说明com.kingdee.shr.base.syssetting.app.io.fileImport.BaseRowInforow导入数据行封装返回值：void异常处理：com.kingdee.shr.base.syssetting.app.io.fileImport.ImportException金蝶s-HRV8.5OSF接口说明及开发指导_人事篇33/873.verifyRowBiz方法逻辑:业务验证。在该方法中数据源导入和非数据源导入会走不同的校验逻辑，因此数据源导入的时候，如果复写该方法需要注意。方法修饰符：protected请求参数:类型名称说明com.kingdee.shr.base.syssetting.app.io.fileImport.BaseRowInforow导入数据行封装返回值：void异常处理：com.kingdee.shr.base.syssetting.app.io.fileImport.ImportException4.verifyRowOfDataSouce方法逻辑:数据源数据验证。该方法是有上述的verifyRowBiz方法调用。数据源导入的时候，如果复写了上述的verifyRowBiz方法，需要调用该方法。方法修饰符：protected请求参数:类型名称说明com.kingdee.shr.base.syssetting.app.io.fileImport.BaseRowInforow导入数据行封装返回值：void异常处理：com.kingdee.shr.base.syssetting.app.io.fileImport.ImportException4.3.4数据保存说明1.importRow方法逻辑:数据保存的入口，有数据员保存逻辑和非数据源保存逻辑。方法修饰符：protected请求参数:类型名称说明com.kingdee.shr.base.syssetting.app.io.fileImport.BaseRowInforow导入数据行封装返回值：void异常处理：com.kingdee.shr.base.syssetting.app.io.fileImport.ImportException金蝶s-HRV8.5OSF接口说明及开发指导_人事篇34/872.importDataSource方法逻辑:数据源保存的逻辑，数据源导入的时候，如果复写了上述的importRow方法，需...