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

1、文檔版本歷史變更 序號日期版本文件變更 申請編號變更說明修改人12011年8月26日了無新文件一、前言2編寫目的2名詞定義2二、接口調(diào)用步驟3檢查web service是否已部署 33象WebService接口開發(fā)使用說明2.4生成客戶端7S四MITED居Y17EA VER3.1使用客戶端同步公司信息17K 0)M泛踐軟件有眼公司W(wǎng)avr Softwnr Co.Ltd、前言本文給有研發(fā)能力的客戶或有系統(tǒng)集成需求的客戶提供web service接口調(diào)用的參考例程。本文的面向具有一定web service開發(fā)能力或了解web service技術(shù)的開發(fā)人員。1、Axis :著名的開源web serv

2、ice 引擎。2、外部系統(tǒng)：指調(diào)用或?qū)崿F(xiàn)e-cology輸入輸出接口，與e-cology系統(tǒng)進(jìn)展數(shù)據(jù)交接的其他系統(tǒng)。二、接口調(diào)用步驟2.1檢查web service 是否已部署在瀏覽器中輸入ecologyServer/services,應(yīng)顯示如下頁面:-FirnServict 科3dLGaicrat cd by XFirc (codcliaus. org ；如果未出先上述頁面，如此 web service未部署成功，請與泛微項目人員聯(lián)系。接口部署成功之后，需要在 OA的配置文件中配置調(diào)用接口客戶端的IP,調(diào)用接口時傳入的參數(shù) ip包涵在此配置文件才能調(diào)用以下接口。名稱參數(shù)返回值功能描述SynS

3、ubpanyString ipaddress :調(diào)用接 口的 IP 地址，String xmlData :分部信息的xml成功：1,失敗:0,2:無權(quán)限調(diào)用同步分部信息SynDepartmentString ipaddress :調(diào)用接 口的 IP 地址，String xmlData :部門信息的xml成功：1,失敗:0,2:無權(quán)限調(diào)用同步部門信息SynJobtitleString ipaddress :調(diào)用接 口的 IP 地址，String xmlData :崗位信息的xml成功：1,失敗:0,2:無權(quán)限調(diào)用同步崗位信息SynHrmResourceString ipaddress :調(diào)用接

4、口的 IP 地址，String xmlData :人員信息的xml成功：1,失敗:0,2:無權(quán)限調(diào)用同步人員信息getHrmSubpanyInfoString ipaddress :調(diào)用接 口的IP地址，SubpanyInfo口:分部信息列表獲取所有分部 信息列表getHrmDepartmentInfoString ipaddress :調(diào)用接 口的 IP 地址，String subpanyId :分部 id ,多個 用逗號分隔不為空時該條 件有效DepartmentInf?？诓块T信息列表根據(jù)參數(shù)條件 狀取部門信息 列表getHrmJobTitleInfoString ipaddress :調(diào)

5、用接 口的 IP 地址，String subpanyId :分部 id ,多個 用逗號分隔不為空時該條 件有效String departmentid:部門id ,多個用逗號分隔 不為空時該條件有效JobTitleInfo口：崗位信息列表根據(jù)參數(shù)條件 族取崗位信息 列表getHrmUserInfoString ipaddress :調(diào)用接 口的 IP 地址，String subpanyId :分部 id ,多個 用逗號分隔不為空時該條 件有效String departmentid:部門id ,多個用逗號分隔 不為空時該條件有效String jobtitleid:崗位id ,多個用逗號分隔 不為空

6、時該條件有效StringlastChangeDate最后修改日期，日期格式 “YYYY-MM-DD ”不為空時該條件有效String workcode:人員編碼不為空時該條件 有效UserInfo口：用戶信息列表根據(jù)參數(shù)條件 族取用戶信息 列表checkUserString ipaddress :調(diào)用接 口的IP地址String loginid:登錄名String password:密碼True:表小存在False :表小不存在檢測OA用戶2.3接口相關(guān)對象說明1SynSubpany同步分部傳入xml的格式如下一定要按照此格式傳入：001 測試分部一 測試分部一 00002 測試分部二 測試分

7、部二 010031相關(guān)屬性說明：canceled=1Action :動作，add：添加，edit：編輯，delete：刪除，OA中只做封存和解封,封存,canceled=0解封Code：分部編碼，唯一值Shortname：分部簡稱Fullname :分部全稱Parent_code：上級分部編碼，沒有上級請?zhí)顚?Order ：排序值2SynDepartment同步部門傳入xml的格式如下一定要按照此格式傳入：0001 測試部門一 測試部門一 001000002 nP fl- 測試部門二 0030100031 相關(guān)屬性說明：Action ：動作，add：添加，edit：編輯，delete：刪除，O

8、A中只做封存和解封，canceled=1 封存,canceled=O解封Code：部門編碼，唯一值Shortname：部門簡稱Fullname :部門全稱Org_code:分部編碼Parent_code：上級部門編碼，沒有上級請?zhí)顚?Order ：排序值3SynJobtitle 同步崗位傳入xml的格式如下一定要按照此格式傳入：00001 測試崗位一 硬U試崗位000100002 測試崗位二 硬U試崗位二 000200003 測試崗位三 相關(guān)屬性說明：Action :動作，add：添加，edit：編輯，delete：刪除Jobtitlecode ：崗位編碼，唯一值Jobtitlename :崗

9、位簡稱Jobtitleremark :崗位全稱Org_code:分部編碼Jobtitledept:崗位所屬部門編碼4SynHrmResource同步人員傳入 xml的格式如下一定要按照此格式傳入10001testtest123456 測試分部一 department硬 U試音B 門 測試崗位一 正式 1024 男 1988-09-091234567812345678test163. 已婚 10001testtest123456 測試分部一 硬 U 試音B 門 測試崗位一 正式 1024 男 1988-09-091234567812345678test163. 已婚 相關(guān)屬性說明：Action

10、:動作，add：添加，edit：編輯Workcode ：人員編碼，唯一值Subpany:分部Department:部門Lastname：某某Loginid :登錄名Password ：密碼Seclevel ：安全級別Sex：性別Jobtitle :崗位Jobactivityid :職務(wù)Jobgroupid ：職務(wù)類別Jobcall ：職稱Joblevel:職級Jobactivitydesc:職責(zé)描述Managerid :直接上級編碼Assistantid :助理編碼Status：狀態(tài)Locationid :辦公室Workroom :辦公地點Telephone：辦公Mobile :移動Mobil

11、ecall :其他Fax：Email :Systemlanguage：系統(tǒng)語言Birthday :出生日期Folk:名族Nativeplace :籍貫Regresidentplace ：戶口Certificatenum : 某某Maritalstatus :婚姻狀況Policy :政治面貌Bememberdate ：入團日期Bepartydate:入黨日期Islabouunion :工會會員Educationlevel :學(xué)歷Degree ：學(xué)位Healthinfo :健康狀況Residentplace ：現(xiàn)居住地Homeaddress：家庭聯(lián)系方式Tempresidentnumber：暫住證

12、以上是人員同步的所有節(jié)點信息，需要同步那些字段，就填寫相應(yīng)的值。5SubpanyInfo/*分部id*/private java.lang.String _subpanyid;/*簡稱*/private java.lang.String _shortname;/*全稱*/private java.lang.String _fullname;/*上級分部id*/private java.lang.String _supsubpanyid;/*/private java.lang.String _website;/*顯示順序*/private java.lang.String _showorder

13、;/*公司編碼*/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 _subpanyid;/*上級部門id*/private java.la

14、ng.String _supdepartmentid;/*顯示順序*/private java.lang.String _showorder;/*部門編碼*/private java.lang.String _code;/*是否封存*/private java.lang.String .canceled;7JobTitleInfo/*崗位id*/private java.lang.String _jobtitleid;/*簡稱*/private java.lang.String _shortname;/*全稱*/private java.lang.String _fullname;/*所屬部門

15、id*/private java.lang.String _departmentid;/*崗位職責(zé)*/private java.lang.String Jobresponsibility;/*任職資格*/private java.lang.String _jobpetency;/*相關(guān)文檔*/private java.lang.String _jobdoc;/*備注*/private java.lang.String _j0btitleremark;8UserInfo/用戶idprivateint userid ;privateStringsubpanyidl ;/分部privateStrin

16、gdepartmentid;/部門privateStringworkcode ;/編號privateStringlastname ;/某某privateStringloginid ;/系統(tǒng)賬號privateStringpassword ;/密碼privateStringseclevel ;/安全級別privateStringsex ;/性別privateStringjobtitle;/崗位privateStringjobactivityid;/職務(wù)privateStringjobgroupid ;/職務(wù)類型privateStringjobcall ;/職稱privateStringjoblev

17、el ;/職級privateStringjobactivitydesc;/職責(zé)描述privateStringmanagerid ;/直接上級privateStringassistantid;/助理privateStringstatus ;/狀態(tài)eg:正式、試用等privateStringlocationid;/辦公地點privateStringworkroom ;/辦公室privateStringtelephone ;/辦公privateStringmobile ;/移動privateStringmobilecall;/其他privateStringfax ;/privateStringema

18、il ;/電子privateStringsystemlanguage;/系統(tǒng)語言 默認(rèn)7privateStringbirthday ;/生日privateStringfolk ;/名族privateStringnativeplace;/籍貫privateStringregresidentplace;/ 戶口privateStringcertificatenum;/某某號privateStringmaritalstatus;/婚姻狀況privateStringpolicy ;/政治面貌privateStringbememberdate ;/入團日期privateStringbepartydate

19、 ;/入黨日期privateStringislabouunion;/是否是工會會員privateStringeducationlevel;/學(xué)歷privateStringdegree ;/學(xué)位privateStringhealthinfo;/健康狀況privateStringheight ;/身高privateStringweight ;/體重privateStringresidentplace;/居住地privateStringhomeaddress ;/家庭住址privateStringtempresidentnumber;/暫住證privateStringstartdate=;/合同開始

20、日期privateStringenddate =;/合同完畢日期privateStringcreatedate =;/創(chuàng)建日期privateStringlastChangdate=;/最后修改日期privateint accounttype ;/ 賬號類型privateint dsporder ;/ 顯示順序以上是獲得用戶的根本信息字段2.4生成客戶端大家知道，在本地調(diào)用web service,最便利的方法是利用工具生成客戶端代理，開發(fā)人員通過客戶端代理去訪問web service將會非常簡單，就象調(diào)用本地的方法一樣。各大主流的編程語言都提供了通過 wsdl生成客戶端代理的工具，如c#中的wsdl.exe和java中的wsdl2java 。本文以java為例說明客戶端 的生成方法?？蛻舳怂鑚arjavax-mons-2.4.2生成客戶端使用eclipse向?qū)?Web Service客戶端圜 Web Service Client回MB Web Sfrvig ClientWeb Service Proxy PogeSelect gen