人力资源(HrmService)WebService接口使用说明

1、人力资源 Web Service接口使用说W人力资源WebService接口开发使用说明SUBMITED BY WEA VER0 u Q0 MM M M1 -泛敲软件有眼公司Weaver Software Co.Ltd人力资源 Web Service接口使用说明文档版本历史变更 序号日期版本文件变更 申请编号变更说明修改人12011年8月26日V1.0无新文件胡伟武-13 -录一、前言41.1 编写目的41.2 名词定义4二、接口调用步骤52.1 检查 web service 是否已部署 52.2 接口方法概述52.3 接口相关对象说明 72.4 生成客户端9三、小例程序 193.1 使用客户

2、端同步公司信息 19、前言1.1 编写目的本文给有研发能力的客户或有系统集成需求的客户提供web service接口调用的参考例程。本文的面向具有一定web service开发能力或了解web service技术的开发人员。1.2 名词定义1、Axis :著名的开源web service 引擎。2、外部系统：指调用或实现e-cology输入输出接口，与e-cology系统进行数据交接的其他系统。二、接口调用步骤2.1检查web service 是否已部署在浏览器中输入http:/ecologyServer/ services,应显示如下页面:力 XFire S*rvjAvai lable- S

3、ervices： ErmService wsdlgenerated by XFir已 (http：/xfire. codehaus. org j如果未出先上述页面，则 web service未部署成功，请与泛微项目人员联系。接口部署成功之后，需要在 OA的HrmWebservicelP.properties配置文件中配置调用接口客户端的 IP,调用接口时传入的参数ip包涵在此配置文件才能调用以下接口。2.2接口方法概述名称参数返回值功能描述SynSubCompanyString ipaddress :调用接 口的 IP 地址，String xmlData :分部信息的xml成功：1,失败:0,

4、2:无权限调用同步分部信息SynDepartmentString ipaddress :调用接 口的 IP 地址，String xmlData :部门信息的xml成功：1,失败:0,2:无权限调用同步部门信息SynJobtitleString ipaddress :调用接 口的 IP 地址，String xmlData :岗位信息的xml成功：1,失败:0,2:无权限调用同步岗位信息SynHrmResourceString ipaddress :调用接 口的 IP 地址，String xmlData :人员信息的xml成功：1,失败:0,2:无权限调用同步人员信息getHrmSubcompan

5、yInfoString ipaddress :调用接 口的IP地址，SubCompanyInf。口：分部信息列表获取所有分部 信息列表getHrmDepartmentInfoString ipaddress :调用接 口的 IP 地址，String subcompanyId :分部 id , 多个用逗号分隔（不为空时 该条件有效）DepartmentInf。口部门信息列表根据参数条件 状取部门信息 列表getHrmJobTitleInfoString ipaddress :调用接 口的 IP 地址，String subcompanyId :分部 id , 多个用逗号分隔（不为空时 该条件有效）

6、String departmentid:部门id ,多个用逗号分隔 （不为空时该条件有效）JobTitleInfo口：岗位信息列表根据参数条件 族取岗位信息 列表getHrmUserInfoString ipaddress :调用接 口的 IP 地址，String subcompanyId :分部 id , 多个用逗号分隔（不为空时 该条件有效）String departmentid:部门id ,多个用逗号分隔 （不为空时该条件有效）String jobtitleid:岗位id ,多个用逗号分隔 （不为空时该条件有效）StringlastChangeDate最后修改日期，日期 格式 “YYYY

7、-MM-DD ” （不为空时该条件有效）String workcode:人员编码（不为空时该条件 有效）UserInfo口：用户信息列表根据参数条件 族取用户信息 列表checkUserString ipaddress :调用接 口的IP地址String loginid:登录名String password:密码True:表小存在False :表小不存在检测OA用户2.3接口相关对象说明1） SynSubCompany同步分部传入xml的格式如下（一定要按照此格式传入）：001 测试分部一 测试分部一 00002 测试分部二 测试分部二 010031相关属性说明：Action :动作，add：

8、添加，edit：编辑，delete：删除，OA中只做封存和解封，canceled=1封存,canceled=0解封Code：分部编码，唯一值Shortname：分部简称Fullname :分部全称Parent_code：上级分部编码，没有上级请填写0Order ：排序值2） SynDepartment同步部门传入xml的格式如下（一定要按照此格式传入）0001 测试部门一 测试部门一 001000002 测试部门二 测试部门二 0030100031相关属性说明：Action :动作，add：添加，edit：编辑，delete：删除，OA中只做封存和解封，canceled=1封存,cancele

9、d=0解封Code：部门编码，唯一值Shortname：部门简称Fullname :部门全称Org_code:分部编码Parent_code：上级部门编码，没有上级请填写0Order ：排序值3） SynJobtitle 同步岗位传入xml的格式如下（一定要按照此格式传入）00001 测试岗位一 测试岗位一 000100002 测试岗位二 测试岗位二 000200003 测试岗位三 相关属性说明：Action :动作，add：添加，edit：编辑，delete：删除Jobtitlecode ：岗位编码，唯一值Jobtitlename :岗位简称Jobtitleremark :岗位全称Org_c

10、ode：分部编码Jobtitledept:岗位所属部门编码4） SynHrmResource同步人员传入 xml的格式如下（一定要按照此格式传入）10001testtest123456 测试分部一 department硬 U试音B 门 测试岗位一 正式 1024 男 1988-09-091234567812345678test 已婚 10001testtest123456 测试分部一 硬 U 试音B 门 测试岗位一 正式 1024 男 1988-09-091234567812345678test 已婚 相关属性说明：Action :动作，add：添加，edit：编辑Workcode：人员编码，

11、唯一值Subcompany:分部Department:部门Lastname：姓名Loginid :登录名Password：密码Seclevel ：安全级别Sex：性别Jobtitle :岗位Jobactivityid :职务Jobgroupid ：职务类别Jobcall ：职称Joblevel:职级Jobactivitydesc:职责描述Managerid :直接上级（编码）Assistantid :助理（编码）Status：状态Locationid :办公室Workroom :办公地点Telephone：办公电话Mobile :移动电话Mobilecall ：其他电话Fax：传真Email

12、:邮箱Systemlanguage：系统语言Birthday :出生日期Folk:名族Nativeplace :籍贯Regresidentplace ：户口Certificatenum :身份证号码Maritalstatus :婚姻状况Policy :政治面貌Bememberdate ：入团日期Bepartydate：入党日期Islabouunion :工会会员Educationlevel :学历Degree ：学位Healthinfo :健康状况Residentplace ：现居住地Homeaddress：家庭联系方式Tempresidentnumber：暂住证号码以上是人员同步的所有节点信

13、息，需要同步那些字段，就填写相应的值。5) SubCompanyInfo /*分部id*/private java.lang.String _subcompanyid;/*简称*/private java.lang.String _shortname;/*全称*/private java.lang.String _fullname;/*上级分部id*/private java.lang.String _supsubcompanyid;/*网站*/private java.lang.String _website;/*显示顺序*/private java.lang.String _showord

14、er;/*公司编码*/private java.lang.String _code;/*是否封存*/private java.lang.String .canceled;6) Departmentinfo/* 部门id* /private java.lang.String _departmentid;/* 简称* /private java.lang.String _shortname;/* 全称* /private java.lang.String _fullname;/* 所属分部id* /private java.lang.String _subcompanyid;/* 上级部门id*

15、/private java.lang.String _supdepartmentid;/* 显示顺序* /private java.lang.String _showorder;/* 部门编码* /private java.lang.String _code;/*是否封存*/private java.lang.String .canceled;7) JobTitleInfo/*岗位id*/private java.lang.String _jobtitleid;*简称*/private java.lang.String _shortname;/*全称*/private java.lang.St

16、ring _fullname;/*所属部门id*/private java.lang.String _departmentid;/*岗位职责*/private java.lang.String Jobresponsibility;/*任职资格*/private java.lang.String _jobcompetency;/*相关文档*/private java.lang.String _jobdoc;/*备注*/private java.lang.String _jobtitleremark;8) UserInfoprivateintuserid ;/用户idprivateStringsu

17、bcompanyidl ;/分部privateStringdepartmentid;/部门privateStringworkcode ;/编号privateStringlastname ;/姓名privateStringloginid ;/系统账号privateStringpassword ;/密码privateStringseclevel ;/安全级别privateStringsex ;/性别privateStringjobtitle;/岗位privateStringjobactivityid;/职务privateStringjobgroupid ;/职务类型privateStringjob

18、call ;/职称privateStringjoblevel ;/职级privateStringjobactivitydesc;/职责描述privateStringmanagerid ;/直接上级privateStringassistantid;/助理privateStringstatus ;/状态eg:正式、试用等privateStringlocationid;/办公地点privateStringworkroom ;/办公室privateStringtelephone ;/办公电话privateStringmobile ;/移动电话privateStringmobilecall;/其他电话p

19、rivateStringfax ;/传真privateStringemail ;/电子邮件privateStringsystemlanguage;/系统语言 默认7privateStringbirthday ;/生日privateStringfolk ;/名族privateStringnativeplace;/籍贯privateStringregresidentplace;/ 户口privateStringcertificatenum;/身份证号privateStringmaritalstatus;/婚姻状况privateStringpolicy ;/政治面貌privateStringbeme

20、mberdate ;/入团日期privateStringbepartydate;/入党日期privateStringislabouunion;/是否是工会会员privateStringeducationlevel;/学历privateStringdegree ;/学位privateStringhealthinfo;/健康状况privateStringheight ;/身高privateStringweight ;/体重privateStringresidentplace;/居住地privateStringhomeaddress ;/家庭住址privateStringtempresidentnu

21、mber;/暂住证号码-14 -人力资源 Web Service接口使用说明privateStringstartdate=;/合同开始日期privateStringenddate =;/合同结束日期privateStringcreatedate =;/创建日期privateStringlastChangdate=;/最后修改日期privateintaccounttype ;/账号类型privateintdsporder ;/显示顺序以上是获得用户的基本信息字段2.4生成客户端大家知道，在本地调用web service,最便利的方法是利用工具生成客户端代理，开发人员通过客户端代理去访问web s

22、ervice将会非常简单，就象调用本地的方法一样。各大主流的编程语言都提供了通过wsdl生成客户端代理的工具，如c#中的wsdl.exe和java中的wsdl2java 。本文以java为例说明客户端 的生成方法。2.4.1 客户端所需jarcommons-discovery-0.2.jarjavax-wsdl_1.5.1jarcommons-logging_1.0.4.jaraxis.jarjaxrpc.jarsaaj.jaractivation.jarmail.jar2.4.2 生成客户端使用eclipse向导生成 Web Service客户端-15 -*55度微leaverSB New人

23、力资源 Web Service接口使用说明Select a wizardAccess an existing XML web serviceWizardstype filter tertJSP国 JSPTag 绻 Listener& Servletji Static Web Project d& Web Services痢 Ant Filesg Unit Test UDDI，Web Service位 Web Service Cliient-16 -v： BackNext FinishCancel人力资源 Web Service接口使用说明回 Web Service ClientI :回 1- i r一Client type:ProxyMonitor the Web serviceWeb ServicesSelect a service definition and move the slider to set the level of client generation,Service definition： http:/localhost8080/eirviice/D