系统接口培训文档全解.docx
《系统接口培训文档全解.docx》由会员分享，可在线阅读，更多相关《系统接口培训文档全解.docx（13页珍藏版）》请在冰豆网上搜索。
系统接口培训文档全解
泛微软件有限公司
中国上海浦东软件园陆家嘴分园
峨山路91弄101号3层
邮政编码：
200127
电话：
+862150942228
传真：
+862150942278
版本
文档简要信息:
文档主题（Title）
人员接口文档
作者（Author）
杨林
审批者（ToBeApprovedBy）
说明（Comments）
文件名称（FileName）
文档版本历史:
序号
日期
版本
变更说明
修改人
注释
1.
2016-10-07
V1.0
杨林
2.
3.
4.
5.
第一部分人力资源webservices接口
一.接口说明
可以通过该接口对系统中的人员组织架构进行操作。
具体方法见下面的使用说明。
二.使用说明
1）检查webservice是否已部署
在浏览器中输入http:
//IP/services,应显示如下页面：
如果未出先上述页面，则webservice未部署成功，请与泛微项目人员联系。
接口部署成功之后，需要在系统的的HrmWebserviceIP.properties配置文件中配置调用接口客户端的IP，调用接口时传入的参数ip包涵在此配置文件才能调用以下接口。
2）接口方法概述
名称
参数
返回值
功能描述
SynHrmResource
Stringipaddress：
调用接口的IP地址，StringxmlData：
人员信息的xml
成功:
1,失败:
0,2:
无权限调用
同步人员信息
getHrmUserInfo
Stringipaddress：
调用接口的IP地址，StringsubcompanyId：
分部id，多个用逗号分隔（不为空时该条件有效）
Stringdepartmentid：
部门id，多个用逗号分隔（不为空时该条件有效）
Stringjobtitleid：
岗位id，多个用逗号分隔（不为空时该条件有效）
StringlastChangeDate：
最后修改日期，日期格式“YYYY-MM-DD”（不为空时该条件有效）
Stringworkcode:
人员编码（不为空时该条件有效）
UserInfo[]：
用户信息列表
根据参数条件获取用户信息列表
checkUser
Stringipaddress：
调用接口的IP地址
Stringloginid：
登录名Stringpassword：
密码
True:
表示存在
False：
表示不存在
检测OA用户
3）接口相关对象说明
4）SynHrmResource同步人员传入xml的格式如下（一定要按照此格式传入）：
xmlversion="1.0"encoding="UTF-8"?
>
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：
暂住证号码
以上是人员同步的所有节点信息，需要同步那些字段，就填写相应的值。
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（）;
}
}
检测用户：
publicstaticvoidmain（String[]args）{
try{
HrmServiceClientclient=newHrmServiceClient（）;
HrmServicePortTypeservice=client.getHrmServiceHttpPort（）;
System.out.println（service.checkUser（"192.168.4.183","test","1"））;
}catch（Exceptione）{
e.printStackTrace（）;
}
}
升级会员 