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

人力资源WebService接口使用说明-1-人力资源WebService接口开发使用说明SUBMITEDBYWEAVER人力资源WebService接口使用说明-2-文档版本历史变更序号日期版本文件变更申请编号变更说明修改人12011年8月26日V1.0无新文件胡伟武人力资源WebService接口使用说明-3-目录一、前言...................................................................................................................................................................41.1编写目的....................................................................................................................................................41.2名词定义....................................................................................................................................................4二、接口调用步骤....................................................................................................................................................52.1检查webservice是否已部署....................................................................................................................52.2接口方法概述............................................................................................................................................52.3接口相关对象说明...................................................................................................................................72.4生成客户端...............................................................................................................................................9三、示例程序.........................................................................................................................................................193.1使用客户端同步公司信息......................................................................................................................19人力资源WebService接口使用说明-4-一、前言1.1编写目的本文给有研发能力的客户或有系统集成需求的客户提供webservice接口调用的参考例程。本文的面向具有一定webservice开发能力或了解webservice技术的开发人员。1.2名词定义1、Axis：著名的开源webservice引擎。2、外部系统：指调用或实现e-cology输入输出接口，与e-cology系统进行数据交接的其他系统。人力资源WebService接口使用说明-5-二、接口调用步骤2.1检查webservice是否已部署在浏览器中输入应显示如下页面：如果未出先上述页面，则webservice未部署成功，请与泛微项目人员联系。接口部署成功之后，需要在OA的HrmWebserviceIP.properties配置文件中配置调用接口客户端的IP，调用接口时传入的参数ip包涵在此配置文件才能调用以下接口。2.2接口方法概述名称参数返回值功能描述SynSubCompanyStringipaddress：调用接口的IP地址，StringxmlData：分部信息的xml成功:1,失败:0,2:无权限调用同步分部信息SynDepartmentStringipaddress：调用接口的IP地址，StringxmlData：部门信息的xml成功:1,失败:0,2:无权限调用同步部门信息SynJobtitleStringipaddress：调用接口的IP地址，StringxmlData：岗位信息的xml成功:1,失败:0,2:无权限调用同步岗位信息SynHrmResourceStringipaddress：调用接口的IP地址，StringxmlData：人员信息的xml成功:1,失败:0,2:无权限调用同步人员信息人力资源WebService接口使用说明-6-getHrmSubcompanyInfoStringipaddress：调用接口的IP地址，SubCompanyInfo[]:分部信息列表获取所有分部信息列表getHrmDepartmentInfoStringipaddress：调用接口的IP地址，StringsubcompanyId：分部id，多个用逗号分隔（不为空时该条件有效）DepartmentInfo[]：部门信息列表根据参数条件获取部门信息列表getHrmJobTitleInfoStringipaddress：调用接口的IP地址，StringsubcompanyId：分部id，多个用逗号分隔（不为空时该条件有效）Stringdepartmentid：部门id，多个用逗号分隔（不为空时该条件有效）JobTitleInfo[]:岗位信息列表根据参数条件获取岗位信息列表getHrmUserInfoStringipaddress：调用接口的IP地址，StringsubcompanyId：分部id，多个用逗号分隔（不为空时该条件有效）Stringdepartmentid：部门id，多个用逗号分隔（不为空时该条件有效）Stringjobtitleid：岗位id，多个用逗号分隔（不为空时该条件有效）StringlastChangeDate：最后修改日期，日期格式“YYYY-MM-DD”（不为空时该条件有效）Stringworkcode:人员编码（不为空时该条件有效）UserInfo[]：用户信息列表根据参数条件获取用户信息列表checkUserStringipaddress：调用接口的IP地址Stringloginid：登录名Stringpassword：密码True:表示存在False：表示不存在检测OA用户人力资源WebService接口使用说明-7-2.3接口相关对象说明1）SynSubCompany同步分部传入xml的格式如下（一定要按照此格式传入）：?xmlversion=1.0encoding=UTF-8?rootorglistorgaction=addcode001/codeshortname测试分部一/shortnamefullname测试分部一/fullnameparent_code0/parent_codeorder0/order/orgorgaction=editcode002/codeshortname测试分部二/shortnamefullname测试分部二/fullnameparent_code0/parent_codeorder1/order/orgorgaction=deletecode003/codecanceled1/canceled/org/orglist/root相关属性说明：Action：动作，add：添加，edit：编辑，delete：删除，OA中只做封存和解封，canceled=1封存，canceled=0解封Code：分部编码，唯一值Shortname：分部简称Fullname：分部全称Parent_code：上级分部编码，没有上级请填写0Order：排序值2）SynDepartment同步部门传入xml的格式如下（一定要按照此格式传入）：?xmlversion=1.0encoding=UTF-8?rootorglistorgaction=addcode0001/codeshortname测试部门一/shortnamefullname测试部门一/fullnameorg_code001/org_code人力资源WebService接口使用说明-8-parent_code0/parent_codeorder0/order/orgorgaction=editcode0002/codeshortname测试部门二/shortnamefullname测试部门二/fullnameorg_code003/org_codeparent_code0/parent_codeorder1/order/orgorgaction=delcode0003/codecanceled1/canceled/org/orglist/root相关属性说明：Action：动作，add：添加，edit：编辑，delete：删除，OA中只做封存和解封，canceled=1封存，canceled=0解封Code：部门编码，唯一值Shortname：部门简称Fullname：部门全称Org_code：分部编码Parent_code：上级部门编码，没有上级请填写0Order：排序值3）SynJobtitle同步岗位传入xml的格式如下（一定要按照此格式传入）：?xmlversion=1.0encoding=UTF-8?rootjobtitlelistjobtitleaction=addjobtitlecode00001/jobtitlecodejobtitlename测试岗位一/jobtitlenamejobtitleremark测试岗位一/jobtitleremarkjobtitledept0001/jobtitledept/jobtitlejobtitleaction=editjobtitlecode00002/jobtitlecodejobtitlename测试岗位二/jobtitlenamejobtitleremark测试岗位二/jobtitleremarkjobtitledept0002/jobtitledept/jobtitlejobtitleaction=delete人力资源WebService接口使用说明