人力資源(HrmService)WebService接口使用說明.

1、ul人力資源WebService接口開發(fā)使用說明SUBMITEDBYWEAVER眨微件有眼公司W(wǎng)eaverSoftwareCo.Ltd人力資源WebService接口使用說明- -文檔版本歷史變更序號日期版本文件變更申請編號變更說明修改人12011年8月26日V1.0無新文件胡偉武目錄TOC o 1-5 h z一、刖言41.1編寫目的41.2名詞定義4 HYPERLINK l bookmark8 o Current Document 二、接口調(diào)用步驟5 HYPERLINK l bookmark10 o Current Document 2.1檢查webservice是否已部署52.2接口方法概

2、述52.3接口相關(guān)對象說明72.4生成客戶端9三、示例程序19 HYPERLINK l bookmark16 o Current Document 3.1使用客戶端同步公司信息19- -一、前言1.1編寫目的本文給有研發(fā)能力的客戶或有系統(tǒng)集成需求的客戶提供webservice接口調(diào)用的參考例程。本文的面向具有一定webservice開發(fā)能力或了解webservice技術(shù)的開發(fā)人員。1.2名詞定義1、Axis：著名的開源webservice引擎。2、外部系統(tǒng)：指調(diào)用或?qū)崿F(xiàn)e-cology輸入輸出接口，與e-cology系統(tǒng)進(jìn)行數(shù)據(jù)交接的其他系統(tǒng)。人力資源WebService接口使用說明- -二、

3、接口調(diào)用步驟2.1檢查webservice是否已部署在瀏覽器中輸入 HYPERLINK http:/ecologyServer/services%ef%bc%8c%e5%ba%94%e6%98%be%e7%a4%ba%e5%a6%82%e4%b8%8b%e9%a1%b5%e9%9d%a2 http:/ecologyServer/services，應(yīng)顯示如下頁面:LableS2Triz：ec：HrnSerrice用dlCenerateG5丫XFir=(http：/Kzire.codehaus.yrg如果未出先上述頁面，則webservice未部署成功，請與泛微項(xiàng)目人員聯(lián)系。接口部署成功之后，需要

4、在OA的HrmWebservicelP.properties配置文件中配置調(diào)用接口客戶端的IP,調(diào)用接口時(shí)傳入的參數(shù)ip包涵在此配置文件才能調(diào)用以下接口。2.2接口方法概述名稱參數(shù)返回值功能描述SynSubCompanyStringipaddress：調(diào)用接口的IP地址，StringxmlData：分部信息的xml成功：1,失敗：0,2:無權(quán)限調(diào)用同步分部信息SynDepartmentStringipaddress：調(diào)用接口的IP地址，StringxmlData：部門信息的xml成功：1,失敗：0,2:無權(quán)限調(diào)用冋步部門信息SynJobtitleStringipaddress：調(diào)用接口的IP地

5、址，StringxmlData：崗位信息的xml成功：1,失?。?,2:無權(quán)限調(diào)用同步崗位信息SynHrmResourceStringipaddress：調(diào)用接口的IP地址，StringxmlData：人員信息的xml成功：1,失?。?,2:無權(quán)限調(diào)用同步人員信息getHrmSubcompanylnfoStringipaddress：調(diào)用接口的IP地址，SubCompanyInfo:分部信息列表獲取所有分部信息列表getHrmDepartmentlnfoStringipaddress：調(diào)用接口的IP地址，StringsubcompanyId：分部id，多個(gè)用逗號分隔（不為空時(shí)該條件有效）Dep

6、artmentInfo:部門信息列表根據(jù)參數(shù)條件獲取部門信息列表getHrmJobTitleInfoStringipaddress：調(diào)用接口的IP地址，StringsubcompanyId：分部id，多個(gè)用逗號分隔（不為空時(shí)該條件有效）Stringdepartmentid:部門id,多個(gè)用逗號分隔（不為空時(shí)該條件有效）JobTitleInfo:崗位信息列表根據(jù)參數(shù)條件獲取崗位信息列表getHrmUserlnfoStringipaddress：調(diào)用接口的IP地址，StringsubcompanyId：分部id，多個(gè)用逗號分隔（不為空時(shí)該條件有效）Stringdepartmentid:部門id,多

7、個(gè)用逗號分隔（不為空時(shí)該條件有效）Stringjobtitleid:崗位id,多個(gè)用逗號分隔（不為空時(shí)該條件有效）StringlastChangeDate:最后修改日期，日期格式“YYYY-MM-DD”（不為空時(shí)該條件有效）Stringworkcode:人員編碼（不為空時(shí)該條件有效）UserInfo:用戶信息列表根據(jù)參數(shù)條件獲取用戶信息列表checkUserStringipaddress：調(diào)用接口的IP地址Stringloginid:登錄名Stringpassword：密碼True:表示存在False:表示不存在檢測0A用戶人力資源WebService接口使用說明- -2.3接相關(guān)對象說明1）

8、SynSubCompany同步分部傳入xml的格式如下（一定要按照此格式傳入）：v?xmlversion=1.0encoding=UTF-8?vrootvorglistvcode001v/codevshortname測試分部一v/shortnamevfullname測試分部一vparent_codeOv/parent_codevorderOv/ordervcode002v/code測試分部二vfullname測試分部二vparent_codeOv/parent_codevorder1v/orderv/orgvorgaction=deletevcode003v/codevcanceled1v/c

9、anceledv/orgv/orglistv/root相關(guān)屬性說明：Action：動(dòng)作，add:添加,edit:編輯,delete:刪除,OA中只做封存和解封，canceled=1封存，canceled=0解封Code:分部編碼，唯一值Shortname:分部簡稱Fullname:分部全稱Parent_code：上級分部編碼，沒有上級請?zhí)顚?Order:排序值2）SynDepartment同步部門傳入xml的格式如下（一定要按照此格式傳入）:v?xmlversion=1.0encoding=UTF-8?vrootvorglistvorgaction=addvcode0001v/codevsho

10、rtname測試部門一v/shortnamevfullname測試部門一v/fullnamevorg_code001v/org_code- -vparent_codeOv/parent_codevorderOv/ordervcode0002v/codevshortname測試部門二v/shortnamevfullname測試部門二v/fullnamevorg_code003v/org_codevparent_codeOv/parent_codevorderlv/ordervcode0003v/codevcanceled1v/canceled相關(guān)屬性說明：Action：動(dòng)作，add:添加,edi

11、t:編輯,delete:刪除,OA中只做封存和解封，canceled=1封存，canceled=0解封Code:部門編碼，唯一值Shortname:部門簡稱Fullname:部門全稱Org_code：分部編碼Parent_code：上級部門編碼，沒有上級請?zhí)顚?Order:排序值3）Synjobtitle同步崗位傳入xml的格式如下（一定要按照此格式傳入）：v?xmlversion=1.0encoding=UTF-8?vjobtitlelistvjobtitleaction=add00001測試崗位一v/jobtitlenamevjobtitleremark測試崗位一v/jobtitlerem

12、ark000100002測試崗位二v/jobtitlenamevjobtitleremark測試崗位二v/jobtitleremark0002人力資源WebService接口使用說明- -vjobtitlecode00003v/jobtitlecodevjobtitlename測試崗位三相關(guān)屬性說明：Action:動(dòng)作,add:添加,edit:編輯,delete：刪除Jobtitlecode：崗位編碼，唯一值Jobtitlename:崗位簡稱Jobtitleremark:崗位全稱Org_code：分部編碼Jobtitledept:崗位所屬部門編碼4）SynHrmResource同步人員傳入xm

13、l的格式如下（一定要按照此格式傳入）:v?xmlversion=1.0encoding=UTF-8?vhrmlistvhrmaction=addvworkcode10001v/workcodetestvlastnametestv/lastnamevpassword123456v/passwordvsubcompany測試分部一v/subcompanyvdepartment測試部門一v/department測試崗位一v/jobtitle正式vmanagerid1024v/managerid男vbirthday1988-09-09v/birthdayvtelephone12345678v/tele

14、phonevmobile12345678v/mobilevemailv/emailvmaritalstatus已婚10001testvlastnametestv/lastname123456vsubcompany測試分部一v/subcompanyvdepartment測試部門一v/departmentvjobtitle測試崗位一v/jobtitlevstatue正式v/statuevmanagerid1024v/manageridvsex男vbirthday1988-09-09v/birthdayvtelephone12345678v/telephonevmobile12345678v/mob

15、ilevemailv/emailvmaritalstatus已婚v/maritalstatusv/hrmv/hrmlistv/root相關(guān)屬性說明：Action:動(dòng)作,add:添加,edit:編輯Workcode：人員編碼，唯一值Subcompany：分部Department:部門Lastname：姓名Loginid：登錄名Password:密碼Seclevel：安全級別Sex:性別Jobtitle:崗位Jobactivityid:職務(wù)Jobgroupid：職務(wù)類別Jobcal1：職稱Joblevel:職級Jobactivitydesc:職責(zé)描述Managerid：直接上級（編碼）Assist

16、antid:助理（編碼）Status：狀態(tài)Locationid:辦公室Workroom：辦公地點(diǎn)Telephone:辦公電話Mobile:移動(dòng)電話Mobilecall：其他電話Fax：傳真Email：郵箱Systemlanguage：系統(tǒng)語言Birthday:出生日期Folk：名族Nativeplace:籍貫Regresidentplace:戶口Certificatenum：身份證號碼Maritalstatus:婚姻狀況Policy：政治面貌Bememberdate:入團(tuán)日期- -Bepartydate：入黨日期Islabouunion：工會(huì)會(huì)員Educationlevel:學(xué)歷Degree：

17、學(xué)位Healthinfo:健康狀況Residentplace:現(xiàn)居住地Homeaddress:家庭聯(lián)系方式Tempresidentnumber：暫住證號碼以上是人員同步的所有節(jié)點(diǎn)信息，需要同步那些字段，就填寫相應(yīng)的值。SubCompanyinfo/*分部id*/privatejava.lang.String_subcompanyid;/*簡稱*/privatejava.lang.String_shortname;/*全稱*/privatejava.lang.String_fullname;/*上級分部id*/privatejava.lang.String_supsubcompanyid;/*網(wǎng)

18、站*/privatejava.lang.String_website;/*顯示順序*/privatejava.lang.String_showorder;/*公司編碼*/人力資源WebService接口使用說明人力資源WebService接口使用說明- - -privatejavalang.String_code;/*是否封存*/privatejava.lang.String.canceled;Departmentlnfo/*部門id*/privatejava.lang.String_departmentid;/*簡稱*/privatejava.lang.String_shortname;/*

19、全稱*/privatejava.lang.String_fullname;/*所屬分部id*/privatejava.lang.String_subcompanyid;/*上級部門id*/privatejava.lang.String_supdepartmentid;/*顯示順序*/privatejava.lang.String_showorder;/*部門編碼*/privatejava.lang.String_code;/*是否封存*/privatejava.lang.String.canceled;JobTitleInfo/*崗位id*/privatejava.lang.String_jo

20、btitleid;/*簡稱*/privatejava.lang.String_shortname;/*全稱*/privatejava.lang.String_fullname;/*所屬部門id*/privatejava.lang.String_departmentid;/*崗位職責(zé)*/privatejava.lang.String_jobresponsibility;/*任職資格*/privatejava.lang.String_jobcompetency;/*相關(guān)文檔*/privatejava.lang.String_jobdoc;/*備注*/privatejava.lang.String_

21、jobtitleremark;Userinfo人力資源WebService接口使用說明人力資源WebService接口使用說明- - -privateintuserid;/用戶idprivateStringsubcompanyidl;/分部privateStringdepartmentid;/部門privateStringworkcode;/編號privateStringlastname;/姓名privateStringloginid;/系統(tǒng)賬號privateStringpassword;/密碼privateStringseclevel;/安全級別privateStringsex;/性別pri

22、vateStringjobtitle;/崗位privateStringjobactivityid;/職務(wù)privateStringjobgroupid;/職務(wù)類型privateStringjobcall;/職稱privateStringjoblevel;/職級privateStringjobactivitydesc;/職責(zé)描述privateStringmanagerid;/直接上級privateStringassistantid;/助理privateStringstatus;/狀態(tài)eg:正式、試用等privateStringlocationid;/辦公地點(diǎn)privateStringworkro

23、om;/辦公室privateStringtelephone;/辦公電話privateStringmobile;/移動(dòng)電話privateStringmobilecall;/其他電話privateStringfax;/傳真privateStringemail;/電子郵件privateStringsystemlanguage;/系統(tǒng)語言默認(rèn)7privateStringbirthday;/生日privateStringfolk;/名族privateStringnativeplace;/籍貫privateStringregresidentplace;/戶口privateStringcertificate

24、num;/身份證號privateStringmaritalstatus;/婚姻狀況privateStringpolicy;/政治面貌privateStringbememberdate;/入團(tuán)日期privateStringbepartydate;/入黨日期privateStringislabouunion;/是否是工會(huì)會(huì)員privateStringeducationlevel;/學(xué)歷privateStringdegree;/學(xué)位privateStringhealthinfo;/健康狀況privateStringheight;/身高privateStringweight;/體重privateStr

25、ingresidentplace;/居住地privateStringhomeaddress;/家庭住址privateStringtempresidentnumber;/暫住證號碼privateStringstartdateprivateStringenddateprivateStringcreatedate=;privateStringlastChangdate=;privateintaccounttype;privateintdsporder;以上是獲得用戶的基本信息字段/合同開始日期/合同結(jié)束日期/創(chuàng)建日期/最后修改日期/賬號類型/顯示順序2.4生成客戶端大家知道，在本地調(diào)用webserv

26、ice，最便利的方法是利用工具生成客戶端代理，開發(fā)人員通過客戶端代理去訪問webservice將會(huì)非常簡單，就象調(diào)用本地的方法一樣。各大主流的編程語言都提供了通過wsdl生成客戶端代理的工具，如c#中的wsdl.exe和java中的wsdl2java。本文以java為例說明客戶端的生成方法。2.4.1客戶端所需jarcommons-discovery-0.2.jarjavax-wsdl_1.5.1jarcommons-logging_1.0.4.jaraxis.jarjaxrpc.jarsaaj.jaractivation.jarmail.jar2.4.2生成客戶端使用eclipse向?qū)蒞

27、ebService客戶端- -SelectawizardAccessanexistingXMLwuhservi匚u人力資源WebService接口使用說明卜向Wizards:typefiltertestJSPtJSPTag筆Listener磁ServletfStaticWebProjectd凸WebServices豔AntFilesIIIUnitTestUDDI注WebS-ervice昌WebS-erviteClientFinishCancel人力資源WebService接口使用說明 -魚W-ebServiceClientIMHHWebServi匚巳sSelectaservicedefinitionandmovethesliderto-&etthelevelofclientgeneration.Servicedefinition: HYPERLINK http:/l http:/lcaIhost:S-OEO/s-ervice./DocServiceTwsdItBro