人力资源WebService接口开发使用说明SUBMITED BY WEAVER眨微st件有眼公司Wcavor Software C,Ltd文档版本历史变更 序号日期版本文件变更 申请编号变更说明修改人12011年8月26日V1.0无新文件胡伟武一、前言 41.1 编写目的 41.2 名词定义 4二、接口调用步骤 52.1 检查 web service 是否已部署 52.2 接口方法概述 52.3 接口相关对象说明 72.4 生成客户端 9三、示例程序 193.1 使用客户端同步公司信息 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，应显示如下页面:L abl e S2Tri z：ec： HrnSerrice 用 dlCenerateG 5丫 XFir= ( http ： /Kzire. codehaus. yrg如果未出先上述页面，则 web service 未部署成功，请与泛微项目人员联系。接口部署成功之后，需要在OA的HrmWebservicelP.properties配置文件中配置调用接口客户端的IP,调 用接口时传入的参数ip包涵在此配置文件才能调用以下接口。2.2接口方法概述名称参数返回值功能描述SynSubCompanyString ipaddress：调用接 口的 IP 地址，St ring xmlData：分部信息的xml成功：1,失败：0,2:无 权限调用同步分部信息SynDepartmentString ipaddress：调用接 口的 IP 地址，St ring xmlData：部门信息的xml成功：1,失败：0,2 :无 权限调用冋步部门信息SynJobtitleString ipaddress：调用接 口的 IP 地址，St ring xmlData：岗位信息的xml成功：1,失败：0,2 :无 权限调用同步岗位信息SynHrmResourceString ipaddress：调用接 口的 IP 地址，St ring xmlData：人员信息的xml成功：1,失败：0,2 :无 权限调用同步人员信息getHrmSubcompanylnfoString ipaddress：调用接 口的IP地址，SubCompanyInfo:分部信息列表获取所有分部 信息列表getHrmDepartmentlnfoString ipaddress：调用接 口的 IP 地址，St ring subcompanyId： 分部 id， 多个用逗号分隔（不为空时 该条件有效）DepartmentInfo: 部门信息列表根据参数条件 获取部门信息 列表getHrmJobTitleInfoString ipaddress：调用接 口的 IP 地址，St ring subcompanyId： 分部 id， 多个用逗号分隔（不为空时 该条件有效）String departmentid: 部门id,多个用逗号分隔（不为空时该条件有效）JobTitleInfo:岗 位信息列表根据参数条件 获取岗位信息 列表getHrmUserlnfoString ipaddress：调用接 口的 IP 地址，St ring subcompanyId： 分部 id， 多个用逗号分隔（不为空时 该条件有效）String departmentid: 部门id,多个用逗号分隔（不为空时该条件有效）String jobtitleid: 岗位id,多个用逗号分隔（不为空时该条件有效）StringlastChangeDate: 最后修改日期，日期 格式“YYYY-MM-DD”（不为空 时该条件有效）String workcode:人员编码（不为空时该条件 有效）UserInfo:用户信 息列表根据参数条件 获取用户信息 列表checkUserString ipaddress：调用接 口的IP地址String loginid :登录名 St ring password：密码True:表示存在False :表示不存在检测0A用户2.3 接口相关对象说明1）SynSubCompany 同步分部传入 xml 的格式如下（一定要按照此格式传入）： 001vshortname测试分部一 v/shortname vfullname 测试分部一 0 0 002 测试分部二 vfullname 测试分部二 0 vorder1v/orderv/orgvorg action=delete vcode003v/code vcanceled1v/canceled v/org v/orglistv/root相关属性说明：Action：动作，add:添加,edit:编辑,delete:删除,OA中只做封存和解封，canceled=1 封存， canceled=0 解封Code :分部编码，唯一值Shortname :分部简称Fullname :分部全称Parent_code：上级分部编码，没有上级请填写0Order:排序值 2）SynDepartment 同步部门传入 xml 的格式如下（一定要按照此格式传入） v?xml version=1.0 encoding=UTF-8?vroot vorglist vorg action=addvcode0001v/code 测试部门 一 vfullname 测试部门一 vorg_code001v/org_code0 0 0002vshortname测试部门二 v/shortname vfullname 测试部门二 v/fullname003 01 0003 1 相关属性说明：Action：动作，add:添加,edit:编辑,delete:删除,OA中只做封存和解封，canceled=1 封存， canceled=0 解封Code :部门编码，唯一值Shortname :部门简称Fullname :部门全称Org_code：分部编码Parent_code：上级部门编码，没有上级请填写0Order:排序值 3）SynJobtitle 同步岗位传入 xml 的格式如下（一定要按照此格式传入） 00001 vjobtitlename 测试岗位一 v/jobtitlename vjobtitleremark 测 试岗位一 v/jobtitleremark 0001 00002 测试岗位二 v/jobtitlename vjobtitleremark 测 试岗位二 v/jobtitleremark 000200003 测试岗位三v /jobtitlename 相关属性说明：Action:动作,add:添加,edit:编辑,delete：删除Jobtitlecode：岗位编码，唯一值Jobtitlename :岗位简称Jobtitleremark :岗位全称Org_code：分部编码Jobtitledept :岗位所属部门编码4）SynHrmResource 同步人员传入 xml 的格式如下（一定要按照此格式传入）10001testtest123456 vsubcompany 测试分部一 vdepartment 测试部门 一 测试岗位一 vstatue 正式1024男1988-09-09te