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

精品文檔人力資源WebService接口開發(fā)使用說明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編寫目的本文給有研發(fā)能力的客戶或有系統(tǒng)集成需求的客戶提供web service接口調用的參考例程。本文的面向具有一定web service開發(fā)能力或了解web service技術的開發(fā)人員。1.2名詞定義1、Axis：著名的開源web service引擎。2、外部系統(tǒng)：指調用或實現(xiàn)e-cology輸入輸出接口，與e-cology系統(tǒng)進行數(shù)據(jù)交接的其他系統(tǒng)。二、接口調用步驟2.1檢查web service是否已部署在瀏覽器中輸入http:/ecologyServer/services,應顯示如下頁面：如果未出先上述頁面，則web service未部署成功，請與泛微項目人員聯(lián)系。接口部署成功之后，需要在OA的HrmWebserviceIP.properties配置文件中配置調用接口客戶端的IP，調用接口時傳入的參數(shù)ip包涵在此配置文件才能調用以下接口。2.2接口方法概述名稱參數(shù)返回值功能描述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：部門信息列表根據(jù)參數(shù)條件獲取部門信息列表getHrmJobTitleInfoString ipaddress：調用接口的IP地址，String subcompanyId：分部id，多個用逗號分隔（不為空時該條件有效）String departmentid：部門id，多個用逗號分隔（不為空時該條件有效）JobTitleInfo:崗位信息列表根據(jù)參數(shù)條件獲取崗位信息列表getHrmUserInfoString ipaddress：調用接口的IP地址，String subcompanyId：分部id，多個用逗號分隔（不為空時該條件有效）String departmentid：部門id，多個用逗號分隔（不為空時該條件有效）String jobtitleid：崗位id，多個用逗號分隔（不為空時該條件有效）String lastChangeDate：最后修改日期，日期格式“YYYY-MM-DD”（不為空時該條件有效）String workcode:人員編碼（不為空時該條件有效）UserInfo：用戶信息列表根據(jù)參數(shù)條件獲取用戶信息列表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：上級分部編碼，沒有上級請?zhí)顚?Order：排序值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：上級部門編碼，沒有上級請?zhí)顚?Order：排序值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：狀態(tài)Locationid：辦公室Workroom：辦公地點Telephone：辦公電話Mobile：移動電話Mobilecall：其他電話Fax：傳真Email：郵箱Systemlanguage：系統(tǒng)語言Birthday：出生日期Folk：名族Nativeplace：籍貫Regresidentplace：戶口Certificatenum：身份證號碼Maritalstatus：婚姻狀況Policy：政治面貌Bememberdate：入團日期Bepartydate：入黨日期Islabouunion：工會會員Educationlevel：學歷Degree：學位Healthinfo：健康狀況Residentplace：現(xiàn)居住地Homeaddress：家庭聯(lián)系方式Tempresidentnumber：暫住證號碼以上是人員同步的所有節(jié)點信息，需要同步那些字段，就填寫相應的值。5）SubCompanyInfo/* * 分部id */ private java.lang.String _subcompanyid; /* * 簡稱 */ private java.lang.String _shortname; /* * 全稱 */ private java.lang.String _fullname; /* * 上級分部id */ private java.lang.String _supsubcompanyid; /* * 網(wǎng)站 */ 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; /系統(tǒng)賬號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; /狀態(tài) 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;/系統(tǒng)語言 默認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=; /創(chuàng)建日期private String lastChangdate=; /最后修改日期private int accounttype; /賬號類型private int dsporder; /顯示順序以上是獲得用戶的基本信息字段2.4 生成客戶端大家知道，在本地調用web service,最便利的方法是利用工具生成客戶端代理，開發(fā)人員通過客戶端代理去訪問web service將會非常簡單，就象調用本地的方法一樣。各大主流的編程語言都提供了通過wsdl生成客戶端代理的工具,如c#中的wsdl.exe和java中的wsdl2java。本文以java為例說明客戶端的生成方法。2.4