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

精品文档人力资源WebService接口开发使用说明SUBMITED BY WEAVER文档版本历史变更序号日期版本文件变更申请编号变更说明修改人12011年8月26日V1.0无新文件胡伟武目 录一、前言41.1编写目的41.2名词定义4二、接口调用步骤52.1检查web service是否已部署52.2接口方法概述52.3 接口相关对象说明62.4 生成客户端9三、示例程序133.1 使用客户端同步公司信息13一、前言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,应显示如下页面：如果未出先上述页面，则web service未部署成功，请与泛微项目人员联系。接口部署成功之后，需要在OA的HrmWebserviceIP.properties配置文件中配置调用接口客户端的IP，调用接口时传入的参数ip包涵在此配置文件才能调用以下接口。2.2接口方法概述名称参数返回值功能描述SynSubCompanyString ipaddress：调用接口的IP地址，String xmlData：分部信息的xml成功:1,失败:0,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:无权限调用同步人员信息getHrmSubcompanyInfoString ipaddress：调用接口的IP地址，SubCompanyInfo:分部信息列表获取所有分部信息列表getHrmDepartmentInfoString ipaddress：调用接口的IP地址，String subcompanyId：分部id，多个用逗号分隔（不为空时该条件有效）DepartmentInfo：部门信息列表根据参数条件获取部门信息列表getHrmJobTitleInfoString ipaddress：调用接口的IP地址，String subcompanyId：分部id，多个用逗号分隔（不为空时该条件有效）String departmentid：部门id，多个用逗号分隔（不为空时该条件有效）JobTitleInfo:岗位信息列表根据参数条件获取岗位信息列表getHrmUserInfoString ipaddress：调用接口的IP地址，String subcompanyId：分部id，多个用逗号分隔（不为空时该条件有效）String departmentid：部门id，多个用逗号分隔（不为空时该条件有效）String jobtitleid：岗位id，多个用逗号分隔（不为空时该条件有效）String lastChangeDate：最后修改日期，日期格式“YYYY-MM-DD”（不为空时该条件有效）String workcode:人员编码（不为空时该条件有效）UserInfo：用户信息列表根据参数条件获取用户信息列表checkUserString ipaddress：调用接口的IP地址String loginid：登录名 String password：密码True:表示存在False：表示不存在检测OA用户2.3 接口相关对象说明1）SynSubCompany 同步分部传入xml的格式如下（一定要按照此格式传入）： 001 测试分部一 测试分部一 0 0 002 测试分部二 测试分部二 0 1 003 1 相关属性说明：Action：动作，add：添加，edit：编辑，delete：删除，OA中只做封存和解封，canceled=1封存，canceled=0解封Code：分部编码，唯一值Shortname：分部简称Fullname：分部全称Parent_code：上级分部编码，没有上级请填写0Order：排序值2）SynDepartment同步部门传入xml的格式如下（一定要按照此格式传入）： 0001 测试部门一 测试部门一001 0 0 0002 测试部门二 测试部门二003 0 1 0003 1 相关属性说明：Action：动作，add：添加，edit：编辑，delete：删除，OA中只做封存和解封，canceled=1封存，canceled=0解封Code：部门编码，唯一值Shortname：部门简称Fullname：部门全称Org_code：分部编码Parent_code：上级部门编码，没有上级请填写0Order：排序值3）SynJobtitle同步岗位传入xml的格式如下（一定要按照此格式传入）： 00001 测试岗位一 测试岗位一 0001 00002 测试岗位二 测试岗位二 0002 00003 测试岗位三 相关属性说明：Action：动作，add：添加，edit：编辑，delete：删除Jobtitlecode：岗位编码，唯一值Jobtitlename：岗位简称Jobtitleremark：岗位全称Org_code：分部编码Jobtitledept：岗位所属部门编码4）SynHrmResource同步人员传入xml的格式如下（一定要按照此格式传入）： 10001 test test 123456 测试分部一 测试部门一 测试岗位一 正式 1024 男 1988-09-09 12345678 12345678 已婚 10001 test test 123456 测试分部一 测试部门一 测试岗位一 正式 1024 男 1988-09-09 12345678 12345678 已婚 相关属性说明：Action：动作，add：添加，edit：编辑Workcode：人员编码，唯一值Subcompany：分部Department：部门Lastname：姓名Loginid：登录名Password：密码Seclevel：安全级别Sex：性别Jobtitle：岗位Jobactivityid：职务Jobgroupid：职务类别Jobcall：职称Joblevel：职级Jobactivitydesc：职责描述Managerid：直接上级（编码）Assistantid：助理（编码）Status：状态Locationid：办公室Workroom：办公地点Telephone：办公电话Mobile：移动电话Mobilecall：其他电话Fax：传真Email：邮箱Systemlanguage：系统语言Birthday：出生日期Folk：名族Nativeplace：籍贯Regresidentplace：户口Certificatenum：身份证号码Maritalstatus：婚姻状况Policy：政治面貌Bememberdate：入团日期Bepartydate：入党日期Islabouunion：工会会员Educationlevel：学历Degree：学位Healthinfo：健康状况Residentplace：现居住地Homeaddress：家庭联系方式Tempresidentnumber：暂住证号码以上是人员同步的所有节点信息，需要同步那些字段，就填写相应的值。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 _showorder; /* * 公司编码 */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 */ 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.String _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）UserInfoprivate int userid ; /用户id private String subcompanyid1; /分部private String departmentid; /部门private String workcode; /编号private String lastname; /姓名private String loginid; /系统账号private String password; /密码 private String seclevel; /安全级别private String sex; /性别private String jobtitle; /岗位private String jobactivityid; /职务private String jobgroupid; /职务类型 private String jobcall; /职称private String joblevel; /职级private String jobactivitydesc;/职责描述private String managerid; /直接上级private String assistantid; /助理private String status; /状态 eg:正式、试用等 private String locationid; /办公地点private String workroom; /办公室private String telephone; /办公电话private String mobile; /移动电话private String mobilecall; /其他电话private String fax; /传真private String email; /电子邮件private String systemlanguage;/系统语言 默认7private String birthday; /生日private String folk; /名族private String nativeplace; /籍贯private String regresidentplace; /户口private String certificatenum; /身份证号private String maritalstatus; /婚姻状况private String policy; /政治面貌private String bememberdate; /入团日期private String bepartydate; /入党日期private String islabouunion; /是否是工会会员private String educationlevel; /学历private String degree; /学位private String healthinfo; /健康状况private String height; /身高private String weight; /体重private String residentplace; /居住地private String homeaddress; /家庭住址private String tempresidentnumber; /暂住证号码private String startdate = ; /合同开始日期private String enddate = ; /合同结束日期private String createdate=; /创建日期private String lastChangdate=; /最后修改日期private int accounttype; /账号类型private int dsporder; /显示顺序以上是获得用户的基本信息字段2.4 生成客户端大家知道，在本地调用web service,最便利的方法是利用工具生成客户端代理，开发人员通过客户端代理去访问web service将会非常简单，就象调用本地的方法一样。各大主流的编程语言都提供了通过wsdl生成客户端代理的工具,如c#中的wsdl.exe和java中的wsdl2java。本文以java为例说明客户端的生成方法。2.4