系统接口培训文档全解文档格式.docx
《系统接口培训文档全解文档格式.docx》由会员分享，可在线阅读，更多相关《系统接口培训文档全解文档格式.docx（13页珍藏版）》请在冰豆网上搜索。
具体方法见下面的使用说明。
二.使用说明
1）检查webservice是否已部署
在浏览器中输入http:
//IP/services,应显示如下页面：
如果未出先上述页面，则webservice未部署成功，请与泛微项目人员联系。
接口部署成功之后，需要在系统的的HrmWebserviceIP.properties配置文件中配置调用接口客户端的IP，调用接口时传入的参数ip包涵在此配置文件才能调用以下接口。
2）接口方法概述
名称
参数
返回值
功能描述
SynHrmResource
Stringipaddress：
调用接口的IP地址，StringxmlData：
人员信息的xml
成功:
1,失败:
0,2:
无权限调用
同步人员信息
getHrmUserInfo
调用接口的IP地址，StringsubcompanyId：
分部id，多个用逗号分隔（不为空时该条件有效）
Stringdepartmentid：
部门id，多个用逗号分隔（不为空时该条件有效）
Stringjobtitleid：
岗位id，多个用逗号分隔（不为空时该条件有效）
StringlastChangeDate：
最后修改日期，日期格式“YYYY-MM-DD”（不为空时该条件有效）
Stringworkcode:
人员编码（不为空时该条件有效）
UserInfo[]：
用户信息列表
根据参数条件获取用户信息列表
checkUser
调用接口的IP地址
Stringloginid：
登录名Stringpassword：
密码
True:
表示存在
False：
表示不存在
检测OA用户
3）接口相关对象说明
4）SynHrmResource同步人员传入xml的格式如下（一定要按照此格式传入）：
<
?
xmlversion="
1.0"
encoding="
UTF-8"
>
root>
<
hrmlist>
hrmaction="
add"
workcode>
10001<
/workcode>
loginid>
test<
/loginid>
lastname>
/lastname>
password>
123456<
/password>
subcompany>
测试分部一<
/subcompany>
department>
测试部门一<
/department>
jobtitle>
测试岗位一<
/jobtitle>
statue>
正式<
/statue>
managerid>
1024<
/managerid>
sex>
男<
/sex>
birthday>
1988-09-09<
/birthday>
telephone>
12345678<
/telephone>
mobile>
/mobile>
email>
************<
/email>
maritalstatus>
已婚<
/maritalstatus>
/hrm>
edit"
/hrmlist>
/root>
相关属性说明：
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：
暂住证号码
以上是人员同步的所有节点信息，需要同步那些字段，就填写相应的值。
8）UserInfo
privateintuserid;
//用户id
privateStringsubcompanyid1;
//分部
privateStringdepartmentid;
//部门
privateStringworkcode;
//编号
privateStringlastname;
//姓名
privateStringloginid;
//系统账号
privateStringpassword;
//密码
privateStringseclevel;
//安全级别
privateStringsex;
//性别
privateStringjobtitle;
//岗位
privateStringjobactivityid;
//职务
privateStringjobgroupid;
//职务类型
privateStringjobcall;
//职称
privateStringjoblevel;
//职级
privateStringjobactivitydesc;
//职责描述
privateStringmanagerid;
//直接上级
privateStringassistantid;
//助理
privateStringstatus;
//状态eg:
正式、试用等
privateStringlocationid;
//办公地点
privateStringworkroom;
//办公室
privateStringtelephone;
//办公电话
privateStringmobile;
//移动电话
privateStringmobilecall;
//其他电话
privateStringfax;
//传真
privateStringemail;
//电子邮件
privateStringsystemlanguage;
//系统语言默认7
privateStringbirthday;
//生日
privateStringfolk;
//名族
privateStringnativeplace;
//籍贯
privateStringregresidentplace;
//户口
privateStringcertificatenum;
//身份证号
privateStringmaritalstatus;
//婚姻状况
privateStringpolicy;
//政治面貌
privateStringbememberdate;
//入团日期
privateStringbepartydate;
//入党日期
privateStringislabouunion;
//是否是工会会员
privateStringeducationlevel;
//学历
privateStringdegree;
//学位
privateStringhealthinfo;
//健康状况
privateStringheight;
//身高
privateStringweight;
//体重
privateStringresidentplace;
//居住地
privateStringhomeaddress;
//家庭住址
privateStringtempresidentnumber;
//暂住证号码
privateStringstartdate="
"
;
//合同开始日期
privateStringenddate="
//合同结束日期
privateStringcreatedate="
;
//创建日期
privateStringlastChangdate="
//最后修改日期
privateintaccounttype;
//账号类型
privateintdsporder;
//显示顺序
以上是获得用户的基本信息字段
2.4生成客户端
大家知道，在本地调用webservice,最便利的方法是利用工具生成客户端代理，开发人员通过客户端代理去访问webservice将会非常简单，就象调用本地的方法一样。
各大主流的编程语言都提供了通过wsdl生成客户端代理的工具,如c#中的wsdl.exe和java中的wsdl2java。
本文以java为例说明客户端的生成方法。
2.4.1客户端所需jar
commons-discovery-0.2.jar
javax-wsdl_1.5.1jar
commons-logging_1.0.4.jar
axis.jar
jaxrpc.jar
saaj.jar
activation.jar
mail.jar
2.4.2生成客户端
使用eclipse向导生成WebService客户端
4）示例程序
Ø
使用客户端同步公司信息
publicstaticvoidmain（String[]args）{
try{
Stringorgxml=””;
HrmServiceClientclient=newHrmServiceClient（）;
HrmServicePortTypeservice=client.getHrmServiceHttpPort（）;
service.synSubCompany（"
192.168.4.183"
orgxml）;
}catch（Exceptione）{
e.printStackTrace（）;
}
}
检测用户：
try{
HrmServiceClientclient=newHrmServiceClient（）;
System.out.println（service.checkUser（"
"
test"
1"
））;
}catch（Exceptione）{
e.printStackTrace（）;
}
升级会员 